Installation of Server-Side Components
Once the configuration of server-side components is done, start the installation of the components using the ae install command for both Windows and Linus based system.
NOTE: |
Before you proceed with the installation, make sure to have below mentioned information available with you:
|
To install server-side components:
As part of installation process of server-side components, perform below steps:
Running Installation Command
To perform the installation:
- For Windows: Open the command prompt with administrator rights and change the directory to AssistEdgeAutomation > scripts folder.
- For Linux: Connect with the Linux system using Putty and change the directory to the AssistEdgeAutomation > scripts folder.
- Run the ae install command to proceed with the installation. The details such as name of the components, their respective ports and other details of the server are displayed.
<Build Directory>\ ProductBuild\AssistEdgeAutomation\scripts>ae install
|
NOTE: |
|
Verifying Configuration Properties
This section enables you to verify the deployment properties, server properties and component properties that you have set in the configuration files above. If you wish to change any of the property you can exit installation and make relevant changes in the respective configuration files.
- Once you run the ae install command, Do you want to continue with Installation? (Y/N): appears. Validate the details displayed.
************************************************************************************************ Following components are marked for installation on this system.
App server: Port: 8443
NOTE: Database will not be installed by this utility.
Following configurations have been taken from 'server.properties' and will be used for installation.
|
- Do one of the following:
- Enter y to continue with the installation.
- Enter n to exit the installation if you wish to change the properties in the respective files at this stage.
The verification is done to move to the next step below.
Enabling SSL
You can choose to continue with SSL enablement at the time of installation. If you do not have the SSL certificates ready, you can continue without enabling SSL. If required, update the certificates post installation.
- Once you enter ‘y’ in the above section, Do you want to enable SSL?(Y/N): appears.
************************************************************************************************* Do you want to enable SSL?(Y/N): |
- Do one of the following:
- Enter y to continue the installation with SSL enablement. You can enable SSL by:
- Enabling commercial certificates
OR - Generating self-signed certificate
- Enabling commercial certificates
- Enter n to continue the installation without SSL enablement. You can enable the SSL once the installation is done.
- Enter y to continue the installation with SSL enablement. You can enable SSL by:
NOTE: |
Refer SSL Certificates: Post Installation section to know how to update certificates post installation. |
Enabling Commercial Certificates
To enable SSL, save the commercial certificates in AssistEdgeAutomation > data > Certificates folder and enter ‘y’, Enter AssistEdge Site Name: appears
The SSL is enabled.
NOTE: |
|
Generating Self Signed Certificate
- If you do not have commercial SSL certificates saved in the installation folder, you can proceed with the SSL enablement by generating a self-signed certificate. Do you want to generate self-signed certificate. (Y/N): appears.
************************************************************************************************* Do you want to enable SSL?(Y/N): y |
- Do one of the following:
- Enter y to generate a self-signed certificate. Self-signed certificate gets generated and is saved in the Windows Trust Store.
- Enter n to continue without generating a self-signed certificate.
The SSL is enabled.
NOTE: |
|
Providing Database Details
This section enables you to provide database details.
If you are using a different database for the Lowcode you must uncomment the Lowcode Database entry in the deployment.properties file and provide the relevant information.
- Enter details related to database as mentioned below:
- For SQL: If you are using SQL database, enter the below details:
Is the SQL Server configured for Windows Authentication? (Y/N): appears.- Enter y, if windows authentication was set for logging into the database while creating the database.
NOTE:
- SQL server with Windows authentication is not supported for the installation.
- Valid only for Lowcode in case of SQL server Windows authentication.
Create a schedule task on the Windows to execute scripts > app > manage > lowCode.bat file. Task should be executed with a user Id that has access to the database. This task should be configured to run even if the user is not logged in to the system. The current working directory while executing the lowCode.bat should be scripts folder.
For all other components use the ae start command. - For SQL server only TCP/IP network protocol is supported.
Is the SQL Server configured for Windows Authentication?(Y/N): y
Enter Domain: xyzdomian
Enter Domain Username: aeuser
Enter Domain Password (HIDDEN):
Enter Database Name: AEDB
i. Enter Domain: appears; provide the domain name of your enterprise and then press <Enter>8 .
ii. Enter Domain Username: appears; provide the windows domain username and then press <Enter>8 .
iii. Enter Domain Password <HIDDEN>: appears; provide windows password for the above domain user and then press <Enter>8
iv. Enter Database Name: appears; provide name of the database that you have configured for AssistEdge and then press <Enter>8 - Enter n, if windows authentication was not set for logging into the database while creating the database.
Is the SQL Server configured for Windows Authentication?(Y/N): n
Enter Domain: xyzdomian
Enter Domain Password (HIDDEN):
Enter Database Name: AEDB
- Enter y, if windows authentication was set for logging into the database while creating the database.
- For SQL: If you are using SQL database, enter the below details:
i. Enter Database Username: appears; provide the username of the database that you created for AssistEdge and then press <Enter>8 .
ii. Enter Database Password <HIDDEN>: appears; provide password of the above database user and then press <Enter>8 .
iii. Enter Database Name: appears; provide name of the database that you have configured for AssistEdge and then press <Enter>8
- For Oracle: If you are using Oracle database, enter the below details:
Enter Domain Username: aeuser
Enter Domain Password (HIDDEN):
Enter Oracle Database Service Name: db.ServiceName.com
i. Enter Database Username: appears; provide the username of the database that you created for AssistEdge and then press <Enter>8 .
ii. Enter Database Password: appears; provide password of the above database user and then press <Enter>8
iii. Enter Oracle Database Service Name: appears; provide service name of the Oracle database and then press <Enter>8
Database Connection Verification
Once the database details are provided, installation script verifies provided information. In case the database connection is successfully created, a success message is displayed.
In case of error, a message with error details is displayed and a confirmation message also gets displayed whether you want to continue with the installation or not. If you choose to continue, you can still update the database details post installation using the ae updatepassword command.
NOTE: |
If you are using a different database for the Lowcode you must uncomment the Lowcode Database entry in the deployment.properties file and provide the relevant information. Same details as above are required for the Lowcode database as well. |
Providing Domain Controller Details
This section enables you to provide the details related to the enterprise domain controller.
- Once you provide the relevant information above, Please provide domain name : appears. Enter the domain name of your enterprise.
NOTE:
If you do not know your domain name, execute the following command on the Windows system which is part of the intended domain:
set | findstr USERDOMAIN= - Please make sure the hostname is resolvable from the machine: appears. Enter ldap://<hostname along with the enterprise domain>. For example, ldap://hostname.ad.xyz.com.
NOTE: |
You can run the for /F "skip=1 tokens=1" %i in ('nltest /dclist:ITLINFOSYS') do @echo %ido @echo %i command in the command line utility from another command prompt as an administrator to view the list of the domain controllers. Perform the same steps for Linux based installation and note the domain controller name that you want to use. |
Domain Configuration - Default values (when available) are prefilled, press enter to accept default values. HINT: Domain Name - 1. Use the value from below command to find your current domain name set | findstr USERDOMAIN= Domain Controller - 1. You can use following command (Windows command) to get domain controller details: for /F "skip=1 tokens=1" %i in ('nltest /dclist:ITLINFOSYS') do @echo %i 2. You can use any name from the output of above command execution. 3. Please make sure the domain controller name is resolvable from the machine (use ping to validate). -----------------------------------------------------------------------------
Please provide domain name (Default: ITLINFOSYS) : Please provide domain controller name (Default: ldap://BLRKECGDC09) :
|
NOTE: |
Post installation, you can overwrite these values in the auth.yml file available in the scripts folder. |
- Do you want to continue with Installation? (Y/N): appears.
- Enter y if you wish to proceed with the same details as entered above and continue with the installation else enter n.
Do you want to continue with Installation? (Y/N): y Updating EnterprisePersonalAssistant configuration........... [SUCCESS] Updating Engage configuration........... [SUCCESS] Updating Proctor configuration........... [SUCCESS] Updating Robot SE configuration........... [SUCCESS] Updating AutomationStudio configuration........... [SUCCESS] Updating Migration Workbench configuration........... [SUCCESS] Following are the component URLs: |
All the components are configured and installed. SUCCESS message is displayed. The list of URLs of all the components are also displayed.
If you receive failure for any of the components, access AssistEdgeAutomation > scripts > install.log file. Check the errors and take appropriate action. Refer AE-RPA-Troubleshooting and AE-Engage Troubleshooting.pdf document to know about the frequently received errors.
- Enter n if you wish to change the details that you entered above.
The installation of server-side components is completed.