Rocket Process Automation/Integration

 View Only

How to Install the Rocket Process Integration (formerly Rocket API) Gateway on a Linux/Unix Server

  • 1.  How to Install the Rocket Process Integration (formerly Rocket API) Gateway on a Linux/Unix Server

    Posted 09-21-2021 17:49
    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
    ------------------------------