Agisoft Metashape Professional 2.2.0 Cluster Configuration
Digital Twins
Drones
Geospatial Industry
3D Modeling
Computer Vision
Photogrammetry
This
step-by-step guide will help you set up and run Agisoft Metashape in a
clustered network processing environment using Nebula Cloud's virtual
infrastructure.
✅ 1. Launch Metashape
Workbench
- Log
in to your Nebula Cloud account.
- Launch
the Agisoft Metashape Workbench.
🖥️ 2. Configure the Workbench
- Select
the appropriate Operating System (Windows 10/ Windows Server/Linux).
- Choose
configuration options based on your performance and usage requirements.
🌍 3. Select Cloud
Infrastructure
Choose
your:
- Cloud
Service Provider (CSP)
- Data
Center Region
- CPU/GPU
configuration
- Storage
type (SSD, HDD)
🧩 4. Configure Cluster Nodes
Select
the desired number of virtual machine instances (nodes).
Allocate:
- System
Disk (SSD)
for processing and network sharing.
- Data
Disk (HDD)
for long-term archival and backups.
Recommendation: Use C
Drive (SSD) for active processing and sharing. Use D Drive (HDD)
only for backups.
🛒 5. Finalize and Launch
Instances
- Once
configurations are reviewed, place the order.
- The
system will automatically generate and deploy your virtual machines.
🧠 6. Define Node Roles
Designate:
- One
VM as the Master Node (SERVER + optional CLIENT/WORKER)
- Remaining
VMs as Worker Nodes (CLIENTs)
- Ensure
a logical sequence and verify network visibility across all nodes.
🗂️ 7. Set Up Shared Folder on
Master Node
On
the Master Node, create a shared folder containing your imagery.
- Ensure
it's accessible to all worker nodes over the network.
🔐 8. Configure Permissions
Assign
read/write privileges to relevant users:
- Administrator
- Everyone
- Or
specific user groups as needed.
🔍 9. Verify Network and Port
Access
Run
the provided PowerShell script to:
- Check
for open ports (e.g., 5840)
- Enable
necessary firewall and file-sharing settings
🚀 10. Start Metashape Server
(on Master Node)
Run
the following in CMD/PowerShell:
- metashape-server.exe
--server --host <MASTER_IP> --resume-workers
This
launches the Metashape server which orchestrates the distribution of
tasks.
⚙️ 11. Start Local Worker on
Master Node (Optional)
To
use the Master Node for processing:
metashape.exe
--worker -platform offscreen --host <MASTER_IP> --root \\MASTER\SHARED
- Use
-platform offscreen for non-GUI environments.
⚙️ 12. Start Remote Workers
Run
the same command on all remote nodes:
metashape.exe
--worker -platform offscreen --host <MASTER_IP> --root \\MASTER\SHARED
🖥️ 13. Launch Network Monitor
Run:
monitor.exe
This
tool helps track connected workers and job progress in real time.
✅ 14. Verify Worker
Connections
All
connected workers will appear in the bottom panel of Network Monitor.
If
any are missing, check firewall and folder sharing settings.
⚙️ 15. Configure Network
Settings in GUI
In Metashape GUI, go to:
Tools > Preferences > Network
Set:
- Server IP (Master)
- Port (default: 5840)
- Root path: \\MASTER\SHARED
- Enable Network Processing
🔗 16. Confirm GUI Connection
A “Connected” icon should appear in the bottom-right of
the Metashape GUI.
📁 17. Create and Save a
Project
Create a new project.
Save it in .psx format to the shared folder for access by
all nodes.
🧰 18. Open Batch Processing
Navigate to:
Workflow > Batch Process
- Define your photogrammetry pipeline:
- Align Photos
- Build Dense Cloud
- Build Mesh
Texture, etc.
📡 19. Confirm Network
Processing
When prompted: “Do you want to use network processing?”
Click OK to distribute the job.
📊 20. Monitor Job Progress
A
task monitor will appear showing:
- Job
stages
- Assigned
workers
- Progress
percentages
📈 21. Observe Task
Distribution
Open
Network Monitor to view:
- Task
assignments
- Worker
utilization in real time
📂 22. Verify Output
After
completion, check the .psx file and output data (point clouds, meshes, etc.) in
the shared folder.
✅ 23. Wrap Up and Disconnect
- You
may now disconnect the GUI.
- Workers
will return to idle and wait for new jobs from the server.