Skip to main content
1) Transfer the installation file to the Linux server using FTP/SFTP. Use tools like Bluezone FTP or WinSCP for file transfer.

2) On the Linux host check permissions on the installation file:

-sh-4.2$ ls -al
drwxr-xr-x 2 hrawat abp         0 Mar 30 08:06 .
drwxr-xr-x 6 hrawat abp         0 Mar 30 08:06 ..
-rw-r--r-- 1 hrawat abp 159081279 Jan 26 11:37 RocketAPIGWUnixLinux.run

3) Give execution permissions to the user: 

-sh-4.2$ chmod 744 RocketAPIGWUnixLinux.run
-sh-4.2$ ls -al
drwxr-xr-x 2 hrawat abp         0 Mar 30 08:06 .
drwxr-xr-x 6 hrawat abp         0 Mar 30 08:06 ..
-rwxr--r-- 1 hrawat abp 159081279 Jan 26 11:37 RocketAPIGWUnixLinux.run
​


4) Run the install file:

-sh-4.2$ ./RocketAPIGWUnixLinux.run

Verifying archive integrity...  100%   All good.
Uncompressing Rocket API Gateway Setup  100%
=============================================================================
                       Rocket Software Installation
=============================================================================
Welcome to the Rocket API Gateway Setup

This wizard will guide you through the installation of Rocket API Gateway


Specify an instance name
Leave empty for default value or input Q for quit
Default: Default

Instance name: APIGW01

Specify destination directory
Leave empty for default value or input Q for quit
Default: /opt/rocketsoftware/rocketapigateway/APIGW01

Destination directory:

Specify HTTP Admin port
Leave empty for default value or input Q for quit
Default: 8180

HTTP Admin Port:

Use the Access and Connectivity Hub (Y=Yes, N=No, Q=Abort)? N

Installation in progress, please wait...

You have successfully installed Rocket API Gateway

  The following parameters were used:
  Destination directory: /opt/rocketsoftware/rocketapigateway/APIGW01
  Instance name: APIGW01
  HTTP Admin port: 8180
  Hub address:
  Hub realm:
  Hub environment:
  Hub engine UUID:

Thank you for installing Rocket Software


5) In the above output we see that the API GW has been installed with an instance name of APIGW01, in directory /opt/rocketsoftware/rocketapigateway/APIGW01 and using port 8180. This setup does not use the Rocket API HUB.

6) Start API GW:

-sh-4.2$ cd /opt/rocketsoftware/rocketapigateway/APIGW01

-sh-4.2$ ls
bin  config  hub.cfg  lib  MSMQConnectionInterface.dll  NOTICES  resources  start-server-mq.sh  start-server.sh  stop-server.sh

-sh-4.2$ ./start-server.sh
SERVER_NAME:APIGW01
CONFIG_DIR:config
JDK Version 8 detected, endorsed support
Starting in the background
-sh-4.2$ nohup: appending output to 'nohup.out'


7) You can check the GW status using following command:

-sh-4.2$ pwd
/opt/rocketsoftware/rocketapigateway/APIGW01

-sh-4.2$ tail -2 log/gateway-20210330081753.log
2021-03-30 08:17:54,785 INFO  [main][com.seagullsw.appinterface.server.AppInterfaceServer] RUNNING AppInterfaceServer
2021-03-30 08:17:54,785 INFO  [main][com.seagullsw.appinterface.server.AppInterfaceServer.StartUp.Complete] Rocket API Gateway start-up completed, Version 8.5.5 (build 8.3875.0.0/648).


8) To check the running process use the following:

-sh-4.2$ ps -aux | grep -i APIGW01 | grep -v grep
hrawat    61406  0.2  3.1 4605264 255220 pts/0  Sl   08:41   0:06 java -Xbootclasspath/a:/lib/tools.jar -Dcom.seagullsw.server.name=APIGW01 -Djava.endorsed.dirs=lib/endorsed -Djavax.xml.transform.TransformerFactory=org.apache.xalan.xsltc.trax.SmartTransformerFactoryImpl -Dorg.apache.cxf.Logger=org.apache.cxf.common.logging.Log4jLogger -Dcom.seagullsw.lde.config.dir=config com.seagullsw.appinterface.server.AppInterfaceServer --strictStart -c config
-sh-4.2$


9) Make sure to generate a license file (.SAF) and place it at installation directory. 

Hope this is helpful! Let me know if you run into any troubles or need instructions for other platforms or environments.



------------------------------
Harish Rawat
Level 2 Technical Support Engineer
Rocket Internal - All Brands
------------------------------