====== Orbit Publisher and Client/Server Update v.19.1 ======

This page describes the update of an Orbit Publisher and Client/Server FE. \\
Documentation on the installation of a Server (for Publisher or for Client/Server FE), see [[192:technology:platforms:install_server|]].
Documentation on the installation of a Client (for Publisher or for Client/Server FE), see [[192:technology:platforms:install_client|]].

The update of an Orbit Server Setup 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 first.
  * 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  [[192: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 > [[192: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 to 19.1 =====

Hereby the procedure to update the Orbit Server Setup from version 18.x to the current version 19.1. \\
The procedures to install the previous update is available [[1814:server:install:server_update|here]]. 

=== Stop Orbit Service ===

  - Close all Orbit Desktop Clients
  - Stop the [[192: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/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/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_v18.X.ini''
    * Into : ''<install_folder>/server/program/system/licenses_v19.1.ini''

=== 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 (19.1) displayed on top the logon panel.
  - Verify the License status of all listed products, see [[192:server:console:license|EOS Console > License]]. \\ If the product activation failed, see [[180:technology:core:online_license_activation|]].

=== Update Publication ===

For 3DM Publisher only

  - Re-publish each Publication to update the version of the Publication to the new version. \\ [[192:server:console:publisher|]]