Install Orbit 3DM Publisher - CONNECT Edition
This page describes the installation of “Orbit 3DM Publisher CONNECT Edition”.
Prepare
A well-prepared installation will take no longer than 15 minutes.
Server Requirements
Bentley Product Entitlement
Download 3DM Publisher Installer
-
Install in a directory with full access
e.g. C:\Programs\Bentley\Orbit 3DM Publisher <Version>\
Complete 3DM Publisher Installation Wizards
Close “CONNECTION Client” window without signing in.
Notes
The Bentley License Client is automatically installed with “Orbit 3DM Publisher CONNECT Edition”.
To license the Orbit 3DM Publisher, the Bentley License Client needs to be re-configured from the default “Desktop” to “Server” mode.
It is not possible to run both CONNECT Edition “Desktop” and “Server” mode licensed products simultaneously on one and the same machine.
Set Bentley License Client to Server Mode - Online Activation
Open Command Prompt as Administrator
Go to “cd \Program Files\Common Files\Bentley Shared\CONNECTION Client\LicService”
Run twice “Bentley.Licensing.ActivationWizard.exe /serversetup”
1)
Close “CONNECTION Client” window without signing in.
Wait for the “Bentley Login Client” window to pop-up.
Log in to “Bentley Login Client”
Enter user credentials
Wait for “The Login has completed successfully. You can exit now.”
Close “Bentley Login Client” window
Wait for the “Bentley Activation Wizard” window to pop-up
Proceed with “Bentley Activation Wizard”
Choose “Register Server”
Register this machine for Bentley Server Products
Review Machine Name
Select Country
Do not activate “Allow user outside of Bentley Systems Inc to use server”
Add or Remove Products to Activate
Do not add any product.
Verify display, left lower corner red-colored, “Server Mode: On”
Verify display, left lower corner red-colored, “Server Registered Successfully”
Close dialog “Bentley Activation Wizard”
Close the Command Prompt
Bentley CONNECTION Client - Offline Activation
Install Orbit 3DM Publisher Service
Stop and Remove Old Instance
Only one instance of Orbit 3DM Publisher Service can run using the default configurations.
Stop and uninstall previously installed Orbit 3DM Publisher Service. The Service must be un-installed, but keep the previous version <Install Dir> as backup or to roll back when needed.
Stop “Orbit 3DM Publisher Service”
<Install Dir>/program/bin/ServiceStop.bat (Run as administrator)
Remove “Orbit 3DM Publisher Service”
<Install Dir>/program/bin/ServiceRemove.bat (Run as administrator)
Verify Windows Services, “Bentley Orbit 3DM Publisher Service” to be removed.
Install and Start New Instance
Install “Orbit 3DM Publisher Service”
<Install Dir>/program/bin/ServiceInstall.bat (Run as administrator)
Start “Orbit 3DM Publisher Service”
<Install Dir>/program/bin/ServiceStart.bat (Run as administrator)
Verify Windows Services, status of “Bentley Orbit 3DM Publisher Service” to be “Running”
Verify Orbit 3DM Publisher Product Entitlement
-
Navigate to System > Connect License > Green, Validated
Copy Private Customizations
Copy private customization if applicable from the previous installation (required at every installation).
These customizations are added manually and do not come with a default installation. Private customization must be manually copied from <Previous Install Dir> into the new <Install Dir> if used.
Stop “Orbit 3DM Publisher Service”
Copy custom files and configurations
Cloud Storage configuration.
Copy files: ./program/config/<cloud-storage-provider>.store.*.ini
Java Install options, Proxy configuration
Copy configuration: ./program/bin/ServiceInstall.bat
set JAVA_OPTIONS=-Dhttps.proxyHost=xxx;-Dhttps.proxyPort=xxx;-Dhttps.proxyUser=xxx;-Dhttps.proxyPassword=xxx
Edits to the ServiceInstall.bat requires the the “Orbit 3DM Publisher Service” to be removed and re-installed!
Portforwarding insecure 80 to secure 443
Copy folder: ./program/services/http80
Private published files
Copy private files and folders: ./program/wwwwroot
Start “Orbit 3DM Publisher Service”
Migrate Service Data
One-time migration of Orbit 3DM Publisher Service Data when updating from version 22.10 or older to version 23.1 or higher.
From version 23.1, Publisher Setups are sharing the Service Data folder from the Parent Install Dir.
Stop “Orbit 3DM Publisher Service”
Copy files/folders from the previous installation directory and paste replacing existing files into “Orbit 3DM Publisher Service Data” folder. The Service Data folder is new from version 23.1 and created at the first start of the“Orbit 3DM Publisher Service” in the parent directory of the Publisher installation folder.
Copy files: <Previous Install Dir>/server/program/services/http/keystore.*
Copy folder: <Previous Install Dir>/server/program/services/publisher_3dm
Copy folder: <Previous Install Dir>/server/program/services/wfs (only if WFS configurations have been used)
Copy folder: <Previous Install Dir>/server/program/services/wms (only if WMS configurations have been added)
Copy file: <Previous Install Dir>/server/program/system/connections.xml
Paste replacing existing files into <Install Dir>/../Orbit 3DM Publisher Service Data/
Review HTTP service configuration
Start “Orbit 3DM Publisher Service”