Blackbe;rry PROFESSIONAL SOFTWARE FOR IBM LOTUS DOMINO - - MIGRATION... User manual

Migration Guide
BlackBerry Professional Software for IBM Lotus Domino
Version: 4.1 | Service Pack: 4

SWD-315666-0912100348-001

Contents
1About the BlackBerry Professional Software................................................................................................................ 3
Migrating to the BlackBerry Professional Software............................................................................................................... 3
2Migrate to the BlackBerry Professional Software........................................................................................................ 5
3Troubleshooting the installation process...................................................................................................................... 7
A third-party tool did not install successfully and the BlackBerry Professional Software setup application closed
........................................................................................................................................................................................................ 7
Failed to write License key to the Database. Refer to the installation log file for more information............................ 7
Previous version detected but no database available............................................................................................................ 7
The setup application prompts for access to the installation media for Microsoft .NET Framework version 1.1.......... 8
Could not open ID file................................................................................................................................................................. 8
BlackBerry Router and BlackBerry Dispatcher do not install during the migration or upgrade process...................... 9
4Adding user accounts......................................................................................................................................................... 11
Preconfigured IT policies in the BlackBerry Professional Software..................................................................................... 11
Add a user account...................................................................................................................................................................... 13
5 Legal notice.......................................................................................................................................................................... 15

About the BlackBerry Professional Software 1
The BlackBerry® Professional Software is designed to provide the core wireless communications and collaboration features
and the security that you have in your current BlackBerry small business solution, in a smaller package.
The BlackBerry Professional Software supports up to 30 BlackBerry device users.
The BlackBerry Manager that ships with the BlackBerry Professional Software has been redesigned to provide streamlined
access to management and configuration tools. You can use the same IT policy rules that you use to protect your existing
BlackBerry small business solution. In addition, you can now choose from preconfigured IT policies that are designed to make
IT policy management easier.
Because group-based administration and role-based administration are designed for larger organizations with multiple IT
departments and administrators, these management options have been removed from the BlackBerry Professional Software.
Support for applications has also been simplified. You can install BlackBerry® Java® Applications and BlackBerry Browser
applications on the BlackBerry devices in your organization, but existing or new BlackBerry MDS Runtime Applications are
not supported.
UserscancommunicatewithinstantmessagingapplicationssuchasGoogleTalk™orYahoo!®Messenger,buttheBlackBerry
Professional Software does not support server-based enterprise instant messaging applications, such as IBM® Lotus®
Sametime® or Microsoft® Office Live Communications Server.
If the number of BlackBerry device users in your organization increases, or if you find that users need access to more data
or to a broader range of applications, you can upgrade from the BlackBerry Professional Software to BlackBerry® Enterprise
Server Version 4.1 SP5 or later.
Migrating to the BlackBerry Professional Software
You can migrate to the BlackBerry® Professional Software from BlackBerry® Enterprise Server – Small Business Edition
Version 4.0 or later. If you have a small business solution that is earlier than Version 4.0, you must upgrade to Version 4.0
or later before you migrate to the BlackBerry Professional Software.
You can install the BlackBerry Professional Software either on the current host server for your BlackBerry small business
solution or on your mail server. If your present environment is up and running, no additional setup tasks are required. You
do not have to remove the software for your existing BlackBerry small business solution before you begin the migration.
During the migration, you can configure the BlackBerry Professional Software to connect to an existing Microsoft® SQL
Server® database. Alternatively, the setup application can automatically install a Microsoft® SQL Server® 2005 Express
database.
Migration Guide About the BlackBerry Professional Software
3

The setup application runs a preinstallation tool that verifies that your environment meets the minimum system requirements
for the BlackBerry Professional Software. The tool displays the results of the analysis on the screen. It also writes the results
in the log files in the following location: <drive>:\Program Files\Research In Motion\Blackberry Enterprise Server\logs
\installer. The file names begin with DetectionLog_ .
If components of your existing BlackBerry small business solution, such as the BlackBerry Router or the BlackBerry
Attachment Service, are currently installed on separate computers, the components remain installed, but the BlackBerry
ProfessionalSoftwareignoresthemandusesthecomponentsthatthesetup application installs during themigrationprocess.
By default, the BlackBerry Professional Software uses the CAL key from your existing BlackBerry small business solution. If
you have a new CAL key, you can replace the existing CAL key after the installation.
For more information, see the BlackBerry Professional Software documentation at www.blackberry.com/go/serverdocs.
Migration Guide Migrating to the BlackBerry Professional Software
4

Migrate to the BlackBerry Professional Software 2
Note: You must restart your server during the installation process. The restart can take several minutes.
1. Log in to the host server for the BlackBerry® Professional Software using the account that you use to administer your
existing BlackBerry small business solution.
2. Click Start > Administrative Tools > Services.
3. Right-click Lotus Domino Server. Click Properties.
4. Set the Startup type to Manual.
5. In the Service status section, click Stop.
6. In the BlackBerry Professional Software installation media, double-click the setup.exe file.
7. Complete the instructions on the screen. Consider the following information:
• If you must resolve any issues that the preinstallation tool detects, click Cancel. You can restart the migration
after you resolve the issues.
•If you want to install a Microsoft® SQL Server® 2005 Express database on your server, click Local, and then type
the Microsoft SQL Server name, the database name, and the authentication type.
•If you want to connect to an existing local database, click Local, and then type the name or IP address of the host
computer for the existing database and the name of the existing database.
• If you want to connect to an existing database, click Remote, and then type the name or IP address of the host
computer for the existing database and the name of the existing database.
8. When you are prompted to restart your server, click Yes.
9. Log in to the host server for the BlackBerry Professional Software using the account that you use to administer your
existing BlackBerry small business solution. Wait for the setup application to restart.
10. Complete the instructions on the screen. Consider the following information:
•The BlackBerry Professional Software uses the CAL key from your existing BlackBerry small business solution. To
change the CAL key, type the new information in the CAL key field.
11. To complete the migration and start the BlackBerry Professional Software, click Start Service.
12. Click Finish.
13. On the taskbar, click Start > Lotus Domino Server.
14. Click Start Domino as a Windows service.
15. Reset the Startup type to Automatic.
Migration Guide Migrate to the BlackBerry Professional Software
5

Troubleshooting the installation process 3
A third-party tool did not install successfully and the BlackBerry
Professional Software setup application closed
Possible solution
1. In the BlackBerry® Professional Software installation media, double-click the Tools folder.
2. Double-click the setup application file for the tool.
3. Complete the instructions on the screen.
4. Restart the BlackBerry Professional Software setup application.
Failed to write License key to the Database. Refer to the installation log
file for more information.
This message appears if you change the client access license (CAL) key for the BlackBerry® Enterprise Server - Small Business
Edition to the CAL key for the BlackBerry® Professional Software during the migration process. In addition, the BlackBerry
Professional Software does not install successfully.
Possible cause
By default, the setup application for the BlackBerry® Professional Software does not overwrite an existing CAL key during
the installation, migration, or upgrade process.
Possible solution
You must complete the installation using the existing CAL key for the BlackBerry® Enterprise Server - Small Business Edition.
After you complete the installation, you must change to the CAL key for the BlackBerry® Professional Software.
1. On the server that hosts the BlackBerry Professional Software, on the taskbar, click Start > BlackBerry Manager.
2. Click the Home tab.
3. In the Account section, click License Management.
4. Click Add License .
Previous version detected but no database available
This message might appear when you start the setup application. The setup application then closes.
Possible solution
Migration Guide Troubleshooting the installation process
7

The registry keys that identify the BlackBerry® Configuration Database must exist in the Registry Editor.
1. On the server that hosts the BlackBerry® Professional Software, on the taskbar, click Start > Run. Type regedit.
2. In the left pane, navigate to HKEY_LOCAL_MACHINE\Research In Motion\BlackBerry Enterprise Server\Database.
3. Right-click Database. Click New > String Value.
4. Create the following case-sensitive String values if they do not already exist:
•DatabaseName: Right-click the new value. Click Modify. Set the Value data to the name of the BlackBerry
Configuration Database.
•DatabaseServerMachineName: Right-click the new value. Click Modify. Set the Value data to the computer
name of the server that hosts the BlackBerry Configuration Database.
5. Restart the setup application.
The setup application prompts for access to the installation media for
Microsoft .NET Framework version 1.1
Possible cause
When the BlackBerry® Professional Software setup application installs Microsoft® .NET Framework version 1.1 SP1 on a
computer that hosts a previously installed version of Microsoft .NET Framework version 1.1, it prompts you for access to the
installation media for Microsoft .NET Framework version 1.1.
Possible solution
1. In the BlackBerry Professional Software installation media, double-click the Tools folder.
2. Double-click the netfx.msi file.
3. Complete the instructions on the screen.
Could not open ID file
This message appears when you start the BlackBerry® Professional Software setup application. The setup application then
closes.
Possible solution
1. If you installed the IBM® Lotus® Domino® server but have not started it yet, start it and stop it.
2. Restart the setup application.
Migration Guide The setup application prompts for access to the installation media for Microsoft .NET Framework version 1.1
8