If you are moving Acoustic™ Tealeaf databases to a new instance of SQL Server, complete the following steps to ensure a smooth migration.
Prerequisites
Ensure that these prerequisites are met before migrating your Acoustic Tealeaf databases.
- If you are migrating your databases, run the following SQL commands from SQL Management Studio to prepare the
tl_reports
table for migration.use tl_reports go declare @status int declare @message nvarchar(4000) declare @date datetime set @date = getdate() exec pr_LoadCalendar @date, @status output, @message output exec pr_LoadCalendarHour @date
- Stop all services that make use of the databases, except for the Portal services.
- Before you start the migration, Tealeaf services must be made aware of the change in SQL Server instances through TMS.
Only the settings that apply to your specific Tealeaf solution must be updated.
- Using TMS, navigate to the
Shared configuration information
node and update the following settings to reflect the new SQL Server environment:Database Host Name
Report Database Port
- Stop the Portal services.
Backing up the existing databases
For each Acoustic Tealeaf database, follow these steps in SQL Server Management Studio, which must be connected to the original SQL Server instance.
- Right-click the database name in Object Explorer.
- Select Tasks > Back Up....
- Under Source:
- Database:
<Database to be backed up>
- Backup type:
Full
- Backup component:
Database
- Database:
- Under Backup set:
- Name:
<Preferred backup name>
- Description:
(Optional)
- Backup set will expire:
After 0 days
- Name:
- Under Destination, remove any existing listed sets.
Note: This step does not delete the set. It just removes it from the list.
- Add a new set in a known location and with a known name. Add the
.bak
file type extension. For example:C:\tl_reports.bak
- Under Select a page, select Options.
- Select Back up to the existing media set.
- Select Overwrite all existing backup sets.
- Click OK.
The backup may take a while, depending on the size of the database.
Creating TL user accounts
Before you migrate the data to the databases, you must verify that the TLUSER
and TLADMIN
accounts were created for use with the new database. Verify and, if necessary, create the accounts in the new instances of SQL Server.
- Log in to the Report Server.
- Navigate to the following directory:
<install_directory>\Reporting
- Start the Database Manager:
TealeafDatabaseManager.exe
- Enter the connection information for the new database.
- Authentication: You must use
Windows Authentication
orSQL Server Authentication
to verify the database account. - User name and Password: Enter the credentials for the administrator account that is used to connect to the new SQL Server instance.
- Reports Host: Enter the host server of the SQL Server instance hosting the new
TL_REPORTS
database. - Port: Enter the port to use to connect. By default, this value is
1433
. - Port: Enter the port to use to connect. By default, this value is
1433
.
The Database Manager is opened.
- Authentication: You must use
- Create an user:
- From the TDM menu, select User Management > Create User.
- Enter the credentials for the
TLUSER
account. - Click OK.
The user account is created.
Note: If you receive an error message indicating that the account exists, then the account is properly configured, and you may continue with these steps. - Repeat the above steps to verify and, if necessary, create the
TLADMIN
account.
Restoring backups to the new server
For each Acoustic Tealeaf database, follow these steps in SQL Server Management Studio, which must be connected to the new SQL Server instance.
- Right-click the Databases folder in Object Explorer.
- Select Restore Database....
- Under Source for restore:
- Select From device.
- Select the ... button to the right of the From device box.
- Select Add.
- Select the backup file for the current database. In the above example, it is
C:\tl_reports.bak
. Click OK. - Click OK to return to the Restore Database window.
- Under Select the backup sets to restore, select the Restore check box to the left of the newly added backup.
- Under Destination for restore, from the To database drop-down, select the name of the current database.
- Under Select a page, select Options.
- Select the check box next to Overwrite the existing database.
- Under Restore the database files as, update the filegroups to reflect your filegroup paths.
- Select Leave the database ready to use by rolling back uncommitted transactions.
- Click OK.
Repairing users
After restoring the database, SQL Server logins must be updated for the Acoustic Tealeaf databases.
The local definitions for user accounts must be updated to point to the new server hosting the databases. You can repair these user accounts through the Database Manager.
This command can be run multiple times without issues.
- On the Report server, navigate to the following directory.
<install_directory>\Reporting
- Launch
TealeafDatabaseManager.exe
. - Connect to the databases.
- The Database Manager is displayed.
- From the Database Manager menu, select Mode > User Management > Repair Users.
- To repair the
TLADMIN
andTLUSER
accounts used to access each of your Tealeaf databases, click OK.