Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Downloading Adeptia Connect

You can download the Adeptia Connect Installer version 3.5 7 from Adeptia website.

Note
If you are using Oracle pluggable database as the Backend and Log database, 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_Win_x64.

  2. Anchor
    InstallAnywhere
    InstallAnywhere
    Double click install.exe, the InstallAnywhere pop-up appears.



  3. After preparation is complete, installer shows an Introduction screen.



  4. Click Next to view End User License Agreement screen.



  5. Select the checkbox I accept the terms of the License Agreement

  6. Click Next to view Choose Installation Folder screen.



  7. Select the destination folder to install the Developer's Studio or allow it at the default location. For example, Default directory - C:\Program Files\AdeptiaConnect.

  8. If you have selected the destination folder then on clicking Next, you will be prompted to overwrite the existing files. Click Yes to proceed further.



  9. Select the type of installation on Select What to Install screen.



    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.

    Info
    The system asks for the Connect Server details and checks for a successful connection to it during the installation of Connect Portal. If the connection fails, you receive the following alert message:

    Connection to the Connect Server (http://<Server name or IP>:<Port number>/) could not be established. Do you still want to continue?

    If you click Yes, the wizardwill proceed to the next step, else it will remain on the same screen.

    Both for Single-Server InstallInstall 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 16 below) and start installing Connect Portal.

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

  10. Click Next to view Configure Backend Database screen. 



    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.

    Name

    Description

    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>;instanceName=<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.


    Database

    Required Permission

    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.exe -DConfigureDBviaURL=true.
    3. The InstallAnywhere pop-up appears telling you the progress status of installation.
    4. Perform the steps from 2 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.

    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.exe -DConfigureDBviaURL=true.
    3. The InstallAnywhere pop-up appears telling you the progress status of installation.
    4. Perform the steps from 2through 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. If you have selected Create New Tables option, you will be prompted to overwrite all the existing tables. Click Yes to continue. 



  12. Click Next to view Configure Log Database screen.



  13. Select the database you want to use for the log. Follow the details as described in Step 10. 
  14. Click Next to view Configure Kernel & Web Server screen. For information on Kernel and WebRunner, refer to Components of Connect Server.



  15. Configure the Adeptia Connect Kernel and Web Server information by providing the details in the below fields.

    Name

    Description

    Kernel Configuration 

    Port No

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

    Web Server Configuration 

    Host Name/IP Address

    IP address that Connect Server will use. The IP address is required while installing Connect Server in a clustering mode.

    HTTP Port No

    HTTP port for Connect Server. Ensure that no other application uses this port. By default, Connect Server uses the 8080 HTTP port in the normal mode.

    HTTPS Port No

    Secure HTTP port to access Connect Server in a secure mode. Ensure that no other application uses this port. By default, Connect Server uses the 8443 HTTP port in the secured mode.

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


  16. Click Next to view Connect Portal Configuration screen.



    Provide the details mentioned in the following table to configure Connect Portal.

    Name

    Description

    Portal Configuration

    Portal HostIP address that Adeptia Connect Portal will use.

    HTTP Port

    HTTP port for Adeptia Connect Portal web component. Ensure that no other application uses this port. By default, Adeptia Connect uses the 8088 HTTP port in the normal mode.

    HTTPS Port

    Secure HTTP port to access Adeptia Connect Portal in a secure mode. Ensure that no other application uses this port. By default, Adeptia Connect Portal uses the 8843 HTTP port in the secured mode.

    Connect Server Information
    Server HostIP/Domain address of the machine where Connect Server is installed. If Connect Server is running behind firewall or load balancer, provide IP/Domain of firewall or load balancer.
    Server HTTP PortHTTP port on which Connect Server is accessible.


    Info
    For non-evaluation environment, we recommend to use ports 80 for HTTP and 443 for HTTPs if they are available.


  17. Click Next to view Configure Mail screen.


    Provide following details to configure the email. This email will be used by Connect to send notifications.

    Name

    Description

    Mail (SMTP) Server Name

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

    Mail (SMTP) Port No

    Port number of the outgoing email (SMTP) server.

    Admin's Email Id

    Email address of Developer's Studio's Administrator or System Administrator.

    Account Name

    Username for accessing the specified email account.

    Password

    Password for accessing the specified email account.

    Confirm Password

    Password to confirm 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.


  18. Click Next to view Configure Auto Startup (Optional) screen and do the following:

    1. In the Add as Windows Service group, select Connect Server and Connect Portal check boxes for configuring Kernel and WebRunner as Windows services.
    2. In the Windows Service Configuration group, select the start type for Windows service from the Service Start Type.

      Auto: Select this option to start the services automatically each time you start the computer. 
      Manual: Select this option to start the services manually.



  19. Click Next to view the Pre-Installation Summary screen. The screen displays a brief summary of the settings selected while installing Adeptia Connect. Review the settings and to begin the installation, click Install.



  20. The installer starts installing Adeptia Connect.



  21. On the Installation Complete screen, click Launch Adeptia Connect check box to start Adeptia Connect immediately after the installation. This automatically starts Adeptia Connect (Connect Server and Portal) and opens the login screen in the web browser.



  22. Click Done 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

Verifying Installation