Installation of Server-Side Components

Once configuration files are updated, start installation using the ae install command.

Flow for installing server-side components:

 

NOTE:

Before you proceed with the installation, make sure to have below mentioned information available with you: If database will be created, credential details of the Admin user of the database instance. If database is already created, database name and AssistEdge database user credentials. SSL certificates from a Certificate Authority (CA) if you wish to use https.

 

Flow for installing server-side components:

 

 

To install server-side components:

As part of installation process of server-side components, perform below steps:

• Run Installation Command
• Verifying Configuration Properties
• Provide SSL Details
• Provide Database Details
• Provide Domain Controller Details

 

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:

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

 

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

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

 

Provide SSL Details

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.

 

Flow for Providing SSL Details:

 

 

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

 

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

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

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

 

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

 

Provide Database Details

This section enables you to provide database details.

 

NOTE:

If the LowCode Database entry in the deployment.properties file is uncommented, then the user will be prompted to provide details of LowCode database.

 

Flow for Providing Database Details:

 

1. Enter details related to database as mentioned below:
   • Do you want to create database? (Y/N): appears 
     
     If you want to create database, then you will have to provide Database Admin user credentials.
      

     NOTE:

     For Oracle: Database tablespace name is also required.

      

     If Database admin user is a Windows User, then provide username in format domain ame\username Please provide database admin username : XYX\User name Please provide database admin passowrd  (HIDDEN):

      
     • Enter Y, if you want to create database.
       • Please provide database admin username: appears; provide the name of the System Admin user (or username having database creation privileges) then press <Enter>8  .
       • Please provide database admin password: appears; provide the password for the above System Admin user and then press <Enter>8 .
     • Enter N, if you don’t want to create the database.
       • Do you want to create objects in existing database? (Y/N): appears,
         • Enter Y, if you want to create objects in existing database and then provide AssistEdge database credentials.
         • Enter N, if you don’t want to create objects in the existing database 
8. Enter details related to database creation as mentioned below:
   • For SQL: If you are using SQL database, enter the below details: 
      

     Enter Database Username: user name Enter Database Password (HIDDEN): Enter Database Name: db name

      
     • Enter Database Username: appears; provide the username of the database for AssistEdge and then press <Enter>8  .
     • Enter Database Password <HIDDEN>: appears; provide password of the above database user and then press<Enter>8  .
     • Enter Database Name: appears; provide name of the database for AssistEdge and then press<Enter>8  .
        

       NOTE:

       SQL server with Windows authentication is not supported for the Linux based installation. For SQL server only, TCP/IP network protocol is supported. If the LowCode database user is a Windows Authenticated user, then follow below steps to start LowCode: 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. The execution of batch file requires sql jdbc driver. Refer AE-RPA-Client Downloadable Software document to download and place the sql jdbc driver. For all other components use the ae start command.

   • 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

      
     • Enter Database Username: appears; provide the username of the database for AssistEdge and then press <Enter>8   
     • Enter Database Password <HIDDEN>: appears; provide password of the above database user and then press <Enter>8   .
     • Enter Oracle Database Service Name: appears; provide service name of the Oracle database and then press <Enter>8   .
        

       Database connection created.

        

       NOTE:

       The below script execution message will appear only when the user has opted for creating the database or creating the objects in the existing database.

        

       Executing script: dropTable.sql Executing script: createTable.sql Executing script: createIndex.sql Executing script: seedData.sql Executing script: insertDateDimData.sql Executing script: createConstraint.sql Executing script: trigger.sql Executing script: lowcode.sql Executing script: quartz.sql Database connection success.

Database Connection Verification

• Database connection created and Database connection success. appears: If the database connection is successfully created, a success message is displayed. 
• Error connecting DB. appears: If the database connection is not created, a message with error details is displayed and a confirmation message also gets displayed whether you want to continue with the installation or not.
   

  NOTE:

  The Database details can also be added after the installation by running ae updatepassword command.

Providing Super Admin Details

You can add a user as super admin. This user will be able to access the AssistEdge Admin Module post installation and subsequently add other users.

1. Enter details related to user as mentioned below:
      
   • Do you want to add Super Admin user? (Y/N): appears 
     • Enter Y, if you want the user to be super Admin.

       Please provide First name : XYZ Please provide Last name : WQS Please provide Email id : WYZ.WQS@SOANDSO.com Please provide Unique id : XYZ.WQS

        
       • Please provide First name : appears; provide the first name for the AssistEdge Admin user and then press <Enter>8   .
       • Please provide Last name : appears; provide the second name for the AssistEdge Admin user and then press <Enter>8   .
       • Please provide Email id : appears; provide the Email ID for the AssistEdge Admin user and then press <Enter>8   .
       • Please provide Unique id : appears; provide the Unique ID for the AssistEdge Admin user and then press <Enter>8   .
         
         User added to database: appears.
     • Enter N, if you don’t want the user to be super Admin.
        

       NOTE:

       The Super Admin user can also be added after the installation by running ae addsuperadmin command.

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=

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

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

   Do you want to continue with Installation? (Y/N): Y Updating RabbitMQ...........                                                                                       [SUCCESS] Updating Migration Workbench configuration...........                               [SUCCESS] Reference component URLs as follows:         ControlTower     :  http://evosedgew523:8443/ui/Admin         TxnStore                :  http://evosedgew523:8443/ts-api        Messaging            :  http://evosedgew523:8443/messaging-sso         Reporting              :  http://evosedgew523:8443/reports         LowCode               :  http://evosedgew523:8443/jw    ETL                           :  http://evosedgew523:8443/etl  ML                            :  http://evosedgew523:8443/ml

    
   • Enter Y, if you wish to proceed with the same details as entered above and continue with the installation else enter N. 
     
     All the components are configured and installed. SUCCESS message is displayed. The list of URLs of all the components is  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.pdf and AE-Engage Troubleshooting.pdf documentsto know about the frequently received errors.
   • Enter N if you wish to change the details that you entered above.