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:

  • Details related to the database such as name of the database and so on.
  • SSL certificates from a Certificate Authority (CA) if you wish to use https.

 

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

  • Refer Run Command Prompt with Administrator Rights section to know how to run the command prompt with Administrator Rights.
  • If you do not run command prompt in admin mode, then an error “This command prompt is not running as admin” is displayed.
  • For Linux – The user performing this installation must be part of the assistEdge group.
  • For clustered setup, create a shared file directory to be accessed by all the application servers. The shared file directory is used to store configuration files, system generated files, and uploaded files. Ensure that the credentials that needs to be provided while mapping has the read and write permissions on the shared file directory. The shared file directory must be mapped using the ae nd mount or ae NetworkDrive mount command in all the application servers. 

    Copy “\data\wflow” folder to the shared file directory.

    If the mapped drive is Z: add the below setting in the ae.properties file located in AssistEdgeAutomation > scripts directory. 
    LOWCODE_SHARED_PATH=Z:\\wflow

 

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.

 

  1. Once you run the ae install  command, Do you want to continue with Installation? (Y/N): appears. Validate the details displayed. 
     

************************************************************************************************
AssistEdge Installation
************************************************************************************************

Following components are marked for installation on this system.
Please validate component and Port Numbers.
-----------------------------------------------------------------------------------------
Web server:                          Port: 8443
    Messaging                             Port: 5672
    Reporting                              Port: 5601
    ControlTower                     Port: 3860
    LowCode                               Port: 8001

 

App server:                            Port: 8443
    TxnStore                                Port: 9200
    ETL                                            Port: 9600
    ML                                             Port: 8000

 

NOTE: Database will not be installed by this utility.

 

Following configurations have been taken from 'server.properties' and will be used for installation.
Please validate the configurations:
-----------------------------------------------------------------------------------------
     _AE_MESSAGING_WEB_PORT            : 15672
    _AE_MESSAGING_EPMD_PORT         : 4369
    _AE_MESSAGING_DIST_PORT            : 25672
    _AE_MESSAGING_NODE_PREFIX     : aedevrabbitmq
    ERLANG_COOKIE_VALUE                     : RVJMQU5HX0NPT0tJRQ==
    _AE_TXNSTORE_TCP_PORT                  : 9300
    _AE_TXNSTORE_CLUSTER_NAME    : aedevelastic
    _AE_ML_PREDICTOR                                  : true
    _AE_ML_MODEL_GENERATOR           : true
    _AE_ML_QUEUE_FORECAST                : true
    _AE_LOWCODE_SERVER_PORT        : 8002
-----------------------------------------------------------------------------------------


Do you want to continue with Installation? (Y/N):
 

 

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

  1. Once you enter ‘y’ in the above section, Do you want to enable SSL?(Y/N): appears.

 

 

*************************************************************************************************
                                      Installing AssistEdge
*************************************************************************************************

Do you want to enable SSL?(Y/N):
     

 

  1. 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
    • Enter n to continue the installation without SSL enablement. You can enable the SSL once the installation is done. 

 

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: 

  • Refer SSL Certificates and Licensing Certificates section to know how to save SSL certificates in the installation folder.
  • Refer Obtain SSL Certificates section to know how to obtain the SSL certificates.


Generating Self Signed Certificate

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

 

*************************************************************************************************
                                      Installing AssistEdge
*************************************************************************************************

Do you want to enable SSL?(Y/N): y
Required certificate files are missing.
Do you want to generate self signed certificate. (Y/N)
     

 

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

  • It is recommended not to use self-signed certificates in Production and similar higher environments.
  • If you are using self-signed certificate, make sure you add root certificate to the trust store on all the systems where you are running client-tools.

 

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.

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

         

 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.

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

  2. 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 thfor /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.

 

  1. 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 RabbitMQ...........                                                                                              [SUCCESS]

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:
        ControlTower    :  https://punitp160368l:8443/ui/Admin
        TxnStore               :  https://punitp160368l:8443/ts-api
        Messaging           :  https://punitp160368l:8443/messaging-sso
        Reporting            :  https://punitp160368l:8443/reports
        LowCode             :  https://punitp160368l:8443/jw
        ETL                         :  https://punitp160368l:8443/etl
        ML                          :  https://punitp160368l:8443/ml

 

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.