====== Orbit Server Update 19.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 [[197:technology:platforms:install_server|]].

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.

<note tip>  
  - Prepare the update.
  - Respect the procedure as documented below.
  - Take your time and work meticulously.
</note>

===== Preparations =====

=== Plan for assistance ===

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

=== Communicate to coworkers ===

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.

=== Request Activation Key ===

Verify the validity of your Activation Key, contact Orbit Sales. \\
More information about our Online License Activation, see  [[197:technology:core:online_license_activation|]].

=== Download Update Package ===

Download the update package according your product and current product version from the Orbit GT ftp account. \\
Verify your current version via Orbit Desktop > [[197:desktop:workspace:main_toolbar|Main Toolbar]] > Help > About > Details

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

=== Create Full Backup ===

  * 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''

===== Steps to Update from 18.x or 19.x to latest version =====

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 [[1814:server:install:server_update|]]. 

=== Stop Orbit Service ===

  - Close all Orbit Desktop Clients
  - Stop the [[197:server:eos:service|Orbit Service]]. \\ ''<install_folder>/server/program/bin64/ServiceStop.bat''
  - Verify the Operating System Services and the current status of the "Orbit Enterprise Service".

=== Update Orbit Client ===

  - Delete following folders : 
    * ''<install_folder>/client/program/config/''
    * ''<install_folder>/client/program/jre64/''
    * ''<install_folder>/client/program/software/''
    * ''<install_folder>/client/program/users/''
  - Merge folders and Replace existing files :
    * Copy folder ''/<update_package>/client/program/''
    * Paste into ''/<install_folder>/client/'' 

=== Update Orbit Server ===

  - Delete following folders :
    * ''<install_folder>/server/program/jr64/''
    * ''<install_folder>/server/program/log/''
    * ''<install_folder>/server/program/software/''
    * ''<install_folder>/server/program/users/''
  - Merge folders and Replace existing files :
    * Copy folder ''<update_package>/server/program/''
    * Paste into ''<install_folder>/server/''
  - Rename the license configuration file 
    * Rename file : ''<install_folder>/server/program/system/licenses_vXX.X.ini''
    * Into : ''<install_folder>/server/program/system/licenses_v19.[X].ini'' ([x] = version subnumber e.g. ''licenses_v19.7.ini'' for 2019 July release.)
  - Link Admin User Publisher Console to Admin User EOS Console
    * Edit file : ''<install_folder>/server/program/services/publisher_3dm/service.ini'' \\ Enter the credentials of an EOS Administrator : <code>Parameter=EOSUsername:<EOS Administrator Login>
Parameter=EOSPassword:<EOS Administrator Password> </code>
  
=== Add shortcut for Orbit 3DM Publisher Console ===

  - Copy shortcut ''/<update_package>/Orbit 3DM Publisher Console'' 
  - Paste into ''/<install_folder>/'' 

=== Start Orbit Service ===

  - Start the Orbit Service. \\ ''<install_folder>/server/program/bin64/ServiceStart.bat''
  - Verify the Operating System Services and the current status of the "Orbit Enterprise Service".

=== Verify Product Activation ===

  - Launch the EOS Console. \\ Make sure you logon to the updated EOS Console, check its version displayed on top the logon panel.
  - Verify the License status of all listed products, see [[197:server:console:license|EOS Console > License]]. \\ If the product activation failed, see [[180:technology:core:online_license_activation|]].

=== Update Publication ===

For 3DM Publisher, Flash Publications only
  - Re-publish each Publication to update the version of the Publication to the new version, see [[197:server:console:publisher|]].