This is documentation of a bèta release.
For documentation on the current version, please check Knowledge Base.

This is an old revision of the document!


Install Orbit Publisher Update 22.X

This page describes the update of an Orbit 3DM Publisher.
For documentation on the installation of a Server, see 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.

  1. Prepare the update.
  2. Respect the procedure as documented below.
  3. Take your time and work meticulously.

Preparations

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.

Verify Maintenance Validity of Activation Key

Verify the maintenance expiry data of your Activation Key in the https://my.orbitgt.com portal.
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 22.1, 2022 January, is released on January 1st 2022.

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

  • 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, if access to the data files remains the same. The Orbit Publisher “server” directory is around 500MB, including Orbit software, Orbit configurations, and Java setup.

  • Backup Client and Server program folders :
    • <install_folder>/client/program/* (Available for Feature Extraction Only)
    • <install_folder>/server/program/* (Avaiable for Feature Extraction and Publisher)

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 20.X or later to Current Release

The Current Release is What's New.

Stop Orbit Service

  1. Close all Orbit Desktop Clients.
  2. Stop the Orbit Service.
    • Run batch : <install_folder>/server/program/bin64/ServiceStop.bat.
  3. Verify the Operating System Services and the current status of “Orbit Enterprise Service”.

Delete Orbit Client

  1. Delete the following folders:
    • <install_folder>/client (When updating from 20.X only)

Update Orbit Server

  1. Delete the following folders:
    • <install_folder>/server/program/log/
    • <install_folder>/server/program/services/dox (When updating from 20.X only)
    • <install_folder>/server/program/software/
    • <install_folder>/server/program/wwwroot/viewer/
    • <install_folder>/server/program/wwwroot/viewer_sdk/
    • <install_folder>/server/program/wwwroot/viewer_sdk_javascript/
  2. Merge folders and Replace existing files :
    • Copy folder <update_package>/server/program/ and <update_package>/server/data/
    • Paste into <install_folder>/server/
  3. Rename the license configuration file
    • Rename file : <install_folder>/server/program/system/licenses_vXX.X.ini
    • Into : <install_folder>/server/program/system/licenses_v22.[X].ini (e.g. filename licenses_v22.1.ini for version 22.1)

Start Orbit Enterprise Service

  1. Start the Orbit Service.
    • Run batch : <install_folder>/server/program/bin64/ServiceStart.bat.
  2. Verify the Operating System Services and the current status “Running” of the “Orbit Enterprise Service”.
  3. Empty Cash and Hard Reload of the used browser when opening the Console.

Previous Updates

The procedures to update an older version to version 2X.X:

 
Last modified:: 2023/01/31 18:16