KBI 310522 How To Migrate The Argent Reports Database To A New Server

Version

Argent Reports 1501-D or above

Date

Wednesday, 17 Dec 2014

Summary

Customers migrating the Argent Reports database to a new server need a way to tell Argent Reports about the change.

Argent Reports stores the ODBC connection string as encrypted data in the ARGSOFT_CONFIGURATION.XML file.

The Argent Reports Configuration Tool currently only supports changing the Argent AT configuration details.

To change the Argent Reports database pointer, Argent Reports 1501-D adds a new XML feature:

<ARGENT_REPORTS_ODBC_STRING_PLAIN>

This new XML node can be added below the existing ARGENT_REPORTS_ODBC_STRING XML node, but with the ODBC string in plain-text.

Technical Background

Updating Argent Reports

1. Backup, then edit {Drive:}\Argent\ArgentReports\XML\ARGSOFT_CONFIGURATION.XML

2. Add the following XML entry below the ARGENT_REPORTS_ODBC_STRING XML entry, replacing ‘MY_SERVER’ and ‘ARGENT_REPORTS’ with the relevant information:

<ARGENT_REPORTS_ODBC_STRING_PLAIN VALUE=”Driver={SQL Server};Server=MY_SERVER;Database=ARGENT_REPORTS;” />

3. Launch Argent Reports

4. If successful, the LOG file should show these log entries:

Status………………. ‘FOUND ARGENT_REPORTS_ODBC_STRING_PLAIN’

Status………………. ‘USING ARGENT_REPORTS_ODBC_STRING_PLAIN’

String………………. ‘Driver={SQL Server};Server=ARGENT-MC2;Database=ARGENT_REPORTS;’

Updating the Argent Reports Scheduling Service

In the {Drive:}\Argent\ArgentReports folder, there is a subfolder called Scheduler, and a subfolder within it called CONTROL

Inside there is a file called COMMON_DATABASE_INPUT.TXT

The Scheduler Service does NOT read off the XML, it uses this private database configuration file instead

1. Stop the Argent Reports Scheduling Service and ensure the ARGSOFT_ARGENT_REPORTS_CDP* process is killed.

2. Modify the COMMON_DATABASE_INPUT.TXT file for the [DATABASE_SERVER_NAME] and [DATABASE] to match the new changes

3. Save the changes

4. Start the Argent Reports Scheduling Service service.

Resolution

Argent is working on a more intuitive point-and-click method to migrate the Argent Reports database.