GR:Gravity/Xref/Setup/Gravity server

This section will explain how to install a Gravity Server with the embedded H2SQL database support.

For Windows we have an installer that does an automated install of the Gravity server, including setting up a Windows service for server. To do this follow these instructions on this page: *GR:Gravity/Installation/Server/Windows

For running the Gravity server in the IBMi Pase environment, without TD/OMS installed, the procedure below can be followed (in this case from an ssh terminal). Note that Gravity server requires Java 8 to be installed on the IBMi, also the network ports 45050, 45051, 45052, 45053 and 45054 need to be accessible for Web and client access:

Create the Gravity installation directory in the IFS, for example /QOpensys/TD/GravityEA.

Download the Gravity server Linux zip file (from Gravity Nightly), for example the zip file: gravityeaoserver-lin64-9.1.3.2025-07-18_13-18-30.zip, make sure you download the gravityeaoserver and not the gravitysaoserver, the sao does not have the embedded H2SQL database support.

Unzip the contents of the zip file to the previously created Gravity installation directory, for example 'unzip gravityeaoserver-lin64-9.1.3.2025-07-18_13-18-30.zip -d /QOpensys/TD/GravityEA', the root of the installation directory should have the following contents:
-rw-rw-r--  artifacts.xml
drwxrwsr-x  certificates
drwxrwsr-x  configuration
-rw-rw-r--  _config_admin_config.properties
drwxrwsr-x  features
-rwxr-xr-x  gravityeaoserver
-rw-rw-r--  gravityeaoserver.ini
-rwxrwxr-x  gravityoserver.cmd
-rwxrwxr-x  gravityoserver.qsh
-rwxrwxr-x  gravityoserver.sh
-rwxrwxr-x  gravityserver.qsh
-rw-rw-r--  jetty.properties
-rw-rw-r--  log4j.properties
-rw-rw-r--  logback.xml
-rw-rw-r--  omx.config
drwxrwsr-x  p2
drwxrwsr-x  plugins
-rw-rw-r--  remain-footer.png
-rw-rw-r--  remainsoftware-logo.png
-----w--w-  temp.txt
-rw-rw-r--  tika-config.xml
-rwxrwxr-x  update.qsh
-rwxrwxr-x  update.sh

You will note that there are startup scripts for multiple platforms, the .cmd scripts are for Windows, the .sh scripts are for Linux/Unix and the .qsh scripts are for the IBMi.
If owner and file permissions are correct then you can start the Gravity server in the background with the following command (from within the Gravity server installation directory):

IBM-i:> nohup ./gravityserver.qsh >log.out 2>&1 &

To stop the server, look up the Gravity server process id (pid) with the command:> ps -ef | grep gravity.home, output will look something like:

  userx 7341 7319   0 14:18:19  pts/0  0:00 java -Xms1024m -Xmx2g -Xss800k -XX:+DisableExplicitGC -XX:+CMSClassUnloadingEnabled -XX:+UseConcMarkSweepGC -Dsolr.solr.home=/QOpenSys/TD/GravityEA/.data/ solr -Dsolr.default.host.port=45060 -Dtika.config=/QOpenSys/TD/GravityEA/tika-config.xml -Djava.awt.headless=true -Dinstance.dir=/QOpenSys/TD/GravityEA -Dgravity.home=/QOpenSys/TD/GravityEA/.data -Dgravity.home.subpath= ... -initialize -noExit

To stop the Gravity server process, use the first pid number for the kill command:> kill 7341