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
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.
Double click install.exe, the InstallAnywhere pop-up appears preparing to install.
- After preparation is complete, installer shows an Introduction screen.
- Click Next to view End User License Agreement screen.
- Select the checkbox I accept the terms of the License Agreement.
- Click Next to view Choose Installation Folder screen.
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.
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.
- 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).
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.
If you have selected Create New Tables option, you will be prompted to overwrite all the existing tables. Click Yes to continue.
- Click Next to view Configure Log Database screen.
- Select the database you want to use for the log. Follow the details as described in Step 10 table.
- Click Next to view Configure Kernel & Web Server screen. For information on Kernel and WebRunner, refer to Components of Connect Server.
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 No Configure the port and make sure that no other application uses this port. By default, it uses port 1098. AIMap Port No Configure the port and make sure that no other application uses this port. By default, it uses port 7570. 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 Host IP 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 Host IP/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 Port HTTP 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.- 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.
- Click Next to view Configure Auto Startup (Optional) screen and do the following:
- In the Add as Windows Service group, select Connect Server and Connect Portal check boxes for configuring Kernel and WebRunner as Windows services.
- 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.
- 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.
- The installer starts installing Adeptia Connect.
- 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.
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
See also