This is documentation of an archived release.
For documentation on the current version, please check Knowledge Base.

Orbit Startup Configurations

This page describes some Orbit desktop startup configurations you might want to adjust but which are (currently) not available as user preference.

Language

English is used as default language. Set the language name to start Orbit in another available language.
The Orbit team only maintains English translations, interest in translating contact sales@orbitgt.com

  • File : <Orbit Installation directory>/program/config/orbitgis.ini
  • Parameter : system.languagename
  • Value : deutsch, english, espagnol, francais, greek, hebrew, nederlands, polski, russian, turkce
  • Example for Spanish
    system.languagename       espagnol   

Memory Use

Get more Orbit out your powerful machine. Raise the amount of memory (RAM) that can be used by an Orbit 64bit installation.

When using a 64bit Orbit installation on a 64bit operating system it is possible to raise the amount of memory (RAM) that can be used by Orbit. This is even recommended when handling big files or running heavy calculations.

Set Maximum Memory usage

The maximum amount of memory that you can allocate to Orbit depends on your hardware specifications and the number of applications running concurrently on the device. Reserve at least 2GB for your Operating System.

1. Edit the Orbit configuration file in the bin folder of your Orbit installation (use a text editor, e.g. Notepad) :

  • Orbit desktop Standalone : ../program/bin/Orbit.ini
  • Orbit desktop Client : ../client/program/bin/OrbitClient.ini
  • Orbit Server : ../server/program/bin/ServiceInstall.bat

2. Update the maximum used memory value, but save at least 2GB for your Operating System :

  • Orbit desktop Standalone and Client : -Xmx[Value]m
  • Orbit Server : JAVA_MAX_MEMORY_MB=[Value]

This value is expressed in Mega Bytes, examples values :

  • 1GB : 1024
  • 2GB : 2048
  • 4GB : 4096
  • 6GB : 6144
  • 8GB : 8192

3. Restart Orbit to take advantage of the newly set maximum memory use :

  • Orbit desktop Standalone and Client : Restart desktop application
  • Orbit Server : Re-install the Orbit Service, execute in this order : ServiceStop, ServiceRemove, ServiceInstall, ServiceStart.bat. Read more, Orbit Enterprise Service.

Minimum vs Maximum Memory usage

We advise to set a maximum memory use that can be used by Orbit.
If no maximum has been set Java will allocate by default 1/4 of the total available memory. When using 32bit this is fix 256M.

Http or Https Proxy

Parameters to set Orbit Java VM http proxy arguments :

  • File : <Orbit Installation directory>/program/Orbit.ini
    Add proxy configuration in between the -Xmx and -splash arguments.
  • Parameters for Http : -Dhttp.proxyHost, Dhttp.proxyPort, Dhttp.proxyUser, Dhttp.proxyPassword
  • Parameters for Https : -Dhttps.proxyHost, Dhttps.proxyPort, Dhttps.proxyUser, Dhttps.proxyPassword
  • Example for Http
    -Dhttp.proxyHost=0.0.0.0
    -Dhttp.proxyPort=0000
    -Dhttp.proxyUser=xxx
    -Dhttp.proxyPassword=xxx

Map-Tabs split view ratio

Parameter to to set the startup split screen ratio of Map and Tabs :

  • File : <Orbit Installation directory>/program/config/orbitgis.ini
  • Parameter : app.element.orbitgis_extensions_tab.parameter_value
  • Value range : 0.00 - 1.00
  • Example :
    app.element.orbitgis_extensions_tab.parameter_value 0.80
 
Last modified:: 2019/03/25 11:36