You must install the Ipswitch Analytics Server before installing an Agent. Install an Agent for each MOVEit database that you want to include in the Ipswitch Analytics environment. Install only one Agent per machine. It is recommended that you install an Agent on the machine that hosts the MOVEit database, but you may also install it on any machine that has network connectivity with the MOVEit database. See Sample Installation Configurations for help deciding where to install the Agent in your existing MOVEit system. Ipswitch Analytics does not support environments where MOVEit DMZ and MOVEit Central are installed on the same machine.
Each Ipswitch Analytics Agent uses one license. The standard Ipswitch Analytics package comes with two Agent licenses. To add another MOVEit server to the Ipswitch Analytics system later, simply install another Agent and purchase an add-on Agent license. Please visit How to Buy to purchase add-on Agent licenses.
The machine that hosts the MOVEit database must be online and network accessible before you begin an Agent installation. You do not have to stop the MOVEit server to install an Agent. Agent installation will not significantly affect MOVEit DMZ and Central system performance.
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.
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.
Download the appropriate Ipswitch Analytics Agent install file:
64-bit: Ipswitch_Analytics_Agent64_v1.exe
32-bit: Ipswitch_Analytics_Agent32_v1.exe
Open the Ipswitch Analytics Agent installation file. Click Next.
Read the License Agreement and accept the terms. Click Next.
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.
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.
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 passwordfor the certificate. Write down this password and keep it safe. You will need it if you ever plan 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.
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.
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.
Tip: If the connection to the database fails, check that your firewall is open.
Enter the Analytics Agent Settings.
Agent Display Name: Enter a name that will identify this MOVEit server within Ipswitch Analytics. This name will appear in the Monitor dashboard and in reports. You may want to use the name of the MOVEit server so it will be easy for users to recognize data coming from this MOVEit server within the Ipswitch Analytics interface.
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.
Note: You may want some MOVEit servers to include historical data but not others. Each Agent is a separate installation so you can select a different option here for each MOVEit agent.
Click Next.
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.
Click Finish to complete the install.
Installation of the 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.
Repeat these steps if necessary to install another licensed Agent for a different MOVEit database.
Note: If you opted to include historical data during Agent installation, it may take the Agent a few minutes to a few hours to retrieve that historical data and send it to the Ipswitch Analytics Server, depending on the amount of data in the MOVEit database. During this time, the MOVEit server will continue to be operational and you can begin using Ipswitch Analytics, but since the data capture is a trickle process, you will not see all historical data until the historical data capture process is complete. You will not be notified when the Agent finishes pulling all historical data, but you can verify that the historical data capture process is complete by running a report for a time range in the past.
