How to move the BlackBerry Configuration Database to a new Microsoft SQL Server instance Overview The BlackBerry Enterprise Server services must be stopped during the process described in this article.
Important: Restarting certain BlackBerry Enterprise Server services will delay email message delivery to BlackBerry smartphones. For more information, see
http://www.blackberry.com/btsc/KB04789.
To move the BlackBerry Configuration Database to a new Microsoft SQL Server instance, complete the following tasks:
Note: In a Microsoft Exchange environment, complete the tasks using the BlackBerry Enterprise Server service account unless otherwise stated.
1. Back up the BlackBerry Configuration Database.
2. Prepare the new Microsoft SQL Server.
3. Restore the BlackBerry Configuration Database.
4. Configure the BlackBerry Enterprise Server.
Task 1 - Back up the BlackBerry Configuration Database
To back up the BlackBerry Configuration Database, complete the appropriate steps for the environment:
Microsoft SQL Server 2000 or 2005
1. Open Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005).
2. Right-click the BlackBerry Configuration Database (for example, BESMgmt).
3. Select Backup Database.
4. Click Add to specify the Directory Name and File Name.
5. Click OK to accept the settings.
6. Click OK again to start the backup process.
7. Close Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005) when the process is complete.
Microsoft SQL Server Desktop Engine (MSDE)
1. From a command prompt, type osql -E and press Enter.
Note: If logging in to a named instance of the Microsoft SQL Server, use the following command syntax to log in:
osql -E -S \
2. Type the following commands in the specified order:
1 > backup database to disk = "C:\.bak"
2 > go
1 > quit
3. Close the command prompt.
Task 2 - Prepare the new Microsoft SQL Server
To prepare the Microsoft SQL Server, complete the following steps:
Step 1
Depending on the environment, assign the appropriate permissions.
Note: Complete this task using an account with administrator access to the new Microsoft SQL Server. Microsoft SQL Server 2005 requires the following server role permissions: System Administrator, Database Creator.
Microsoft SQL Server 2000 or 2005
1. Open Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005).
2. Go to Microsoft Server Group >
Security. 3. Right-click Logins and select New Login. 4. From the General tab, click the double quotation marks ( "" ) button. 5. From the Global Address List, select the name of the BlackBerry Enterprise Server service account. 6. Click Add, then click OK. 7. On the Server Roles tab, select Server Administrators and Database Creators. Note: In BlackBerry Enterprise Server software version 4.1, the System Administrator role is needed for role-based administration. 8. Close Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005). MSDE 1. Log in to the new Microsoft SQL Server. 2. Right-click My Computer, and click Manage. 3. Expand Local Users and Groups. 4. Select Groups, and open the Administrators group. 5. Click Add. 6. Type the name of the BlackBerry Enterprise Server service account, and click Check Name. 7. Click OK, and close the Computer Management window. Step 2 Depending on the environment, turn on the correct server protocols. MSDE or Microsoft SQL Server 2000 1. Click Start > Run. 2. Type svrnetcn. 3. Click OK. The Microsoft Server Network Configuration Utility opens. 4. Make sure that TCP/IP and Named Pipes are both listed as protocols that have been turned on. 5. Close the Microsoft Server Network Configuration Utility. 6. If a protocol is turned on in step 2, restart the Microsoft SQL services. Microsoft SQL Server 2005 Express or Microsoft SQL Server 2005 1. Click Start > Microsoft SQL Server 2005 > Configuration Tools > Microsoft Server Configuration Manager > Microsoft Server 2005 Network Configuration. 2. Select the Microsoft SQL Server instance that will be used for the BlackBerry Configuration Database. 3. If necessary, turn on the TCP/IP and Named Pipes protocols. 4. If a protocol is turned on in the previous step, restart the Microsoft SQL Serverservices. Step 3 Make sure that the Microsoft Server Agent service is running. Note: This service does not exist in Microsoft SQL Server 2005 Express. 1. Open the Windows® Control Panel, then open Administrative Tools > Services. 2. Verify that the Microsoft Server Agent service is started and that the Startup type is set to Automatic. 3. Close the Services window. Step 4 Update the BlackBerry Configuration Database schema. Important: If the BlackBerry Enterprise Server software was installed to create a blank BlackBerry Configuration Database on a new Microsoft SQL Server instance, do not perform the following task because the schema has already been updated. 1. Download the installation package for the version of the BlackBerry Enterprise Server that is being used. 2. Extract the contents of the installation package. 3. Copy the Database folder to the new Microsoft SQL Server. Note: The default location of this folder is c:\Research In Motion\BlackBerry Enterprise Server 4.x.x\Database. 4. Go to the Database folder and open the BESMgmt.cfg file in a text editor, such as Notepad. 5. Locate the DB_NAME=BESMgmt or (DATABASE_NAME=BESMgmt) line depending on the version of the upgrade and then make sure that the name specified matches the BlackBerry Configuration Database name. 6. If using a named instance of Microsoft SQL Server, change the SERVER=local line to SERVER=\ and close the file. Save the changes. 7. From a command prompt, go to the Database directory. 8. Type createdb.exe BESMgmt.cfg and press Enter. 9. After the command has finished executing, close the command prompt. Task 3 - Restore the BlackBerry Configuration Database Depending on the environment, use one of the methods below to restore the BlackBerry Configuration Database. There are two methods available: restoring the BlackBerry Configuration Database from a backup, or detaching and re-attaching the BlackBerry Configuration Database files. The following are the steps for MSDE and Microsoft SQL Server 2000 and 2005. Restore database method for MSDE BlackBerry Configuration Database on a Microsoft SQL Server with the same directory structure 1. Copy the BlackBerry Configuration Database backup to the C:\ path of the new Microsoft SQL Server. 2. From a command prompt, type osql -E and press Enter. Note: When logging in to a named instance of the Microsoft SQL Server, use the following command: osql -E -S \ 3. Type the following commands in the specified order: 1 > restore database from disk = "c:\.bak" with recovery, replace 2 > go 1 > quit 4. Close the command prompt. BlackBerry Configuration Database on a Microsoft SQL Server with a different directory structure 1. Copy the BlackBerry Configuration Database backup to the C:\ path of the new Microsoft SQL Server. 2. From a command prompt, type osql -E and press Enter. Note: When logging in to a named instance of the Microsoft SQL Server, use the following command: osql -E -S \ 3. Type the following commands in the specified order: 1 > restore database from disk = "C:\.bak" with move "_data" to "\MSSQL\Data\.mdf", move "_log" to "\MSSQL\Data\.ldf" 2 > go 1 > quit Note: To determine the logical file names _data and _log for the BlackBerry Configuration Database, complete the following steps: 1. On the Microsoft SQL Server hosting the BlackBerry Configuration Database, open a command prompt and type the following command: OSQL -E or OSQL -E -S \ 2. Type the following commands in the specified order, pressing Enter after each command: 1 > exec sp_helpdb 2 > go 3. The items circled in the following image are the two logical file names for the BlackBerry Configuration Database: 4. Close the command prompt. Restore database method for Microsoft SQL Server 2000 or 2005 1. Open Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005). 2. Right-click the Databases (for example, BESMgmt). 3. Select Restore Database. 4. Click From Device and browse for the .bak file. 5. Click OK to accept selection. 6. Close Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005) when the process is complete. Detach and re-attach database method for Microsoft SQL Server 2000 or 2005 1. Open the Control Panel, and open Administrative Tools > Services. 2. Stop each service that has a name that begins with BlackBerry. 3. Log in to the existing Microsoft SQL Server. 4. Open Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005). 5. Right-click the BlackBerry Configuration Database name. 6. Select All Tasks, and click Detach Database (see screen shot below), or for Microsoft SQL Server 2005 select Tasks and click Detach. 7. Close Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005). 8. Go to the Microsoft SQL Server Data directory and copy the MDF and LDF files. Note: The default path is C:\Program Files\Microsoft SQL Server\MSSQL\Data\ and the default filenames are BESMgmt.mdf and BESMgmt.ldf. 9. Move the file copies to the new Microsoft SQL Server. 10. Log in to the new Microsoft SQL Server. 11. Open Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005). 12. Right-click the BlackBerry Configuration Database name. 13. Select All Tasks, then click Detach Database, or for Microsoft SQL Server 2005 select Tasks and click Detach. 14. Move the files that were copied in step 8 to the Microsoft SQL Server Data directory. 15. When prompted to overwrite the files, click Yes. 16. In Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005), right-click the Database folder, then click All Tasks. 17. Select Attach Database or for Microsoft SQL 2005 right-click the Database folder and select Attach. 18. Select the MDF file to attach, then click OK (see screen shot below). 19. Close Enterprise Manager (Microsoft SQL Server 2000) or Microsoft SQL Server Management Studio (Microsoft SQL Server 2005). Detach and re-attach database method for MSDE 1. Open the Control Panel, and open Administrative Tools > Services. 2. Stop each service that has a name that begins with BlackBerry. 3. Log in to the existing MSDE Server. 4. From a command prompt, type osql -E and press Enter. Note: When logging in to a named instance of the Microsoft SQL Server, use the following command: osql -E -S \ 5. Type the following commands in the specified order: 1 > exec sp_detach_db @dbname = "" 2 > go 1 > quit 6. Go to the Microsoft SQL Server Data directory and copy the MDF and LDF files. Note: The default path is C:\Program Files\Microsoft SQL Server\MSSQL\Data\ and the default filenames are BESMgmt.mdf and BESMgmt.ldf. 7. Move the files that were copied in step 6 to the new Microsoft SQL Server. 8. Log in to the new MSDE Server. 9. From a command prompt, type osql -E and press Enter. Note: When logging in to a named instance of Microsoft SQL Server, use the following command: osql -E -S \ 10. Type the following commands in the specified order: 1 > exec sp_detach_db @dbname = "" 2 > go 2 > quit 11. Move the files that were copied in step 6 to the Microsoft SQL Server Data directory. When prompted to overwrite the files, click Yes. 12. From a command prompt, type osql -E and press Enter.