Orbit Server Update 20.X

This page describes the update of an Orbit 3DM Publisher and Orbit 3DM Feature Extraction Client/Server.
Documentation on the installation of a Server, see Orbit Server Installation.

The update of an Orbit Server is recommended to be done in cooperation with the Orbit Support.
Updates are free of charge when having a valid software maintenance contract. Contact Orbit Sales for more information.

Plan your update in consultation with Orbit Support to ensure their availability if required.

While you're updating, nobody will be able to use the Orbit WebClient and nobody may use the Orbit Desktop Client.
A well-prepared update will take no longer than 15 minutes.

Verify the validity of your Activation Key, contact Orbit Sales.
More information about our Online License Activation, see Orbit Online License Activation.

Download the update package according your product and current product version from the Orbit GT ftp account.
Verify your current version via Orbit Desktop > Main Toolbar > Help > About > Details

• Ftp : ftp://ftp.orbitgt.com
• Login: OrbitSetups
• Password : OrbitGT!
• Update package : download corresponding update package

• Backup both Client and Server program folders :
  • <install_folder>/client/program/*
  • <install_folder>/server/program/*
• Backup the downloaded Update Package.

If assistance is requested Orbit Support will request access to this backup. We do advise to create a proper backup folder :

• <backup_folder>/<backup_date>/setup/client/program/*
• <backup_folder>/<backup_date>/setup/server/program/*
• <backup_folder>/<backup_date>/update_package/<update_package>.zip

Hereby the procedure to update the Orbit Server Setup from version 20.X to the latest released version
The procedures to install the previous update is available, see Orbit Publisher and Client/Server Update v.18.

1. Close all Orbit Desktop Clients.
2. Verify User Account “Orbit Enterprise Service”.
   Check the service credentials at the “Log On” panel of the Operating System Service “Properties” window. At the end of this update procedure it will be required to change the credentials back to the current configuration!
3. Stop the Orbit Service.
   • Run batch : <install_folder>/server/program/bin64/ServiceStop.bat.
4. Verify the Operating System Services and the current status of “Orbit Enterprise Service”.

1. Delete following folders :
   • <install_folder>/client/program/software/
   • <install_folder>/client/program/users/
2. Merge folders and Replace existing files :
   • Copy folder /<update_package>/client/program/
   • Paste into /<install_folder>/client/

1. Delete following folders :
   • <install_folder>/server/program/log/
   • <install_folder>/server/program/software/
   • <install_folder>/server/program/users/
   • <install_folder>/server/program/wwwroot/viewer/
2. Merge folders and Replace existing files :
   • Copy folder <update_package>/server/program/
   • Paste into <install_folder>/server/
3. Rename the license configuration file
   • Rename file : <install_folder>/server/program/system/licenses_vXX.X.ini
   • Into : <install_folder>/server/program/system/licenses_v20.[X].ini (e.g. filename licenses_v20.3.ini for version 20.3)

1. Start the Orbit Service.
   • Run batch : <install_folder>/server/program/bin64/ServiceStart.bat.
2. Verify the Operating System Services and the current status “Running” of the “Orbit Enterprise Service”.

Hereby the procedure to update the Orbit Server Setup from version 18.x or 19.x to the latest released version
The procedures to install the previous update is available, see Orbit Publisher and Client/Server Update v.18.

1. Close all Orbit Desktop Clients.
2. Verify User Account “Orbit Enterprise Service”.
   Check the service credentials at the “Log On” panel of the Operating System Service “Properties” window. At the end of this update procedure it will be required to change the credentials back to the current configuration!
3. Stop the Orbit Service.
   • Run batch : <install_folder>/server/program/bin64/ServiceStop.bat.
4. Remove the Orbit Enterprise Service.
   • Run batch : <install_folder>/server/program/bin64/ServiceRemove.bat.
5. Verify the Operating System Services and the absence of “Orbit Enterprise Service”.

1. Delete following folders :
   • <install_folder>/client/program/bin64/
   • <install_folder>/client/program/config/
   • <install_folder>/client/program/jre64/
   • <install_folder>/client/program/software/
   • <install_folder>/client/program/users/
2. Merge folders and Replace existing files :
   • Copy folder /<update_package>/client/program/
   • Paste into /<install_folder>/client/

1. Delete following folders :
   • <install_folder>/server/program/bin64/
   • <install_folder>/server/program/jr64/
   • <install_folder>/server/program/log/
   • <install_folder>/server/program/software/
   • <install_folder>/server/program/users/
   • <install_folder>/server/program/wwwroot/viewer/
2. Merge folders and Replace existing files :
   • Copy folder <update_package>/server/program/
   • Paste into <install_folder>/server/
3. Rename the license configuration file
   • Rename file : <install_folder>/server/program/system/licenses_vXX.X.ini
   • Into : <install_folder>/server/program/system/licenses_v20.[X].ini (e.g. filename licenses_v20.3.ini for version 20.3)
4. Link Admin User of Publisher Console to Admin User of EOS Console.
   • Edit file : <install_folder>/server/program/services/publisher_3dm/service.ini
   • Enter the credentials of an EOS Administrator :
     

     Parameter=EOSUsername:<EOS Administrator Login>
     Parameter=EOSPassword:<EOS Administrator Password> 

5. Copy shortcut new Publisher Console
   • Copy file /<update_package>/Orbit 3DM Publisher Console
   • Paste into /<install_folder>/

1. Set Java Memory for Orbit Enterprise Service
   • Edit file :<install_folder>/server/program/bin64/ServiceInstall.bat
   • Copy the values for JAVA_MIN_MEMORY_MB and JAVA_MAX_MEMORY_MB from your back-up :
     

     set JAVA_MIN_MEMORY_MB=<value> 
     set JAVA_MAX_MEMORY_MB=<value> 

2. Install the Orbit Service.
   • Run batch : <install_folder>/server/program/bin64/ServiceInstall.bat.
3. Verify the Operating System Services and the presence of “Orbit Enterprise Service”.
4. Set User Account “Orbit Enterprise Service”
   Change the service credentials at the “Log On” panel of the Operating System Service “Properties” window to be exactly the same as before update!
   • Run batch : <install_folder>/server/program/bin64/ServiceStart.bat.
5. Verify the Operating System Services and the current status “Running” of the “Orbit Enterprise Service”.

1. Launch the EOS Console.
   Make sure you logon to the updated EOS Console, check its version displayed on top the logon panel.
2. Verify the License status of all listed products, see EOS Console > License.
   If the product activation failed, see Orbit Online License Activation.
3. Add “Orbit Core” extension to the “admin” workspace
   
   • Go to the “EOS Console” > “Workspaces”.
   • Select the “admin” workspace and toggle the extensions 'Orbit Core' on.

For 3DM Publisher, Flash Publications only

1. Re-publish each Publication to update the version of the Publication to the new version, see EOS Console > Publishers.