Knowledge Base
Recent Changes

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
dev:technology:platforms:install_publisher_connect [2023/04/25 15:02]
jeroen [Copy Orbit 3DM Publisher Setup Configurations] 		dev:technology:platforms:install_publisher_connect [2024/03/22 13:46] (current)
glen [Copy Private Customizations]
Line 1: Line 1:
-====== Install Orbit 3DM Publisher - CONNECT Edition ======+====== Install Orbit 3DM Publisher ======
  
 This page describes the installation of "Orbit 3DM Publisher CONNECT Edition".  This page describes the installation of "Orbit 3DM Publisher CONNECT Edition". 
Line 18: Line 18:
  
 ===== Download 3DM Publisher Installer ===== ===== Download 3DM Publisher Installer =====
 +
 +==== Bentley CONNECT Installer ====
  
   - Download from Software Downloads \\ [[https://softwaredownloads.bentley.com/|]] > Brand: Orbit > Product: Orbit 3DM Publisher   - Download from Software Downloads \\ [[https://softwaredownloads.bentley.com/|]] > Brand: Orbit > Product: Orbit 3DM Publisher
Line 24: Line 26:
   - Close "CONNECTION Client" window without signing in.   - Close "CONNECTION Client" window without signing in.
  
-===== Configure Bentley License Client - Server Mode =====+==== Legacy Orbit Installation Setup ==== 
 + 
 +Download the installation package according to the purchased product. \\ 
 + 
 +  * ftp://ftp.orbitgt.com 
 +  * Login: ''OrbitSetups'' 
 +  * Password : ''OrbitGT!'' 
 + 
 +Request your Activation Key to validate your updated Product, contact Sales at Orbit GT. \\ 
 +Read the updated license system, online connectivity is required : [[dev:technology:core:online_license_activation|]]. 
 + 
 +Legacy Orbit Publisher is available for Windows and Linux. \\ 
 +Read more, [[2310:technology:platforms:index|]]. 
 + 
 + 
 +===== Configure Bentley License Client ===== 
 + 
 +Only required for Bentley CONNECT installation.
  
 === Notes === === Notes ===
Line 67: Line 86:
  
 Only one instance of Orbit 3DM Publisher Service can run using the default configurations. \\ Only one instance of Orbit 3DM Publisher Service can run using the default configurations. \\
-Stop and uninstall previously installed Orbit 3DM Publisher Service if applicable. +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)   - Stop "Orbit 3DM Publisher Service" \\ <Install Dir>/program/bin/ServiceStop.bat (Run as administrator)
Line 82: Line 101:
     - Navigate to System > Connect License > Green, Validated      - Navigate to System > Connect License > Green, Validated 
  
-===== Copy Orbit 3DM Publisher Setup Configurations =====+===== Migrate Service Data =====
  
-Copy customization from the previous installation (required at every installation).+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”   - Stop “Orbit 3DM Publisher Service”
-  - Copy custom files and configurations +  - 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.
-    * Cloud Storage configuration. \\ Copy files: program/config/<cloud-storage-provider>.store.*.ini +
-    * Service install configurations \\ Review Https proxy configuration in program/bin/ServiceInstall.bat \\ ''set JAVA_OPTIONS=-Dhttps.proxyHost=xxx;-Dhttps.proxyPort=xxx;-Dhttps.proxyUser=xxx;-Dhttps.proxyPassword=xxx'' +
-    * Private published files \\ Copy files and folders \\ ./program/wwwwroot +
-  - Start “Orbit 3DM Publisher Service” +
-===== Migrate Orbit 3DM Publisher 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.  +
- +
-  - Stop “Orbit 3DM Publisher Service” +
-  - Copy files/folders from the previous installation directory and paste replacing existing files into "Orbit 3DM Publisher Service Data".+
     * Copy files: <Previous Install Dir>/server/program/services/http/keystore.*     * Copy files: <Previous Install Dir>/server/program/services/http/keystore.*
-    * Copy folder: <Previous Install Dir>/server/program/services/http80, if available 
     * Copy folder: <Previous Install Dir>/server/program/services/publisher_3dm     * Copy folder: <Previous Install Dir>/server/program/services/publisher_3dm
-    * Copy folder: <Previous Install Dir>/server/program/services/wfs (Optionally if WFS configurations added) +    * 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 (Optionally if WMS configurations added)+    * 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     * Copy file: <Previous Install Dir>/server/program/system/connections.xml
-    * Paste replacing existing files into <Install Dir>/../Orbit 3DM PUblisher Service Data/+    * Paste replacing existing files into <Install Dir>/../Orbit 3DM Publisher Service Data/ 
 +  - Review HTTP service configuration 
 +    * Edit file: <Install Dir>/../Orbit 3DM Publisher Service Data/http/configuration.ini (port, secure)
   - Start "Orbit 3DM Publisher Service"   - Start "Orbit 3DM Publisher Service"
 +
 +===== Copy Private Customizations =====
 +
 +Copy private customization if applicable from the previous installation (required at every installation or update). \\
 +These customizations do not come with a default installation. Private customization are added manually and need to be manually copied from <Previous Install Dir> into the new <Install Dir> if in use.
 +
 +  - Stop “Orbit 3DM Publisher Service”
 +  - Copy custom files and configurations
 +    * 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!
 +    * Cloud Storage configuration. \\ Copy files: ./program/config/<cloud-storage-provider>.store.*.ini
 +    * Portforwarding insecure 80 to secure 443 \\ Copy folder: ./program/services/http80
 +    * Private published files \\ Copy private files and folders: ./program/wwwwroot
 +    * Copy Bentley IMS callback file \\ ./program/wwwroot/viewer/assets/oauth-flow-callback.html
 +  - Start “Orbit 3DM Publisher Service”
 +
 +
 
Last modified:: 2023/04/25 15:02