Batch Processing

Rush is an easy to use tool to run Wrap4D computations over a network. It allows running the computation on dozens of machines with just a few clicks. Rush works in combination with Node which is a headless computational node and performs all the heavy computations.

If you are created a project in Wrap4D on our computer and tell Rush that needs to compute this project over a specific frame range. Rush sends the tasks to Nodes and the Nodes perform the computations.

In this scheme, you can see a simple network configuration.

../_images/NetworkScheme.jpg

User Machine

A computer where Wrap4D has installed. Used to create projects and start computations.

Computational Machines

Computers where Node has installed. You can use as much computers as licenses of nodes you have.

Server Machine

This is a computer where the Rush application has installed and is running. Rush controls the set of computational nodes: it provides them with tasks, starts, stops, and pauses them.

Tip

This scheme is very flexible. For example, you can have the Rush application running on the same machine as Wrap4D. It’s also possible to use this machine as a computational node as well. So basically, all 3 applications may be running on a single computer if needed.

Installation

Rush

When the wizard is finished, the web interface for Rush appears in your browser:

../_images/RushWebInterface.jpg

Here you can find your network address which will connect computational nodes with a server machine.

Node

When the wizard is finished, I will see the tray icon. Lets choose Open web interface inside the context menu of that icon.

Tip

If the tray icon is not displayed, you may run the process inside installation directory of Node using the NodeTray.exe file.

../_images/NodeWebInterface.jpg

Here is you need to paste your network adress which you copied from Rush web interface inside Rush adress field. After that click Save button and check if the green text Rush connection established appears.

Activation

To activate Node you need to use a command-line interface.

Use this command to activate a node-locked license:

WrapCmd activateNodelocked <pathToLicense>

Use this command to activate a floating license:

WrapCmd activateFloating <hostAddress> <port>

Arguments

pathToLicense:

a path to a license file *.lic. If the file name contains spaces please use double quotes.

Tip

Use command cd to switch to the installation folder.

../_images/NodeActivation.jpg

After the activation Node on each computational machine, we can focus only on the User and Server machines.

Rush activates together with Wrap4D.

User Interface

First Run

To run the Rush interface you need to load any project in Wrap4D and go to the 4D Tools menu and select Run the current project in Rush.

../_images/RushRunInterface.jpg

For the first run you need to provide the network address of Rush. You can copy and paste it from the Rush web interface and click the Save button after that.

Tabs

There are 5 main tabs inside Rush. They are displayed as vertical icons on the left side of the application.

Tip

Uncheck Start Immediately to forbid Rush to start selected project immediately.

Projects

../_images/RushTabProjects.jpg

Shows the list of projects which have been already added to Rush. Each project of the list has its own filename, frame range, State, Progress and Time params. You can edit project params using Edit Project icon. In this tab you can also run/start/stop, add and delete any project(s).

Nodes

../_images/RushTabNodes.jpg

Shows the list of nodes which have been already installed using the Rush network address of the current Server. Each node of the list has its own Connection, Status, Tasks, CPU and Memory params. You can edit node params using Edit Node icon. In this tab you can also run/stop/pause and delete any node(s).

Tip

If the Connection param of the selected node is colored in gray, it means that the current node has not started yet. To start it click Start inside the context of the Node icon in the tray menu.

Tip

You can choose the number of tasks for each Computational Machine. It means, that if you will choose 2 tasks on 1 node inside the Edit Node icon, then two frames will compute on this machine in parallel.

Warning

For Wrapping, OpticalFlowWrapping, and FacialWrapping, we would recommend using no more than two instances. A higher number may lead to a drop in performance.

Errors

../_images/RushTabErrors.jpg

Shows the info about errors which have appeared during the computation. For each project you can check the Frame, Message, Node and Time of frames which didn’t succeeded.

Directories

../_images/RushTabDirectories.jpg

Here you can choose the Gallery directory using a network adress.

Tip

Generally, Wrap4D gallery is generally very large. It normally contains several gigabytes of data, so it’s not convenient to have a copy of the gallery on each machine. Instead, you can put the gallery into a shared folder and provide the Node with its address.

Licenses

../_images/RushTabLicenses.jpg

Here you can choose the License Server adress to run floating licenses for our products.