====== Orbit Server Installation ======

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

The installation of an Orbit Server is always in cooperation with the Orbit Support. 

===== Prepare =====

A well-prepared installation will take no longer than 10 minutes. 

=== Verify Server Requirements ===

Review the hardware and operating system specifications and requirements :
    * [[195:technology:platforms:index|]]
    * [[195:technology:platforms:specs_desktop|]]
    * [[195:technology:platforms:specs_server|]]
    * [[195:technology:platforms:specs_publisher|]]

=== Register ===

A registered Orbit account will be required to manage your licenses. \\
If you do not have your own account, complete and confirm your registration. Check your junk mail, the confirmation email might be blocked by your spam filter.\\
http://www.orbitgt.com/user/register

=== Request Activation Key ===

  * Request your Activation Key to validate your updated Product, contact Sales at Orbit GT.
  * Read the updated license system, online connectivity is required : [[195:technology:core:online_license_activation|]].

=== Download Installation Package ===

Download the installation package according the purchased product. \\
Make sure you download the package according your order. If you doubt which package to download, contact Orbit Support. 

  * Ftp : ftp://ftp.orbitgt.com
  * Login: ''OrbitSetups''
  * Password : ''OrbitGT!''
  * Update package : 
    * ''orbit_mm_feature_extraction_[version]_[operating system]_[date].zip''
    * ''orbit_mm_publisher_[version]_[operating system]_[date].zip''
    * ''orbit_oblique_publisher_[version]_[operating system]_[date].zip''

Unzip to the preferred installation directory.

===== Install =====

=== Review Server Configurations ===

Some custom configurations might be reset. Compare the following configuration with the backup :
  * JAVA_MAX_MEMORY_MB \\ ..\server\program\bin64\ServiceInstall.bat (Edit e.g. with Notepad)

=== Install and Start Orbit Service ===

  - Install the Orbit Service, read more : [[195:server:eos:service|]] \\ ../server/program/bin64 > ServiceInstall.bat (Run as administrator)
  - Start the Orbit Service \\ ../server/program/bin64 > ServiceStart.bat (Run as administrator)
  - Verify started "Orbit Enterprise Service" \\ Operating System Services > Status of "Orbit Enterprise Service" should be "Started"

=== Activate Product ===

  - Activate your product using your Product Activation Key : \\ EOS Console : [[195:server:console:license|]]

===== Flash-based Plugins and WebClient SDK =====

=== Add Plugin Activation Key to Publisher ===

Any Orbit Plugin using the Orbit WebClient API requires online activation, see [[195:technology:core:online_license_activation|]]. \\
The Plugin Activation Key can be (a) entered manually by the user or (b) requested from an Orbit Publisher and applied automatically without user interaction. In the second scenario the Orbit Plugin will only be able to connect and request data from the given Orbit Publisher.

To request a Plugin Activation Key from the connecting Publisher an additional Server Product must be added to your Publisher setup. Activation of this Server Product will include the Activation Key of your Orbit Plugin. 

Steps on how to enable Plugin Activation via Publisher : 
  - Request a Server Product Installer License for your Orbit Plugin, contact sales@orbitgt.com.
  - Copy the Server Product Installer License to <Orbit installation directory>server/program/system/
  - Restart the Orbit EOS service, see [[195:server:eos:service|]].
  - Request an Activation Key for the newly added Server Product via the EOS Console > [[195:server:console:license|]] tab. \\ Add the Activation Key of your Orbit Plugin you would like to embed as user comment. 
  - Activate the Server Product using the received Activation Key. 
  - Point the Plugin to request the Activation Key from the Orbit Publisher. \\ As Plugin developer you can already preset your Plugin to do so, see [[195:developer:index|]].