Let's have the following assumption:

    PC1 - computer used to run the network processing from GUI only, has IP (let's call it CLIENT)

    NODE1 - computer that will be used as a processing node for the distributed computations, has IP (let's call it NODE)

 /mnt/FOLDER/ - a shared folder, to easy the procedure we  recommend to use the same network name for it on all the computers  involved in the network processing. (let's call it STORAGE)

    SERVER1 - computer that will be used as a server for the network  processing - doesn't perform any processing tasks and is only  controlling the jobs and distributes the tasks, so shouldn't be powerful  computer and also doesn't require Metashape license. In principle, you  can run server instance of Metashape Professional on the same computer where node  is started, however, it may affect the stability of the server. The IP  address is 333.333.333.333 (let's call it SERVER)


So the procedure should be the following:

1. run Metashape Professional in the network in server node. To do that on SERVER execute the following command:

./metashape.sh --server --control 333.333.333.333 --dispatch 333.333.333.333


2. run Metashape Professional in node mode on all the computers that would be performing the jobs, in our case it is NODE:

./metashape.sh --node --dispatch 333.333.333.333 --root /mnt/FOLDER/

So here you can see, that we are using IP address of the SERVER. Also we recommend to use --root  argument and on all the nodes specify the path to the same network  folder (STORAGE). It shouldn't be the exact location of the project  file, just some up-dir where all the projects are stored.

In case the machine where the processing node is started doesn't have a graphical interface, use additional "-platform offscreen" command line parameter:

./metashape.sh --node -platform offscreen --dispatch 333.333.333.333 --root /mnt/FOLDER/


3. Here you can run Agisoft Network Monitor (./monitor.sh), connect to  the SERVER by it's IP: 333.333.333.333 leaving the default port 5840 for  communication and see that the nodes are connected - they will be  displayed in the bottom frame of the Monitor window.


4. Run Metashape Professional on the CLIENT in GUI mode, create new project and save it in PSX format somewhere on STORAGE.

5. On the CLIENT machine open Tools Menu -> Preferences -> Network tab and specify the following:

 Check on Enable network processing feature.

 For the Host name field specify SERVER IP address: 333.333.333.333

 Use default port number for communication: 5840

 In the Root field specify the path to the STORAGE - it should be  pointing to the same folder that is mounted as /mnt/FOLDER/ on the NODE.

 Enable Fine Level Task Distribution for all the tasks. Note that for  unchecked tasks and non-specified tasks the processing will be performed  on the single node, irrespective to the number of available idling  nodes.

 Click OK to apply the changes

 After that in the bottom-right corner of the GUI window on CLIENT you will see "connected to server" icon.


6. Again using CLIENT's GUI open the Batch Processing, define the  processing stages and parameters and click OK to run. You'll be asked,  if you want to run the processing via network, click OK and the small  network processing progress dialog will appear. After that you can press  Disconnect on the CLIENT's side and close GUI, since the processing is  being on the NODE now - you can confirm it via Network Monitor and also  reading the logs in the terminal both on SERVER and NODE sides.



here are the commands of starting the nodes from different OS (server can be started in similar way):


./metashape.sh --node --dispatch 333.333.333.333 --root /mnt/FOLDER/


metashape.exe --node --dispatch 333.333.333.333 --root //Storage/FOLDER/


MetashapePro.app/Contents/MacOS/MetashapePro --node --dispatch 333.333.333.333 --root /Volumes/FOLDER/