Installing on Linux

Owned by Saurabh Gupta (Unlicensed)
Last updated: Jul 19, 2023 by Avinash Kumar
6 min read

This section assists you in installation of Adeptia Connect on a Linux-based operating system. Refer to System requirements and Prerequisites before you install Adeptia Connect.

Downloading Adeptia Connect

You can download the Adeptia Connect Installer version 3.6 from Adeptia website.

If you are using Oracle pluggable database as the Backend and Log database then click here for detailed instructions. 

Installing Adeptia Connect

  1. Unzip the zip file. The format of the zip file is: AdeptiaConnect_<version>_<Date>_<OS>_<Architecture>.zip.

    For example, AdeptiaConnect_3_5_10June2021_Linux_x64.zip file.

  2. Go to the directory where you extracted the zip file.
  3. Type the command chmod +x install.bin to get the execution permission on installer file.
  4. Type the command ./install.bin.
  5. The installer starts installing Adeptia Connect and the Introduction screen appears with the installer introduction.
  6. Press Enter to continue.



  7. The installation requires accepting the terms in the license agreement. Read the agreement carefully and if agree to the terms, type Y.



  8. On the Choose Install Folder screen, type the destination directory where you want to install the Adeptia Connect or allow it at the default location.



  9. On the Choose Install Set screen, select the type of installation.



    Connect Server: Install only the Server on this machine while Portal part is installed separately on another machine. Install Connect Server before installing Portal.

    Connect Portal: Install only the Portal on this machine while Server part is installed separately on another machine.

    Both for Single-Server Install:    Install both Portal and Server on this machine. Recommended for Trials/Evaluations, Non-Production and simpler Production environments.

    If you are choosing Connect Portal, the installer will display Connect Portal Configuration screen (Step 13 below) to install Connect Portal. 


    Following are the steps for Both option (Single-Server Install).

  10. On the Configure Backend Database screen, select the database you want to use for the Backend. Configure the port and make sure that no other application uses this port. 

    Select the database you need to use for Backend and Log, and provide the details of the selected database.

    Select Database Type

    Name of the database that you want to set for logging. Adeptia Connect supports SQL Server, MySQL, and Oracle databases.

    Database Server Name

    Name/IP address of the database server.

    Port

    Port number of the database.

    Database Name

    Name of the database.
    If you want to use a named instance of SQL Server for backend database, enter the database name in the following format:

    <Database Name>;instance=<SQL instance name> 

    For example, if your Database Name is AdeptiaDB and instance name is development then the Database Name will be in the format:

    AdeptiaDB;instanceName=development;

    User Name

    Username to access the database.

    Password

    Password to access the database.

    Confirm Password

    Password to confirm.

    Database Tables

    Create New Tables: To create new tables in the defined Adeptia Connect database. Select this option if you are installing Adeptia Connect on a single computer.

    Use Existing Tables: To use the existing tables of the Adeptia Connect database. Select this option if you are installing Adeptia Connect in a clustering mode.

    Name

    Description

    MySQL

    Ensure that you have permission to SELECT, CREATE, DROP, INDEX, ALTER, INSERT, UPDATE, DELETE, REFERENCES, CREATE ROUTINE, ALTER ROUTINE, and EXECUTE for MySQL Database.

    Oracle

    Ensure that you have permission to CREATE SESSION, CREATE TABLE, CREATE ANY TABLE, ALTER ANY TABLE, DROP ANY TABLE, DELETE ANY TABLE, SELECT ANY TABLE, UPDATE ANY TABLE, INSERT ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX,CREATE PROCEDURE, CREATE ANY PROCEDURE, ALTER ANY PROCEDURE, DROP ANY PROCEDURE, and EXECUTE ANY PROCEDURE for Oracle Database.

    SQL Server

    Ensure that you have permission to CREATE TABLE, ADD COLUMN, CREATE INDEX, DROP COLUMN, DROP INDEX, DROP TABLE, CREATE PROCEDURE, ALTER PROCEDURE, EXECUTE, and DROP PROCEDURE for SQL Server Database.

    If an error is displayed related to time zone while configuring the Backend and Log Database as MySQL then follow the steps below:

    1. Go to the directory where you extracted the zip file.
    2. Type the command ./install.bin -DConfigureDBviaURL=true.
    3. The installer starts installing Adeptia Connect and the Introduction screen appears with the installer introduction.
    4. Perform the steps from 6 through 9 and click Next to view Configure Backend Database screen.  
    5. Enter the JDBC URL as jdbc:mysql://<hostname>:<port no.>/<DB Name>?useSSL=false&serverTimezone=<time zone>.

      Here,
      Hostname: Name/IP address of the database server.
      Port No.: Port number of the database.
      Database name: Name of the database.
      Time zone: Time zone of your MySQL server

    6. Provide the value of each fields as explained above in the first table of step 10.
    7. Click Next.

    If you are using Oracle pluggable database as the Backend and Log database then follow the steps below:

    1. Go to the directory where you extracted the zip file.
    2. Type the command ./install.bin -DConfigureDBviaURL=true.
    3. The installer starts installing Adeptia Connect and the Introduction screen appears with the installer introduction.
    4. Perform the steps from 6 through 9 and click Next to view Configure Backend Database screen.  
    5. Enter the JDBC URL as jdbc:oracle:thin:@<hostname>:<port no.>/<DB Name>.

      Here,
      Hostname: Name/IP address of the database server.
      Port No.: Port number of the database.
      Database name: Name of the database.

    6. Provide the value of each fields as explained above in the first table of step 10.
    7. Click Next.

  11. On the Configure Log Database screen, select the database you want to use for the Log. Configure the port and make sure that no other application uses this port. 



  12. Select the Database you want to use for the Log. Follow the step as described in step 10.

  13. On the Configure Connect Server screen, configure the Kernel and Web Server information. For information on Kernel and WebRunner, refer to Components of Connect Server.






    Name

    Description

    Configure Kernel

    Port No

    Port that the Kernel will use. Make sure that no other application uses this port. By default, the Kernel uses port 21000.

    Configure Web Server

    Configure Web Server

    IP address that Adeptia Connect will use. IP address is required for installing Adeptia Connect in clustering mode.

    Configure Web Server HTTP Port

    HTTP Port No

    HTTP port for Adeptia Connect. Make sure that no other application uses this port. By default, Adeptia Connect uses the 8080 HTTP port in the normal mode.

    Configure Web Server HTTPS Port

    HTTPS Port No

    Secure HTTP port that the machine will use to access Adeptia Connect in a secure mode. Make sure that no other application uses this port. By default, Adeptia Connect uses the 8443 HTTP port in the secured mode.

    Configure RMI Port

    RMI Port NoConfigure the port and make sure that no other application uses this port. By default, it uses port 1098.

    Configure AIMap Port

    AIMap Port NoConfigure the port and make sure that no other application uses this port. By default, it uses port 7570.

  14. On the Configure Connect Portal screen, configure the Portal Host, HTTP Port, and Server URL information.



    Name

    Description

    Configure Portal Host

    Portal Host

    IP address that Adeptia Connect will use.

    Configure Connect Portal HTTP Port

    HTTP Port

    HTTP port for Adeptia Connect. Make sure that no other application uses this port. By default, Adeptia Connect uses the 8088 HTTP port in the normal mode.

    Configure Connect Portal HTTPS Port
    HTTPS PortSecure HTTP port that the machine will use to access Adeptia Connect in a secure mode. Make sure that no other application uses this port. By default, Adeptia Connect uses the 8843 HTTP port in the secured mode.

    Configure Connect Server Host (Backend)

    Connect Server Host

    IP address/Host Name of the Connect Server.

    Configure Connect Server Port (Backend)

    Connect Server PortHTTP port number of Connect Server. By default, Adeptia Connect uses the 8080 HTTP port in the normal mode.

  15. On the Configure Mail screen, configure the email to be used for sending email notifications.



    Name

    Description

    Mail (SMTP) Server Name

    Name or IP address of the outgoing mail (SMTP) server.

    Port (SMTP) No

    Port number of the outgoing mail (SMTP) server.

    Admin’s Email Id

    Email address of Adeptia Connect Administrator or System Administrator.

    Account Name

    Username for accessing the specified email account.

    Email Security Type

    Type of Security - SSL and TLS. SSL for email communication, if your email server uses SSL.

  16. The Pre-Installation Summary displays the brief summary of all settings selected while installing Adeptia Connect. Review the summary and to begin installation, press Enter.



  17. The installer starts installing the Adeptia Connect. After the successful installation, the Installation Complete appears.
  18. Press Enter to exit from the installation wizard.

The installer creates a log file (AdeptiaConnect_InstallLog.log) to the folder where you have installed. Refer to this file to know the errors occurred while installing Adeptia Connect.

Next Step

Launching Adeptia Connect


You may be interested in...
What's new
Best practices
Training guides
Frequently asked questions
Adeptia Connect APIs
Adeptia security report
Download Adeptia Connect