====== Orbit Server Update 17.1 ======

This page describes the update of an Orbit Server Setup. \\
Documentation on the installation of an Orbit Server, see [[180:technology:platforms: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 GT ftp account. \\
Make sure you download the right update package. \\
Verify your current version via Orbit Desktop > [[171:desktop:workspace:main_toolbar|Main Toolbar]] > Help > About > Details

  * Ftp : ftp://ftp.orbitgt.com
  * Login: ''OrbitSetups''
  * Password : ''OrbitGT!''
  * Update package : ''<orbit_product_name>_update_170X_1711_[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 17.0 to 17.1 =====

Hereby the procedure to update the Orbit Server Setup from version 17.0 to the current version 17.1. \\
The procedures to install the previous update is available [[170:server:install:server_update|here]]. 

=== Stop Orbit Service ===

  - Close all Orbit Desktop Clients
  - Stop the [[171: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/jre64/'' (on Windows only)
    * ''<install_folder>/client/program/software/''
    * ''<install_folder>/client/program/users/''
  - Merge folders and Replace existing files :
    * Copy folder ''/<update_package>/client/program/'' (on Linux do not copy jre64)
    * Paste into ''/<install_folder>/client/'' 

=== Update Orbit Server ===

  - Delete following folders :
    * ''<install_folder>/server/program/jre64/'' (on Windows only)
    * ''<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/'' (on Linux do not copy jre64)
    * Paste into ''<install_folder>/server/''
  - Rename the license configuration file 
    * Rename file : ''<install_folder>/server/program/system/licenses_v17.0.ini''
    * Into : ''<install_folder>/server/program/system/licenses_v17.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 the Product Activation \\ [[171:server:console:license|EOS Console > License]] \\ Make sure you logon to the updated EOS Console version 17.1.1. Check its version displayed on top the logon panel. \\ If the product activation failed, see [[180:technology:core:online_license_activation|]].

=== Update Publications ===

  - Publish each Publication to update the version of the Publication to the latest version. \\ [[171:server:console:publisher|]]

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

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