Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

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

  • If you are a new user, click here and fill required details to download free trial version of Installer.
  • If you are an existing user, click here to download the Installer for upgrading to Adeptia Connect

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

    Note
    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_3_12Aug2020_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. Anchor
      Enter
      Enter
      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.

      Info
      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. 

      Anchor
      Configure Backend Database
      Configure Backend Database
      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.


      Info

      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 tableof step 10.
      7. Click Next.


      Anchor
      Oracle pluggable database
      Oracle pluggable database

      Info

      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 910.

    13. On the Configure Connect Server screen, configure the Kernel and Web Server informationFor 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.

    Info
    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