Installing on Windows

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.6 from Adeptia website.

If you are using Oracle pluggable database as the Backend and Log database, click here for detailed instructions.

Installing Adeptia Connect

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.
Double click install.exe, the InstallAnywhere pop-up appears.
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 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.exe -DConfigureDBviaURL=true.
The InstallAnywhere pop-up appears telling you the progress status of installation.
Perform the steps from 2 through 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 in the first table of step 10.
Click Next.

If you are using Oracle pluggable database as the Backend and Log database then follow the steps below:

Go to the directory where you extracted the zip file.
Type the command ./install.exe -DConfigureDBviaURL=true.
The InstallAnywhere pop-up appears telling you the progress status of installation.
Perform the steps from 2 through 9 and click Next to view Configure Backend Database screen.
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.
Provide the value of each fields as explained above in the first table of step 10.
Click Next.

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