Knowledge Base
Recent Changes

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
dev:server:install:server_update_publisher [2021/01/21 17:41]
jeroen [Steps to Update from 20.X to 21.X] 		dev:server:install:server_update_publisher [2023/01/31 18:31]
jeroen removed
Line 1: Line 1:
-====== Orbit Publisher Update 21.X ======+====== Update to Orbit 3DM Publisher 23.X - Orbit Legacy ====== 
 + 
 +This page describes the update of an Orbit 3DM Publisher. \\ 
 +For documentation on the installation of a Server, see [[dev:technology:platforms:install_server|]]. 
 + 
 +<note tip>   
 +  - Prepare the update. 
 +  - Respect the procedure as documented below. 
 +  - Take your time and work meticulously. 
 +</note>
  
 ===== Preparations ===== ===== Preparations =====
  
-For preparations, see [[dev:server:install:server_update|]].+=== Communicate to coworkers ===
  
-===== Steps to Update from 20.X to 21.X =====+While updating, nobody will be able to use the application. \\ 
 +A well-prepared update will take no longer than 15 minutes.
  
-Hereby the procedure to update the Orbit Server Setup from version 20.X to the latest released version \\ +=== Verify Maintenance Validity of Activation Key ===
-The procedures to install the previous update is available, see [[dev:index_previous_versions|]].+
  
-<note warning> +Updates are free of charge when having a valid software maintenance contract. Contact Orbit Sales for more information. 
-From version 21.1, the Orbit 3DM Catalog Client is removed from the Orbit 3DM Publisher setup and replaced by the standalone product [[dev:products:3dm_import_and_upload_tool|]]. \\ + 
-A license for this new product is free of charge, covered by your Publisher maintenance, and available from your https://my.orbitgt.com porta. +Verify the maintenance expiry date of your Activation Key in the https://my.orbitgt.com portal. \\ 
-</note>+The Activation Key maintenance expiry date must be later than the version's official release date. \\ 
 +The version's official release date can be derived from the version number and is always set to be on the first day of the month:  e.g. version 23.1, 2023 January, is released on January 1st, 2023. 
 + 
 +=== 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 > Main Toolbar > Help > About > Details 
 + 
 +  * Ftp : ftp://ftp.orbitgt.com 
 +  * Login: ''OrbitSetups'' 
 +  * Password : ''OrbitGT!'' 
 +  * Update package : download corresponding update package 
 + 
 +=== Create Full Backup === 
 + 
 +A full backup of the Orbit "server" directory will allow an instant recovery of the Publisher setup. \\ 
 +The Orbit Publisher "server" directory is around 500MB, including Orbit software, Orbit configurations, and Java setup. When assistance is requested, Orbit Support will request access to this backup. 
 + 
 +    * ''<install_folder>/server/program/*''  
 + 
 + 
 + 
 +===== Steps to Update from 20.X or later to Current Version ===== 
 + 
 +The Current Release, see [[dev:whats_new:index|]].
  
 === Stop Orbit Service === === Stop Orbit Service ===
  
-  - Close all Orbit Desktop Clients. +  - Stop the Orbit Service. 
-  - Stop the [[dev:server:eos:service|Orbit Service]]. +
      * Run batch : ''<install_folder>/server/program/bin64/ServiceStop.bat''.      * Run batch : ''<install_folder>/server/program/bin64/ServiceStop.bat''.
   - Verify the Operating System Services and the current status of "Orbit Enterprise Service".   - Verify the Operating System Services and the current status of "Orbit Enterprise Service".
  
-=== Remove Orbit Client ===+=== Delete Orbit Client ===
  
-  - Delete following folders :  +  - Delete the following folders:  
-    * ''<install_folder>/client''+    * ''<install_folder>/client'' (When updating from 20.X only)
  
 === Update Orbit Server === === Update Orbit Server ===
  
-  - Delete following folders :+  - Delete the following folders:
     * ''<install_folder>/server/program/log/''     * ''<install_folder>/server/program/log/''
-    * ''<install_folder>/server/program/services/dox'' +    * ''<install_folder>/server/program/services/dox'' (When updating from 20.X only)
     * ''<install_folder>/server/program/software/''     * ''<install_folder>/server/program/software/''
     * ''<install_folder>/server/program/wwwroot/viewer/''     * ''<install_folder>/server/program/wwwroot/viewer/''
Line 37: Line 69:
     * ''<install_folder>/server/program/wwwroot/viewer_sdk_javascript/''     * ''<install_folder>/server/program/wwwroot/viewer_sdk_javascript/''
   - Merge folders and Replace existing files :   - Merge folders and Replace existing files :
-    * Copy folder ''<update_package>/server/program/''+    * Copy folder ''<update_package>/server/program/'' and ''<update_package>/server/data/''
     * Paste into ''<install_folder>/server/''     * Paste into ''<install_folder>/server/''
   - Rename the license configuration file    - Rename the license configuration file 
     * Rename file : ''<install_folder>/server/program/system/licenses_vXX.X.ini''     * Rename file : ''<install_folder>/server/program/system/licenses_vXX.X.ini''
-    * Into : ''<install_folder>/server/program/system/licenses_v21.[X].ini'' (e.g. filename ''licenses_v21.1.ini'' for version 21.1) +    * Into : ''<install_folder>/server/program/system/licenses_YY.Y.ini''  (e.g. filename ''licenses_v23.1.ini'' for version 23.1)
  
-=== Start Orbit Enterprise Service ===+=== Start Orbit Service ===
  
-  - Start the [[dev:server:eos:service|Orbit Service]]. +  - Start the Orbit Service. 
      * Run batch : ''<install_folder>/server/program/bin64/ServiceStart.bat''.      * Run batch : ''<install_folder>/server/program/bin64/ServiceStart.bat''.
   - Verify the Operating System Services and the current status "Running" of the “Orbit Enterprise Service”.   - Verify the Operating System Services and the current status "Running" of the “Orbit Enterprise Service”.
-  - Empty Cash and Hard Reload of the used browser when opening the Console.+