8.5

Edit

Platform Monitor for RPA - Installation

Install Platform Monitor for RPA

Platform Monitor is installed with RPA. But it requires additional configuration

Installation should go through the following steps:

  • Select installation type as described in Platform Monitor for RPA - Architecture
  • Check all prerequisites for deployment
  • Configure Platform Monitor for RPA
  • Configure RDP settings for "RDP-in-RDP" installation type
  • Start Platform Monitor manually
  • Validate installation
  • Configure RPA service startup after login
  • Configure Active session recovery after reboot

Select installation type

Currently the following installation types are supported

  • 1 RPA Bot per server (VDI)
  • Multiple RPA Bot's per server (RDP-in-RDP)

Make sure deployed RPA configuration matches these requirements. Platform Monitor might not work properly under non-standard deployments.

  • There is 1 RPA Hub process per server.
  • All RPA Node processes are running on the same server as RPA Hub.

Prerequisites for deployment

Firewall

  • Open a connection from APM Server to RPA Server on 10000-10010 ports.
  • Open a connection from RPA Server to APM Server on 10101 port (this might be customized during installation).
  • APM host is accessible to users via HTTP on 10101 port.

APM Linux instance

  • Platform Monitor is installed
  • 2 packages need to be installed: rdesktop, Xvfb. If Xvfb is not available, check alternatives from your subscribed repositories. This is required only for RPA Active session recovery after reboot and is not mandatory.

RPA Server Windows instance

  1. There should be a separate Windows user for each RPA Bot.

  2. There should be a separate Windows user for RPA Hub session in case of the Multiple RPA Bot's per server (RDP-in-RDP) installation type.

    Local user provisioning:

    net user Hub Test123 /add
net user Node1 Test123 /add
net user Node2 Test123 /add

net localgroup "Remote Desktop Users" Hub /add
net localgroup "Remote Desktop Users" Node1 /add
net localgroup "Remote Desktop Users" Node2 /add

  3. Add RPA full folder premissions to all created users (Hub, NodeX).

  4. A Hub user should be a member of the Administrator group.

Configure Platform Monitor for RPA

Edit C:/RPA/wfagent/conf/environment.yml (from 8.4.3) or C:/RPA/wfagent/environment.yml and update three properties

pm_hostname: localhost                    # Modify to hostname of Platform Monitor (APM). Required. Example: apmhostname.server.com
pm_port: 10101                              # Modify port number of Platform Monitor (APM). Optional if not modified during installation. Required only for ssl. Example: 13101 
pm_scheme: http                             # Modify protocol of Platform Monitor (APM). Optional if not modified during installation. Example: https
pm_path_context: "/_agent"                # Modify context path of Platform Monitor (APM). Optional if not modified during installation. Example: "/_monitor"
pm_user: ENC(Y9OMveSzAbN4yObOxme27g==)      # Modify username of Platform Monitor (APM). Optional if not modified during installation. Example: user
pm_password: ENC(0wdRxRSaEMrYAykPH46A1Q==)  # Modify password of Platform Monitor (APM). Optional if not modified during installation. Example: password
agent.hostname: localhost                   # Modify to hostname where current Windows session will be running. This hostname should be resolvable from APM server. Example: rpa-1-hostname.server.com
comments
  • Ansible default username and password for Platform Monitor are synchronized with environment.yml from the RPA installation.
  • If you want to update username and password for Platform Monitor in the environment.yml file you should update secutiry storage (Vault) too.

Configure RDP settings

important

Required only for the RDP-in-RDP installation type.

RPA packages comes with bundled wfagent directory where you can find two RDP client connection files:

  • nodeX.RDP: connection to local RDP with RPA Node #X

Open these files and perform the following actions:

  1. Run RDP client using nodeX.RDP.

  2. Make sure you save credentials for this connection.

  3. Open connection and mark all checkboxes to prevent any undesired dialogs in future.

  4. Make sure you are connected to RDP.

  5. Disconnect and open connection again. There should be no warning messages during initial connection or inside RDP session. They will disrupt any automatic session logon.

Schedule Platform Monitor startup on logon

Task scheduling can be performed using task scheduler or advanced group policies. Use the method below only if you don't have any other standard way to schedule tasks for users.

  • VDI Deployment type: Two tasks are required for single VDI user.
SchTasks /Create /SC onlogon /TN "wfagent-hub" /TR "C:\RPA\wfagent\bin\wfagent-hub-nordp.bat" /RU Hub /IT /F

SchTasks /Create /SC onlogon /TN "wfagent-node0" /TR "C:\RPA\wfagent\bin\wfagent-node0.bat" /RU Hub /IT /F
  • RDP-in-RDP deployment type. Three tasks are required. One for Hub user and one for each Node user:
SchTasks /Create /SC onlogon /TN "wfagent-hub" /TR "C:\RPA\wfagent\bin\wfagent-hub.bat" /RU Hub /IT /F

SchTasks /Create /SC onlogon /TN "wfagent-node0" /TR "C:\RPA\wfagent\bin\wfagent-node0.bat" /RU Node1 /IT /F
SchTasks /Create /SC onlogon /TN "wfagent-node1" /TR "C:\RPA\wfagent\bin\wfagent-node1.bat" /RU Node2 /IT /F

Platform Monitor for RPA

Configuration of RPA manager is also related to configuration of RPA Hubs.

To allow RPA Hub autostart, provide correct credentials to Platform Monitor at PM host:

  1. Gain shell access to PM host.

  2. Switch to the <install_dir>/wfagent/settings directory.

  3. Modify template settings at rpa.yml and provide settings under credentials id, user, password:

    rpa.yml:

    # replace credentials
  credentials:
    - id: rpahostname1                  # Put RPA server public host. Required. Example: rpa.hostname.server.com
      user: user                        # Put RPA server RDP username. Required. Example: user
      password: password                # Put RPA server RDP password. Required. Example: password

  4. Restart WF Agent:

    wfmanager restart wfagent

Update RPA Platform monitor keystore if APM server has SSL

RPA Platform monitor doesn't support SSL but APM server support SSL cause' need to update RPA Platform monitor keystore.

  1. Download root certificate from APM server URL is like that "http://dns_host:port/CA.crt" where:

    dns_host is host of APM server 
port which is set during install. Default is 8080

    You might download via the powershell command:

    Invoke-WebRequest -Uri "http://dns_host:port/CA.crt" -Outfile "ca.crt"

  2. Find the RPA Java path, for example, C:/RPA/java:

  3. Go to the bin directory, for example, C:/RPA/java/bin:

  4. Import the downloaded ca.crt to the RPA Java keystore.

  5. Run this command with your arguments from the C:/RPA/java/bin directory:

    keytool -import -alias APM -file "path/to/ca.crt" -keystore "path/to/cacerts" -storepass changeit

    where:

    path/to/ca.crt is absolute path to downloaded ca.crt, for example, "C:\\ca.crt"
path/to/cacerts is absolute path to default RPA java keystore, for example, "C:\\RPA\java\jre\lib\security\cacerts"
changeit default password for RPA java keystore

Multiple RDP sessions on Windows Server

  1. Connect to Windows Server.
  2. Navigate to Server Manager > Manage > Add Roles and features > Next > Next > Next > Select Remote Desktop Services > Next > Select Remote desktop session Host > Finish > Next > Select Remote desktop session Host > Finish.
  3. Add Features.
  4. Click Next > Finish.

Start Platform Monitor manually

RPA Bot per server (VDI)

  1. Run C:/RPA/wfagent/bin/wfagent-hub-nordp.bat.
  2. Run C:/RPA/wfagent/bin/wfagent-node0.bat.

Multiple RPA Bot's per server (RDP-in-RDP)

Run C:/RPA/wfagent/bin/wfagent-hub.bat. All RPA Bots should start automatically.

Use Platform Monitor for RPA

  1. Make sure that RPA processes (like Nginx, Hub, Node) are not started manually. Stop everything before launching Platform Monitor.
  2. Launch Platform Monitor. It should start all configured processes (Nginx, RPA Hub, local RDP Connections, RPA Nodes).
  3. All process control can be done via the Platform Monitor UI. Navigate to Processes or Bot Manager.
← PreviousNext →