Modify an Ipswitch Analytics Agent

Note: To change the Agent Access Username or password, change it first in the Ipswitch Analytics interface by editing the Ipswitch Analytics Agent user. Then run Modify below to change the Agent Access Username on all machines that have Agents that send data to the Ipswitch Analytics Server.

Important: During modification of the Agent you will be required to enter the original truststore password you entered during Agent installation. If you cannot remember that original password, you must first delete the truststore file from the Agent machine you are modifying, located at c:\Program Files\Ipswitch\Analytics Agent\jre7\lib\security\ipswitchcerts before proceeding.

The machine that hosts the MOVEit database must be online and network accessible before you begin an Agent modification. You do not have to stop the MOVEit server to modify an Agent. Agent modification will not significantly affect MOVEit DMZ and Central system performance.

1. If you need to modify the Ipswitch Analytics Server IP address or hostname, first complete the following steps. Otherwise, go to step 2.
   1. Sign in on the Agent machine with administrator privileges.
   2. Go to Administrative Tools and select Services. Right-click Ipswitch Analytics Agent and select Stop to stop the Agent service.
   3. Sign in on the Ipswitch Analytics Server machine.
   4. Modify the Ipswitch Analytics Server installation to make the necessary changes to the Ipswitch Analytics Server IP address or hostname.
   5. Return to the Agent machine and then proceed with step 3 below, making sure to update the Ipswitch Analytics Server IP address or hostname during the Agent modification process.
2. Sign in on the Agent machine with administrator privileges.
3. Open Control Panel > Uninstall and select Change.

   The installer opens.

   

4. Click Next.

   Program Maintenance displays. Modify is already selected. Click Next.

   

5. Enter the Analytics Server Settings. The Agent will forward data from the MOVEit server to the Ipswitch Analytics Server that you specify here.
   • Ipswitch Analytics Server IP address or hostname: (From the Tomcat Settings) For example, if you entered https://analytics:8443/ura for Ipswitch Analytics Server URL during installation of the Ipswitch Analytics Server, enter analytics.
   • Port: By default the Ipswitch Analytics Server is configured to accept HTTPS connections on port 8443. Adhere to your IT security or other IT network policies when configuring ports.
   • Agent Access Username: Enter the username for the Agent to access the Ipswitch Analytics Server (see Installation Worksheet). This user will have the role "Ipswitch Analytics Agent" and no name or email is associated with it.
   • Agent Access Password (and confirmation): See Installation Worksheet.

   

   Click Next.

6. Enter the Analytics Agent Truststore Settings:
   • Analytics Server SSL Certificate. Browse to locate the public certificate file for the Ipswitch Analytics Server. There are two ways to locate public certificate file for the Ipswitch Analytics Server:

     On the Agent machine: Point a browser to the Ipswitch Analytics Server IP address or hostname and when prompted accept the certificate. Then go into your browser's settings to manage certificates and export the public certificate associated with the Ipswitch Analytics Server. The exported certificate must be in one of the following file formats: .pem, .cer, .crt or .der. Place the exported certificate on the Agent machine's desktop or other easily accessible location.

     On the Ipswitch Analytics Server machine: Copy c:\Program Files\Ipswitch\Analytics Server\apache-tomcat-7\certs\servercert.pem and place it on the Agent machine's desktop or other easily accessible location.

     Important: Do not use the .p12 or .pfx certificate file that you used during installation of the Ipswitch Analytics Server. If you select a certificate file that does not have the proper file format, the installation will roll back at the point when Ipswitch Analytics files install to the disk and the certificate attempts to import to the truststore.

   • Truststore password: Enter the original truststore password that you used when you first installed the Agent. If you deleted the ipswitchcerts file before beginning Agent modification, enter a new password here.

   

7. If the machine on which you are installing the Agent does not contain an installation of MOVEit Central or DMZ, select the MOVEit server type for which you are installing this Agent.

   

   Click Next.

8. Enter the MOVEit Database Settings.
   • Database Type: Select either MySQL or Microsoft SQL Server, depending on the type of database used by the MOVEit server you selected in the prior step.
   • Authentication Type (SQL Server only): Select the authentication type used for logon to the SQL Server. The currently used authentication type will be selected automatically.

     Windows: SQL Server logon will use Windows authentication. If selecting this option, username must be entered in the DOMAIN\User format.

     SQL: SQL Server logon uses a separate user/password created specifically for logon to the SQL Server database.

   • Database Name: The name of the MOVEit database. This will be pre-populated if installing the Agent on the same machine as the MOVEit server.
   • Hostname or IP Address: The location of the MOVEit database. If the MOVEit database is on the same machine as the MOVEit server, this will be localhost. If the MOVEit database and MOVEit server are on separate machines, this will be the Hostname or IP address of the machine where the database is located. If installing on a machine with no MOVEit DMZ or Central, the default database name will appear here (such as moveitdmz).

     Note: If installing the Agent on a machine that contains an SQL Server database with multiple instances on the same server, Hostname or IP Address will prepopulate with the default value used by MOVEit Central or DMZ (for example, localhost\instance1). You can also enter a different instance. If the machine does not contain MOVEit DMZ or Central, the instance name will not prepopulate but must be entered manually.

   • Port: The port used to connect with the MOVEit database. The installer suggests a port number, but you may change the port number if necessary to match the port used by the MOVEit database. This will be pre-populated if installing the Agent on the same machine as the MOVEit server. If installing on a machine with no MOVEit DMZ or Central, the default port will appear here.

     Note: If the MOVEit database is using a non-standard port number, you will need to remove the default port number shown and replace it with the non-standard port number.

   • Username and Password: The username and password that allows access to the MOVEit database. For an SQL Server database: The Authentication Type selected above will determine what user credentials you enter here. Windows authentication requires that the username be in the DOMAIN\User format.

     Tip: If you can't locate the username and password to the MOVEit database, look in c:\MOVEitDMZ_Install.INI file (DMZ) or c:\MOVEitCentral_Install.INI file (Central).

     Note: The MOVEit database password is protected using standards-based, bi-directional AES256 encryption. The MOVEit database password is entered in plaintext during the install process and is encrypted before being stored in the configuration. When establishing a connection to the MOVEit database, the password is decrypted and passed to the JDBC driver. Internally, the JDBC driver encrypts the password using a value supplied by the database server before it is transmitted to the server for authentication. The plaintext password is never transmitted or stored.

   

   Click Next.

9. Change the Agent Display Name if necessary. This name will identify this MOVEit Central server within Ipswitch Analytics. The name will appear in the Monitor dashboard and in reports. You may want to enter the MOVEit server in this name so it will be easy for users to identify data coming from this MOVEit server within the Ipswitch Analytics interface later.

   Important: Agent Display Names must be unique. If an Agent attempts to connect to the Ipswitch Analytics Server with a name that is already in use, the connection will be denied, the Agent will not appear in the Monitor dashboard, and reports will not contain any data from that Agent.

   

10. Click Next.
11. Review the modifications to the setup:

    

    Warning: If you click Install now, the modification will proceed and you will NOT be able to back out your changes even if you click Cancel on the next screen.

12. Click Install if you are happy with the installation setup, or click Back to make changes to the setup.

    After a few minutes, the modification completes.

    To view the installer log that includes detailed information about ever step of the modification process, click Show the Windows Installer log. You can also view the install log at a later point. It is located at c:\log.log.

13. Click Finish.

    Repeat these steps to modify another licensed Agent for a different MOVEit database.