====== Orbit Server Update 17.0 ======

This page describes the update of an Orbit Server. \\
Documentation on the installation of an Orbit Server, see [[170:server:install:server|]].

The update of an Orbit Server is always 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 exactly 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 ===

Request your Activation Key or verify the validity of your Activation Key, contact Orbit Sales. \\
Since version 11.2, runtime online license validation is applicable, see  [[180:technology:core:online_license_activation|]].

=== Download Update Package ===

Download the update package according your Product and current Version from the Orbit Ftp. \\
Make sure you download the right update package. \\
Verify your current version via Orbit Desktop > [[170:desktop:workspace:main_toolbar|Main Toolbar]] > Help > About > Details

  * Ftp : ftp://ftp.orbitgt.com
  * Login: ''OrbitSetups''
  * Password : ''OrbitGT!''
  * Update package : 
    * ''orbit_mm_feature_extraction_update_[from version]_[to version]_[operating system]_[date].zip''
    * ''orbit_mm_publisher_update_[from version]_[to version]_[operating system]_[date].zip''
    * ''orbit_oblique_publisher_update_[from version]_[to version]_[operating system]_[date].zip''

=== 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 ask access to the full back. We do advise to create a proper backup folder :
  * ''<backup_folder>/<backup_date>/installation/client/program/*''
  * ''<backup_folder>/<backup_date>/installation/server/program/*''
  * ''<backup_folder>/<backup_date>/update_package/<update_package>.zip''
===== Steps to Update from 11.2 to 17.0 =====

Following the procedure to update Orbit Server from Orbit 11.2 to the current version 17.0. \\

=== Stop Orbit Service ===

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

=== Update Orbit Client ===

  - Delete following folders : 
    * ''<install_folder>/client/program/bin64/''
    * ''<install_folder>/client/program/config/''
    * ''<install_folder>/client/program/doc/''
    * ''<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 directories :
    * ''<install_folder>/server/program/jre64/''
    * ''<install_folder>/server/program/log/''
    * ''<install_folder>/server/program/services/publisher/logs/'' (Publishers only)
    * ''<install_folder>/server/program/software/''
    * ''<install_folder>/server/program/users/''
    * ''<install_folder>/server/program/wwwroot/api/''
  - Merge folders and Replace existing files :
    * Copy folder ''<update_package>/server/program/'' 
    * Paste into ''<install_folder>/server/'' 

=== Start Orbit Service ===

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

=== Activate Product ===

  - Launch the EOS Console. \\ Make sure you logon to the updated EOS Console, check its version (17.0.1) displayed on top the logon panel.
  - Activate the Updated Product. \\ [[170:server:console:license|EOS Console > License]]. \\ If product activation fails, see [[180:technology:core:online_license_activation|]].

=== Update Publications ===

  - Publish each Publication to update the Publication Version. \\ [[170:server:console:publisher|]]

===== Steps to Patch from 17.0.X to 17.0.Y =====

  - Stop Orbit Service
  - Replace folder ''../client/program/software/''
  - Replace folder ''../server/program/software/''
  - Replace folder ''../server/program/wwwroot/api/''
  - Replace folder ''../server/program/wwwroot/eosconsole/''
  - Start Orbit Service