Page Comparison

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.

To install Adeptia Connect in a cluster, follow same steps for each of the node in a cluster.

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 version 3.3.

Installing Adeptia Connect

Perform the following steps to install 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. 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. 
    
    

    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: Go to the directory where you extracted the zip file. Type the command ./install.bin -DConfigureDBviaURL=true. The installer starts installing Adeptia Connect and the Introduction screen appears with the installer introduction. Repeat the steps till 9 and click Next to view Configure Backend Database screen.   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 Provide the value of each fields as explained above. 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 9.

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

    
    
    
    
    
    

    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 No	Configure the port and make sure that no other application uses this port. By default, it uses port 1098.
    Configure AIMap Port
    AIMap Port No	Configure 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 Port	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 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 Port	HTTP 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.

Next Step

Launching Adeptia Connect