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

BlackBerry Router and BlackBerry Dispatcher do not install during the
migration or upgrade process
When you migrate or upgrade to the BlackBerry® Professional Software from BlackBerry® Enterprise Server - Small Business
Edition or BlackBerry Enterprise Server Express, the BlackBerry Router and BlackBerry Dispatcher do not install, and the
BlackBerry Professional Software does not run.
The log files for the setup application do not display any error messages for the migration or upgrade process.
Possible solution
Remove and then re-install the BlackBerry Professional Software.
When you re-install the BlackBerry Professional Software, you must specify both the name of the Microsoft® SQL Server®
that hosts your existing BlackBerry Configuration Database and the name of the original database (the default name is
BESMgmt).
To point your database to the correct Microsoft SQL Server and database name, at the Database Settings step of the
migration or upgrade process, consider the following information:
• In the Database Location section, specify whether your existing BlackBerry Configuration Database is running on a
locally hosted Microsoft SQL Server or on a remote server.
• In the Database Information section, type either the computer name or the IP address of the Microsoft SQL Server.
• In the Database Information section, type the name of the existing database.
•In the Database authentication section, select the authentication type for your existing database. If you are installing
a new database, select Windows (trusted) authentication.
Migration Guide BlackBerry Router and BlackBerry Dispatcher do not install during the migration or upgrade process
9

Adding user accounts 4
You create and manage user accounts for the BlackBerry® Professional Software using the BlackBerry Manager.
In the BlackBerry Manager, you can use the Add New Users Wizard to create each user account, or you can create each user
account manually. For information about creating a user account manually, see the BlackBerry Professional Software
Administration Guide.
Preconfigured IT policies in the BlackBerry Professional Software
The BlackBerry® Professional Software provides preconfigured IT policies that you can apply when you set up a user account.
You can configure additional IT policy rules in these IT policies or change any settings that are shown in the following table.
IT policy rule Default IT
policy
Basic
password
security IT
policy
Medium
password
security IT
policy
Medium
password
security
(disallow
application
download) IT
policy
Advanced
securityITpolicy
Advanced
security
(disallow
application
downloads) IT
policy
Device-Only Items
Password
Required
False True True True True True
User Can
Disable
Password
True False False False False False
Maximum
Security Timeout
— 30 min. 10 min. 10 min. 10 min. 10 min.
Maximum
Password Age
— 60 days 30 days 30 days 30 days 30 days
Password
Pattern Checks
0 0 at least 1 alpha
and 1 numeric
character
at least 1 alpha
and 1 numeric
character
at least 1 alpha
and 1 numeric
character
at least 1 alpha
and 1 numeric
character
Enable Long-
term Timeout
— — True True True True
Migration Guide Adding user accounts
11

IT policy rule Default IT
policy
Basic
password
security IT
policy
Medium
password
security IT
policy
Medium
password
security
(disallow
application
download) IT
policy
Advanced
securityITpolicy
Advanced
security
(disallow
application
downloads) IT
policy
Password policy group
Maximum
Password
History
— — 6 6 6 6
Security policy group
Disallow Third
Party
Application
Download
False False False True False True
Force Lock When
Holstered
False False True True True True
Content
Protection
Strength
— — — — Strong Strong
Disable USB
Mass Storage
False False False False True True
External File
System
Encryption level
0 — — — Encrypt to user
password
(excluding
multimedia
directories)
—
Bluetooth policy group
Disable Serial
Port Profile
False False False False True True
Disable
Discoverable
Mode
False False True True True True
Migration Guide Preconfigured IT policies in the BlackBerry Professional Software
12

IT policy rule Default IT
policy
Basic
password
security IT
policy
Medium
password
security IT
policy
Medium
password
security
(disallow
application
download) IT
policy
Advanced
securityITpolicy
Advanced
security
(disallow
application
downloads) IT
policy
Disable Address
Book Transfer
False False False False True True
Disable File
Transfer
False False False False True True
Require LED
Connection
Indicator
False False False False True True
WLAN policy group
WLAN Allow
Handheld
Changes
True False False False False False
Add a user account
You must set up user accounts on your messaging server before you set up user accounts in the BlackBerry® Professional
Software.
When you create a user account, you can assign an IT policy to control settings for the account. You can select one of the
preconfigured IT policies, or create your own and select it. For more information about the IT policy rule settings, see the
Policy Reference Guide.
1. On the server that hosts the BlackBerry Professional Software, on the taskbar, click Start > BlackBerry Manager.
2. In the BlackBerry Manager, click the Home tab.
3. In the Account section, click Add New Users Wizard.
4. In the user list, click the name of the user whose BlackBerry Professional Software user account you want to create.
5. Click Select.
6. Click OK.
7. On the Select IT policy screen, specify the IT policy setting for the user account.
8. On the Device Deployment screen, specify how to activate the BlackBerry device.
Migration Guide Add a user account
13

9. Click Done.
Migration Guide Add a user account
14

Legal notice 5
©2008 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, SureType® and related
trademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S.
and countries around the world.
Google Talk is a trademark of Google Inc. IBM, Domino, Lotus, and Lotus Notes are trademarks of International Business
Machines Corporation. Microsoft is a trademark of Microsoft Corporation. Java is a trademark of Sun Microsystems, Inc.
Yahoo! is a trademark of Yahoo! Inc. All other trademarks are the property of their respective owners.
The BlackBerry smartphone and other devices and/or associated software are protected by copyright, international treaties,
and various patents, including one or more of the following U.S. patents: 6,278,442; 6,271,605; 6,219,694; 6,075,470;
6,073,318; D445,428; D433,460; D416,256. Other patents are registered or pending in the U.S. and in various countries
around the world. Visit www.rim.com/patents for a list of RIM (as hereinafter defined) patents.
This documentation including all documentation incorporated by reference herein such as documentation provided or made
availableat www.blackberry.com/go/docs is providedormadeaccessible"ASIS" and "AS AVAILABLE"andwithoutcondition,
endorsement, guarantee, representation, or warranty of any kind by Research In Motion Limited and its affiliated companies
("RIM") and RIM assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in this
documentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation
may describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information
that is contained in this documentation; however, RIM makes no commitment to provide any such changes, updates,
enhancements, or other additions to this documentation to you in a timely manner or at all.
Thisdocumentationmightcontainreferencestothird-partysourcesof information,hardware orsoftware,productsorservices
including components and content such as content protected by copyright and/or third-party web sites (collectively the
"Third Party Products and Services"). RIM does not control, and is not responsible for, any Third Party Products and Services
including, without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness,
legality, decency, links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party
Products and Services in this documentation does not imply endorsement by RIM of the Third Party Products and Services
or the third party in any way.
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS,
ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR
WARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE
QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A
COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE
OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES
REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR
PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND
CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE
Migration Guide Legal notice
15

DOCUMENTATIONTO THE EXTENT THEYCANNOT BE EXCLUDED ASSET OUT ABOVE, BUTCAN BE LIMITED, AREHEREBY
LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS
THE SUBJECT OF THE CLAIM.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE
FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-
PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES
REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT,
CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES
FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS
OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO
TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH
RIMPRODUCTS OR SERVICES, DOWNTIME COSTS, LOSSOFTHEUSEOFRIM PRODUCTS OR SERVICES OR ANYPORTION
THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES,
COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR
UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHER
OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY
LIABILITY FOR NEGLIGENCE OR STRICT LIABILITY.
THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE
CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT,
NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH
OR BREACHES OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED
HEREIN; AND (B) TO RIM AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS
(INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE
PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS.
INADDITION TO THE LIMITATIONS ANDEXCLUSIONS SET OUT ABOVE,INNO EVENT SHALL ANYDIRECTOR, EMPLOYEE,
AGENT,DISTRIBUTOR,SUPPLIER,INDEPENDENTCONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY
ARISING FROM OR RELATED TO THE DOCUMENTATION.
Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your
airtime service provider has agreed to support all of their features. Installation or use of Third Party Products and Services
with RIM's products and services may require one or more patent, trademark, copyright, or other licenses in order to avoid
infringement or violation of third party rights. You are solely responsible for determining whether to use Third Party Products
and Services and if any third party licenses are required to do so. If required you are responsible for acquiring them. You
should not install or use Third Party Products and Services until all necessary licenses have been acquired. Any Third Party
Products and Services that are provided with RIM's products and services are provided as a convenience to you and are
provided "AS IS" with no express or implied conditions, endorsements, guarantees, representations, or warranties of any
kind by RIM and RIM assumes no liability whatsoever, in relation thereto. Your use of Third Party Products and Services shall
be governed by and subject to you agreeing to the terms of separate licenses and other agreements applicable thereto with
third parties, except to the extent expressly covered by a license or other agreement with RIM.
Migration Guide Legal notice
16

The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable
thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR
WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS
DOCUMENTATION.
Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server Software,
BlackBerry® Desktop Software, and/or BlackBerry® Device Software and may require additional development or Third Party
Products and Services for access to corporate applications.
This product includes software developed by the Apache Software Foundation (www.apache.org/) and/or licensed pursuant
to Apache License, Version 2.0 (www.apache.org/licenses/). For more information, see the NOTICE.txt file included with the
software. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for
the specific language governing permissions and limitations under the License.
Research In Motion Limited
295 Phillip Street
Waterloo, ON N2L 3W8
Canada
Research In Motion UK Limited
200 Bath Road
Slough, Berkshire SL1 3XE
United Kingdom
Published in Canada
Migration Guide Legal notice
17