Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Current »

This section assists you in installation of Adeptia Connect on a Windows-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

  • You can download the Adeptia Connect Installer version 3.1 from Adeptia website.

Installing Adeptia Connect

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

    For example, AdeptiaConnect_2_9_3_13Feb2019_Win_x64.



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



  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.

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



    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.

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

    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

See also

Post Installation Steps

  • No labels