The Uptime Infrastructure Monitor DataStore can run on a Microsoft SQL Server database to leverage existing SQL Server installations and take advantage of SQL Server's advanced replication, recovery and archiving options. This article assumes that you have already installed Uptime Infrastructure Monitor and have a SQL Server database available. For more information,  see Supported databases in Uptime Infrastructure Monitor.

Step 1: Preparing your MS SQL Database

To run UIM with a SQL Server database, first create a database on your SQL Server default instance that UIM will be able to use. If you are unsure which databases are available to you or how to create a new database, please contact your database administrator and have a database configured for UIM.

Within the SQL Server database that will hold UIM configuration and historical data, create a user account that UIM will use to access the database. The settings that you define for the UIM database user are generally flexible with the following exceptions:

  • The UIM user must be the owner of the database that UIM will use.
  • The UIM user must allow SQL authentication (Windows authentication is not currently available).

The SQL Server database should not be on the same system as the UIM monitoring station.

Step 2: Configuring UIM

After you have created the SQL Server database and set up the UIM database, you need to configure UIM to access the new database. This involves editing these two configuration files (replace <uptime_dir> with the directory of your UIM install):

<uptime_dir>\uptime.conf
<uptime_dir>\controller\resources\uptime_controller.conf

Starting with the uptime.conf file, add a # character at the beginning of each of the following lines to comment them out:

dbDriver=com.mysql.jdbc.Driver 
dbType=mysql 
dbHostname=localhost 
dbPort=3308
dbName=uptime 
dbUsername=uptime 
dbPassword=uptime

Just below the lines listed above, there is a second group of lines in the uptime.conf file that define how UIM will connect to a SQL Server database (see below). Remove the # character from the beginning of these lines and update the dbHost, dbPort, dbName, dbUsername and dbPassword to match the settings of your SQL Server database and the user that you created in Step 1.

#dbDriver=net.sourceforge.jtds.jdbc.Driver 
#dbType=mssql
#dbHostname=10.1.1.124 
#dbPort=1433 
#dbName=uptime 
#dbUsername=uptime 
#dbPassword=password

Next you will need to modify the up.time Controller service configuration file in the same manner. This service provides UIM with API services and is an ingress point for most of the Gadgets in the Dashboards. Update the <uptime_dir>\controller\resources\uptime_controller.conf file just as you did the uptime.conf file, commenting out the MySQL configuration lines, un-commenting the MS SQL related lines and editing them with the appropriate configuration and credential info. 

Step 3: Resetting the UIM DataStore

Reset the up.time DataStore settings to create the tables and default values required by UIM on your SQL Server database. Make sure the "up.time Data Collector" and "up.time Controller" services are stopped before run the following command on your UIM monitoring station:

This command will reset any existing Uptime Infrastructure Monitor-specific database settings. Before running this command, ensure that the settings in the uptime.conf file are correct.

<uptime_dir>\resetdb really

Step 4: Restarting UIM

After the resetdb utility has finished updating your database settings, start the "up.time Data Collector" and "up.time Controller" services. When Uptime Infrastructure Monitor starts, it will be running from your SQL Server database with an empty Uptime Infrastructure Monitor installation.

Step 5: Disabling the UIM DataStore service

Now that UIM is successfully started and running from your MS SQL database, we no longer need to have the local MySQL datastore, which means that we can disable the unneeded service to free up some resources on the monitoring station itself.

This is done via the Window Services tool typically found in the Administrator Tools section of the Start menu or from within Computer/Server Management. You'll first want to locate and stop the 'up.time Data Store' service. Once the service is stopped, you'll need to right click on the service name, and select Properties from the context menu. On the general tab of the window that opens, you should see a drop down menu for Startup type that currently shows Automatic. You'll want to change this option to Disabled , and then click OK to save your changes.

  • No labels