Step 4: Install an Analytics Agent

For MOVEit Central Legacy Failover Environments: See Install Analytics Agents in Legacy Failover Environments.

Install an Agent for each MOVEit database that you want to include in the Ipswitch Analytics environment. Install only one Agent per machine.

Prerequisites	The Ipswitch Analytics Server must be installed before you install an agent. The machine that hosts the MOVEit database must be online and network accessible.
Recommended configuration	Install the agent on the machine that hosts the MOVEit database.
Alternative configurations	The agent can be installed on any machine that has network connectivity with the MOVEit database. For more information, see Installation Configurations.
Number of Licenses	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 at a later time, install another Agent and purchase an add-on Agent license. For more information, see How to Buy.
Other information	It is not necessary to stop the MOVEit server to install an Agent, because the installation process does not significantly affect MOVEit DMZ or MOVEit Central system performance.

To install an Analytics Agent:

On the machine where you want to install the Agent, sign in with an account that has administrator privileges.
Recommended: Install the Agent on the machine that hosts the MOVEit database.
Download the appropriate Ipswitch Analytics Agent installation file, where n is the release number:
- 64-bit: Ipswitch_Analytics_Agent64_vn.exe
- 32-bit: Ipswitch_Analytics_Agent32_vn.exe
Open the Ipswitch Analytics Agent installation file. The Welcome page appears. Click Next.
Accept the License Agreement. Click Next.
Select a Destination Folder.
Caution: Do not specify a destination on the desktop. desktop.Click Next.
Enter the Analytics Server Settings. The Agent forwards 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: The port on which the Ipswitch Analytics Server accepts HTTPS connections. Default is 8443. Adhere to your IT security or other IT network policies when configuring ports.
- Agent Access Username: The username that the Agent uses to authenticate with the Ipswitch Analytics server. You specified this username during the Ipswitch Analytics server installation. See the Installation Worksheet.
- Agent Access Password: See the Installation Worksheet.
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 that is used for logon to the SQL Server.
  Windows: SQL Server logon will use Windows authentication. If you select 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. If you are installing the Agent on the same machine as the MOVEit server, this field is pre-populated.
- Hostname or IP Address: The location of the MOVEit database. The value you specify depends on your configuration:
  - If the MOVEit database is on the same machine as the MOVEit server, value is localhost.
  - If the MOVEit database and MOVEit server are on separate machines, the value is the Hostname or IP address of the machine where the database is located.
    Note: If you are installing the Agent on a machine that contains an SQL Server database with multiple instances on the same server, the Hostname or IP Address field prepopulates with the default value used by MOVEit Central or DMZ (for example, localhost\instance1). You can enter a different instance. If the machine does not contain MOVEit DMZ or Central, you must enter the instance name manually.
  - If you are installing the Agent on a machine that does not have MOVEit DMZ or Central, the default database name appears here (for example, moveitdmz).
- Port: The port that is used to connect with the MOVEit database. Default is the default port value for MSSQL/MySQL.
  Note: If the MOVEit database is using a non-standard port number, you must remove the default port number 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 you selected in a previous step determines what user credentials you enter here. Windows authentication requires that the username be in the DOMAIN\User format.
  
  Tip: If you cannot locate the username and password to the MOVEit database, look in C:\MOVEitDMZ_Install.INI file (DMZ) or C:\MOVEitCentral_Install.INI file (Central).
Click Next.
Tip: If the connection to the database fails, make sure that your firewall is open.
Enter the Analytics Agent Settings.
- Agent Display Name: Enter a name to identify this MOVEit server within Ipswitch Analytics. The name will appear in the Monitor dashboard and in reports.
  Tip: Use the MOVEit Central name in the Agent Display Name so that in the Ipswitch Analytics interface, users can identify data that comes from this MOVEit server.
- Is this a new or existing agent? Select an option:
  - Installing a new agent with a new name: The Agent Display Name must be unique.
  - Installing an agent already known to Analytics Server: Use this option if an agent with this display name was previously installed on this MOVEit Central or MOVEit DMZ server, and was later removed. If you install a new agent on the same server, you can use the same name as the "old" agent.
- Would you like to include historical data? This will import all current data from this MOVEit server:
  - Yes: Ipswitch Analytics includes all historical data from this MOVEit server.
  - No: Ipswitch Analytics reports include data from this time forward only, and does include any past data from this MOVEit server.
  See the subsection About historical data, below.
  
  Tip: This selection pertains only to the agent you are currently installing and its corresponding server. You might want some servers to include historical data but not others. You can select a different option when you install other agents.
Click Next.

Tip: If the connection to the database fails, check that your firewall is open.
Review the installation setup, and then click Install.
Note: If you click Cancel, the installation stops, but the Agent installation folder remains in the installation directory you selected. You can safely delete the Analytics Agent directory to remove any files that remain after an interruption of the installation process.

To view the installer log after the installation finishes, select the checkbox.

To view the log at another time: the log is located in a temp directory in the user's AppData folder. For example, C:\Users\Administrator\AppData\Local\Temp\n\MSIstring.log (where n is a number, and string is an alphanumeric string).
Click Finish.
The Ipswitch Analytics Agent service is now running on this machine and immediately starts to report data to the Ipswitch Analytics Server. To disconnect this Agent, see Licensing in the Ipswitch Analytics Administrator's Guide.

To install another licensed Agent for a different MOVEit database, repeat this procedure (Step 4: Install an Analytics Agent).

About Historical Data

If during the Agent installation, you chose to include historical data, it might take some time (a few minutes to a few hours) to retrieve the historical data and send it to the Ipswitch Analytics server. While the data is being captured, the MOVE it server continues to operate, and you can use Ipswitch Analytics. However, because data capture is a "trickle" process, some historical data cannot be viewed until the data capture process is complete. You are not notified when the Agent finishes including all historical data. To verify that the historical data capture process is complete, run a report for a time range in the past.

If you have a large number (more than 10) Analytics Agents to be connected to the Analytics Server, the server might face heavy data volume from the agents if they all feed historical data at the same time. To make the initial data loading process run more smoothly, start the agents by smaller groups of 10 agents. Start the second group after the first group has finished loading historical data. After the historical data is loaded, the data volume returns to normal levels and all agents can stay up. Users can then start to use the Analytics Server.

Next: Step 5: Verify Agent Functionality