Knowledge Base - Version 23.4
Recent Changes
This is documentation of an archived release.
For documentation on the current version, please check Knowledge Base.

Update to Orbit 3DM Publisher 23.X - Orbit Legacy Activation

This page describes the update of an existing Orbit 3DM Publisher from version X to version Y.
For documentation on the clean installation of the Orbit 3DM Publisher, see Install Orbit 3DM Publisher - CONNECT Edition.

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

Preparations

A well-prepared update will take no longer than 15 minutes.

Communicate to coworkers

While updating, nobody will be able to use the application.

Verify Maintenance Validity of Activation Key

Updates are free of charge when having a valid software maintenance contract. Contact Orbit Sales for more information.

Verify the maintenance expiry date 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 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 What's New in Version 23.4.

Stop Orbit Service

  1. Stop the Orbit Service.
    • Run batch : <install_folder>/server/program/bin64/ServiceStop.bat.
  2. 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_YY.Y.ini (e.g. filename licenses_v23.1.ini for version 23.1)

Start Orbit 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”.
 
Last modified:: 2023/05/12 16:31