Launching Adeptia Connect - Linux

Apart from starting Adeptia Connect application manually, you can also configure it to be started automatically as a service at the start of your system running on Linux. 

The details below guide you on how to start the application in both manual and automatic ways.

This page contains the following information:

Starting Connect Server

This section guides you on how to start Connect Server manually and automatically.

Prerequisite

Configure the systemd service in your Linux operation system.

Starting Connect Server manually

To start or stop the Connect Server Kernel, WebRunner, and AIMap, follow the steps below:

1. Open Terminal.
2. Go to the directory ...<ConnectServerInstallFolder>/AdeptiaServer/ServerKernel.
3. Type ./startup.sh to start.

To stop the services, type ./stop.sh.

To ensure that Connect Kernel and Connect WebRunner are started successfully, go to the directory .../<ConnectServerInstallFolder>/AdeptiaServer/ServerKernel/logs/applicationlogs and type the following commands respectively:

• cat KernelApplication.log
• cat WebrunnerApplication.log

These commands will display the details of the KernelApplication.log and WebrunnerApplication.log files respectively. Ensure that these files contain the message that "Kernel has started successfully" and "WebRunner has started successfully".

Starting Connect Server automatically as a Linux daemon

Perform the following steps to start Connect Server as a daemon:

1. Go to the folder ...<ConnectServerInstallFolder>/AdeptiaServer/ServerKernel.
2. Open startup.sh file.

3. Update the path in the file as depicted in the example image given below.
   
   
   

   Ensure that the:

   • Path you enter is as per the installed location of Adeptia Connect in your system.
     
   • startup.sh file has executable permissions for the root user.

4. Create a Systemd service file, “adeptiaconnectserver.service”, for the Connect Server at the following location: /etc/systemd/system.
   

   [Unit]
   Description= Adeptia Connect Server
   Documentation= https://docs.adeptia.com/
   
   [Service]
   Type=simple
   RemainAfterExit=true
   ExecStart=/bin/bash /usr/local/bin/AdeptiaBuild/AdeptiaConnect-3.3/ConnectServer/AdeptiaServer/ServerKernel/startup.sh
   
   [Install]
   WantedBy=multi-user.target

   Ensure that the path you enter is as per the installed location of Adeptia Connect in your system.

   
   

5. Run the following command to reload the systemd daemon.
   systemctl daemon-reload
6. Run the following command to start the Connect Server
   systemctl start adeptiaconnectserver
7. Run the following command to enable the newly created service for the Connect Server to get started on system start-up.
   systemctl enable adeptiaconnectserver 

The Connect Server will now start automatically whenever your system starts.

To stop or restart the Connect Server running as a daemon, use the following commands:

• To stop, run the following command:
  systemctl stop adeptiaconnectserver
• To restart, run the following command:
  systemctl restart adeptiaconnectserver

Starting Connect Portal

This section guides you on how to start Connect Portal manually and automatically.

Prerequisite

Configure the systemd service in your Linux operation system.

Starting Connect Portal manually

To start or stop the Connect Portal, follow the steps below:

1. Open Terminal.
2. Go to the directory ...<ConnectPortaInstallFolder>/bin.
3. Type ./startup.sh to start.

To stop the services, type ./stop.sh.

To ensure that Connect Kernel and Connect WebRunner are started successfully, go to the directory .../<ConnectPortalInstallFolder>/logs and type the command.
cat catalina-YYYY-MM-DD HH-MM-SS.log

Ensure that these files contain the message stating Starting ProtocolHandler ["http-nio-80"].

Starting Connect Portal automatically as a Linux daemon

Perform the following steps to start Connect Server as a daemon:

1. Go to the folder …<ConnectPortaInstallFolder>/bin.
2. Open startup.sh file.

3. Update the path in the file as depicted in the image given below.
   
   
   
   

   Ensure that the:

   • Path you enter is as per the installed location of Adeptia Connect in your system.
     
   • startup.sh file has executable permissions for the root user.

4. Create a Systemd service file, “adeptiaconnectportal.service”, for the Connect portal at the following location:
   /etc/systemd/system.       

   [Unit]
   Description= Adeptia Connect Portal
   Documentation= https://docs.adeptia.com/
   
   [Service]
   Type= simple
   
   RemainAfterExit=true
   ExecStart=/bin/bash /usr/local/bin/AdeptiaBuild/AdeptiaConnect-3.3/ConnectPortal/bin/startup.sh
   
   [Install]
   WantedBy= multi-user.target

   Ensure that the path you enter is as per the installed location of Adeptia Connect in your system.
5. Run the following command to reload the systemd daemon.
   systemctl daemon-reload
6. Run the following command to start the Connect Portal
   systemctl start adeptiaconnectportal
7. Run the following command to enable the newly created service for the Connect Portal to get started on system start-up.
   systemctl enable adeptiaconnectportal

The Connect Portal will now start automatically whenever your system starts.

To stop or restart the Connect Portal running as a daemon, use the following commands:

• To stop, run the following command:
  systemctl stop adeptiaconnectportal
• To restart, run the following command:
  systemctl restart adeptiaconnectportal
  

Next step

Verifying Installation