Install a Primary Agent

1. Retrieve the public certificate file for the Ipswitch Analytics Server. There are two ways to do this:
   • On the Agent machine: Point a browser to the Ipswitch Analytics Server IP address or hostname and accept the certificate. 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 easily accessible file 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.
2. Sign in to a machine where you want to install the Agent using an account with administrator privileges. It is recommended that you install the Agent on the machine that hosts the MOVEit database. In some cases, this is also the machine that hosts the MOVEit DMZ or Central server.
3. Download the appropriate Ipswitch Analytics Agent install file:
   • 64-bit: Ipswitch_Analytics_Agent64_v1.exe
   • 32-bit: Ipswitch_Analytics_Agent32_v1.exe
4. Open the Ipswitch Analytics Agent installation file. Click Next.

   

5. Read the License Agreement and accept the terms. Click Next.
6. Select a Destination Folder. By default, the Agent installs into c:\Program Files\Ipswitch\Analytics Agent. Click Change... to select a different directory. Click Next.
7. 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.

8. Enter the Analytics Agent Truststore Settings:
   • Analytics Server public certificate file: Browse to select the public certificate file that you located in the first step of the Agent installation. It will have the extension .pem, .cer, .crt, or .der.
   • Truststore password: Enter the truststore password for the certificate. Write down this password and keep it safe. You will need when you install an Agent for the secondary failover HA database, and if you ever have to modify the Agent installation.

   The installer will create the ‘ipswitchcerts’ truststore in /jre/lib/security.

   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.

   

   Click Next.

9. If the machine on which you are installing the Agent does not contain an installation of MOVEit Central or DMZ, select MOVEit Central from the drop-down menu:

   

   Click Next.

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

      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.
    • Hostname or IP Address: The location of the MOVEit primary database. If it is on the same machine as the MOVEit server, this will be localhost. If the MOVEit primary database and MOVEit server are on separate machines, this will be the hostname or IP address of the machine where the primary database is located. If installing on a machine that does not contain MOVEit Central, the default database name will appear here (such as micstats).

      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 (for example, localhost\instance1). You can also enter a different instance. If the machine does not contain MOVEit Central, the instance name will not prepopulate but must be entered manually.

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

      Note: If the MOVEit primary 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 primary database. If the primary database is 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.
    • Password: The password required to sign in with the username above.

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

      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.

    Tip: If the connection to the database fails, check that your firewall is open.

11. Enter the Analytics Agent Settings.
    • Agent Display Name: Enter a name that will identify this MOVEit Central server within Ipswitch Analytics. This name will appear in the Monitor dashboard and in reports. You may want to enter the MOVEit Central name in this name so it will be easy for users to identify data coming from this MOVEit server within the Ipswitch Analytics interface later.
    • Is this a new or existing agent? Select an option:
      • Installing a new agent with a new name: The Agent Display Name has never been registered with the Ipswitch Analytics Server before. Agent display name must not be a repeat of an existing Agent Display Name on the Ipswitch Analytics Server.
      • Installing an agent already known to Analytics Server: An Agent was previously installed and registered with the same name and you want to use that Agent's name. Agent Display Name will be the same as the original Agent Display Name.

        Note: If this Agent is already known to the Analytics Server, you must install it on the same type of MOVEit server. For example, if the Agent was installed on a MOVEit Central server in the past and you wish to reuse the Agent Display Name, you must install it on a MOVEit Central server again.

    • Do you want to include historical data that already exists on the MOVEit server?
      • Include Historical Data: Ipswitch Analytics will include historical data from this MOVEit server.

        Start with current data: Ipswitch Analytics reports will include data from this point forward only, and will not include any past data from this MOVEit server.

    

    Click Next.

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

    

    Note: If you click Cancel now, the install stops but the Agent installation folder will remain in the install directory you selected. You can safely delete the Analytics Agent directory to remove any files that linger after an interruption of the install process.

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

13. Click Finish to complete the install.

    

    Installation of the primary Agent is complete. The Ipswitch Analytics Agent service is now running on this machine and will immediately begin reporting data to the Ipswitch Analytics Server. To disconnect this Agent, see Licensing in the Ipswitch Analytics Administrator's Guide.

Next, Install an Secondary Agent