Cisco Unity Installation Guide (With IBM Lotus Domino), Release 4.0(2)
Installing and Configuring Cisco Unity Software

Table Of Contents

Installing and Configuring Cisco Unity Software

Installing and Configuring Cisco Unity Software

Starting the Cisco Unity Installation and Configuration Assistant and Installing Cisco Unity Software

Installing License Files

Configuring Services

Configuring the Message Store

Integrating the Phone System with Cisco Unity and Testing the Integration

Resetting Security-Monitoring Software After the Installation Programs Have Been Run

Re-enabling Virus-Scanning Services and Excluding Two Directories from Scanning

Resetting the IDS Host Sensor Agent to Run in On-Protecting Mode

Moving the Data Store Databases and Transaction Log Files


Installing and Configuring Cisco Unity Software


In this chapter, you do the following tasks in the order listed:

1. Use the Cisco Unity Installation and Configuration Assistant to install and configure Cisco Unity. See the "Installing and Configuring Cisco Unity Software" section.

2. If virus-scanning software or the Cisco IDS Host Sensor Agent is installed on the Cisco Unity server: Re-enable virus-scanning services and reset the IDS Host Sensor Agent to run in On-Protecting mode. See the "Resetting Security-Monitoring Software After the Installation Programs Have Been Run" section.


Note Cisco ICS 7750: If you are installing Cisco Unity in the Cisco ICS 7750, skip Task 3.


3. Move SQL Server or MSDE database files and transaction logs. See the "Moving the Data Store Databases and Transaction Log Files" section.

When you are finished with this chapter, return to the applicable task list for your platform type to continue installing the Cisco Unity system correctly:

Task List for Installing Cisco Unity on a Qualified Server

Task List for Installing Cisco Unity in the Cisco ICS 7750


Note The tasks in the list reference detailed instructions in the Cisco Unity Installation Guide and in other Cisco Unity documentation. Follow the documentation for a successful installation.


Installing and Configuring Cisco Unity Software

To install and configure Cisco Unity software, you use the Cisco Unity Installation and Configuration Assistant to run five programs in a specific order. The programs:

Check the system and install the Cisco Unity software.

Install the Cisco Unity licenses.

Configure the services.

Configure the message store.

Integrate Cisco Unity with the phone system.

Do the following five subsections in the order listed.

Starting the Cisco Unity Installation and Configuration Assistant and Installing Cisco Unity Software

From the Cisco Unity Installation and Configuration Assistant, you run the Cisco Unity Setup program first to install Cisco Unity. The Setup program checks the system, then installs the Cisco Unity software.


Caution Do not install features for which the system is not licensed.

To start the assistant and install the Cisco Unity software


Step 1 Log on to Windows by using the Cisco Unity installation account.


Note If you have not already done so, disable virus-scanning services on the Cisco Unity server and set the IDS Host Sensor Agent on the Cisco Unity server to run in On-Warning mode, if applicable. Otherwise, the Cisco Unity program may take several hours to complete or may not run.


Step 2 On the Cisco Unity DVD or CD 1, or from the location to which you saved the downloaded Cisco Unity CD 1 image files, browse to the root directory and double-click Setup.exe.

Step 3 If prompted, double-click the language of your choice to continue the installation.

Step 4 On the Cisco Unity Installation and Configuration Assistant Welcome screen, click Continue.

Step 5 If the Pre-Installation Requirements screen appears, saying that you need to run the Permissions wizard, close the Cisco Unity Installation and Configuration Assistant and see the "Setting Rights and Permissions with the Cisco Unity Permissions Wizard" section. After the wizard is run, log on to Windows by using the Cisco Unity installation account, and return to Step 2.

Otherwise, in the main window of the assistant, click Run the Cisco Unity Setup Program.

Step 6 If prompted, double-click the language of your choice to continue the installation.

Step 7 On the Welcome screen, click Next.

Step 8 Enter your name and the company name, and click Next.

Step 9 Specify locations for the Cisco Unity application, trace logs, and Unity Messaging Repository (UMR) files. Use the locations you made note of in the "Determining the Drive Locations for Files on the Cisco Unity System" section.

Step 10 Click Next.

Step 11 In the Select Features dialog box:

a. Check the Install Cisco Unity check box.

b. Check the Enable TTS check box, if applicable.

c. If the Cisco Unity server contains Intel Dialogic voice cards, check the Install Voice Card Software check box.

If the Cisco Unity server does not contain Intel Dialogic voice cards, uncheck the Install Voice Card Software check box.

Step 12 Click Next.

Step 13 Choose the prompt set to install. Use the G.729a system prompt set if voice messages will be recorded and stored in G.729a format. Otherwise, choose G.711 (the default.)

Note that choosing a system prompt set does not change the default message recording and storage codec. If necessary, you can change the message recording and storage codec later in the installation process.

Step 14 Click Next.

Step 15 In the Cisco Unity Languages dialog box, choose the language(s) to install, and click Next.

Note that if you are using text to speech (TTS) and are using Australian English or New Zealand English as the phone language, also install U.S. English or UK English for the TTS language.

Step 16 Set the default languages for the phone, graphical user interface (GUI), and TTS, and click Next.

Step 17 Follow the on-screen prompts until you are prompted to restart the Cisco Unity server.

Step 18 If the server contains Intel Dialogic D/120JCT-Euro or D/240PCI-T1 voice cards, skip to Step 19.

If the server does not contain Intel Dialogic D/120JCT-Euro or D/240PCI-T1 voice cards, check the Yes, I Want to Restart My Computer Now check box, and click Finish.

The Cisco Unity Installation and Configuration Assistant displays check marks next to "Install Cisco Unity" and "Install the Cisco Unity License Files," and the Configure the Cisco Unity Services screen appears in the main window.

Step 19 If the server contains Intel Dialogic D/120JCT-Euro or D/240PCI-T1 voice cards, uncheck the Yes, I Want to Restart My Computer Now check box, and click Finish.

a. Uncheck the Yes, I Want to Restart My Computer Now check box, and click Finish.

b. Do the procedure under "Software Settings" for your voice card in "Voice Cards."

c. Restart the Cisco Unity server.

The Cisco Unity Installation and Configuration Assistant displays check marks next to "Install Cisco Unity" and "Install the Cisco Unity License Files," and the Configure the Cisco Unity Services screen appears in the main window.


Installing License Files

From the Cisco Unity Installation and Configuration Assistant, you run the Cisco Unity Install License File wizard second to install the Cisco Unity license file(s).

To install the license file(s)


Step 1 Log on to Windows by using the Cisco Unity installation account.

Step 2 In the main window of the assistant, click Run the Cisco Unity Install License File Wizard.

Step 3 On the Welcome screen, click Next.

Step 4 Click Add.

Step 5 Insert the Cisco Unity license file disk, if applicable.

(When Cisco Unity was registered on Cisco.com, Cisco replied with an e-mail containing attached file(s) with license(s) for Cisco Unity features. The instructions in the e-mail directed that the attached files be saved. For more information, see the "Obtaining Cisco Unity License Files" section.)

Step 6 Browse to drive A or to the location where the license file(s) have been stored.

Step 7 Double-click the license file to add it to the License Files list.

If prompted, click Yes to copy the license file to the local system.

Step 8 If you are adding more than one license file, click Add, and repeat Step 6 and Step 7 for each license file.

Step 9 Click Next.

Step 10 In the Licenses list, confirm that the license information is correct.

Step 11 Click Next.

Step 12 Click Finish.

The Cisco Unity Installation and Configuration Assistant displays a check mark next to "Install the Cisco Unity License Files," and the Configure the Cisco Unity Services screen appears in the main window.


Configuring Services

From the Cisco Unity Installation and Configuration Assistant, you run the Cisco Unity Services Configuration wizard third to associate the directory, message store, and local services with accounts you specify.

To configure services


Step 1 In the main window of the assistant, click Run the Cisco Unity Services Configuration Wizard. (Note that you should be logged on to Windows with the Cisco Unity installation account.)

Step 2 On the Welcome screen, click Next.

Step 3 Select the message store type, and click Next.

Step 4 Follow the on-screen prompts to complete the configuration.

The Cisco Unity Installation and Configuration Assistant displays a check mark next to "Configure the Cisco Unity Services," and the Configure the Cisco Unity Message Store screen appears in the main window.


Configuring the Message Store

From the Cisco Unity Installation and Configuration Assistant, you run the Cisco Unity Message Store Configuration wizard fourth to configure the message store.

To configure the message store


Step 1 In the main window of the assistant, click Run the Cisco Unity Message Store Configuration Wizard. (Note that you should be logged on to Windows with the Cisco Unity installation account.)

Step 2 Confirm that the Domino server is running. If Domino is not running, configuring the message store on the Cisco Unity server will fail.

Step 3 On the Welcome screen, click Next.

Step 4 Enter the password for the installation account, and click Next.

Step 5 Click Lotus Domino R5, and click Next.

Step 6 Click Next.

Step 7 Enter the path and password for the local Notes.ini file. The default path is Lotus\Notes\Notes.ini.

Step 8 Click Next.

Step 9 For each Domino server from which you will import users, enter the following information and add the server to the list:

Server Name

The NetBIOS name of the server.

Address Book

Typically, this is the Names.nsf file, unless you are using a secondary address book.

Display Name

The Cisco Unity Administrator uses the text name you enter here for the file you entered in the Address Book field.


Step 10 Click Next.

Step 11 If you created an account for the Cisco Unity Administrator (Cisco Unity administration account) in the "Creating the Accounts" section, click Change. In the Select User dialog box, double-click the name of the Cisco Unity administration account.

Step 12 Click OK to stop Cisco Unity services.

Step 13 Click Finish.

The Cisco Unity Installation and Configuration Assistant displays a check mark next to "Configure the Cisco Unity Message Store," and the Integrate the Phone System with Cisco Unity screen appears in the main window.


Integrating the Phone System with Cisco Unity and Testing the Integration

From the Cisco Unity Installation and Configuration Assistant, you run the Cisco Unity Telephony Integration Manager (UTIM) fifth to connect Cisco Unity with the phone system.

To integrate the phone system with Cisco Unity and test the integration


Step 1 In the main window of the assistant, click Run the Cisco Unity Telephony Integration Manager. (Note that you should be logged on to Windows with the Cisco Unity installation account.)

Step 2 In the right pane of the UTIM, click Create Integration.

Step 3 Refer to the applicable Cisco Unity integration guide for your phone system to complete the integration. (Cisco Unity integration guides are available on Cisco.com at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_configuration_guides_list.html.)

When the integration is complete, the Cisco Unity Installation and Configuration Assistant displays a check mark next to "Integrate the Phone System with Cisco Unity," and the Summary screen appears in the main window.

Step 4 Click Close to exit the assistant.

Step 5 Test the integration with the phone system. Refer to the Cisco Unity integration guide for your phone system.


Note Note that you use the Cisco Unity Administrator for part of the integration test. Use the user name and password for the account that you selected to administer Cisco Unity.



Resetting Security-Monitoring Software After the Installation Programs Have Been Run

You reset the security-monitoring programs you disabled in the "Setting Security-Monitoring Software Before Running the Installation Programs" section now that the programs for preparing the system and installing the Cisco Unity software have been run. If you are re-enabling virus-scanning services, you also need to exclude two directories from scanning.

See the applicable sections:

Re-enabling Virus-Scanning Services and Excluding Two Directories from Scanning

Resetting the IDS Host Sensor Agent to Run in On-Protecting Mode

Re-enabling Virus-Scanning Services and Excluding Two Directories from Scanning

When you re-enable virus-scanning services, you need to exclude from scanning the directory in which Cisco Unity is installed so that the Cisco Unity Administrator and the Cisco Unity Assistant will work properly. If the Cisco Unity system is using Cisco IDS Host Sensor, you also need to exclude from scanning the directory in which the Cisco IDS Host Sensor Agent is installed, so that Cisco IDS Host Sensor will work properly.

To re-enable virus-scanning services and exclude two directories from scanning


Step 1 Refer to the virus-scanning software documentation to determine the names of the virus-scanning services.

Step 2 On the Windows Start menu, click Programs > Administrative Tools > Services.

Step 3 Re-enable each virus-scanning service:

a. In the right pane, double-click the service.

b. On the General tab in the Startup Type list, click Automatic, and click OK.

c. In the right pane, right-click the service, and click Start.

Step 4 When all virus-scanning services have been re-enabled, close the Services MMC.

Step 5 Exclude from virus scanning the directory in which Cisco Unity is installed (the default directory is CommServer). Refer to Help for the virus-scanning software for information on excluding directories from scanning.

Step 6 If the Cisco Unity system is using Cisco IDS Host Sensor, exclude from virus scanning the directory in which Cisco IDS Host Sensor Agent is installed.


Resetting the IDS Host Sensor Agent to Run in On-Protecting Mode

You re-enable the IDS Host Sensor Agent on the Cisco Unity server by setting it to run in On-Protecting mode.

To reset the IDS Host Sensor Agent to run in On-Protecting mode


Step 1 On the server where the IDS Host Console is installed, on the Windows Start menu, click Programs > Cisco HIDS > Cisco HIDS Console.

Step 2 In the left pane of the Console, click Agents. The Agents view appears in the right pane.

Step 3 In the right pane, right-click the name of the IDS Host Sensor Agent on the Cisco Unity server, and click Set to Protecting Mode. Note that it may take several minutes for the Current State to match the Requested State.


Moving the Data Store Databases and Transaction Log Files

The Cisco Unity data store includes several databases and their corresponding transaction log files. Because the Cisco Unity and Reports databases and their log files are the fastest-growing data store files, you place them on the system in a way that makes optimum use of system storage capacity.

As you do the following procedure, if applicable, refer to the drive locations you made note of in the "Determining the Drive Locations for Files on the Cisco Unity System" section.

For more information on moving SQL Server or MSDE databases and transaction logs, refer to Microsoft documentation.

To move the SQL or MSDE databases and transaction log files


Step 1 Stop Cisco Unity (right-click the Cisco Unity icon in the system tray, then click Stop Cisco Unity; if the Cisco Unity icon is not available, browse to the CommServer directory and double-click AvCsTrayStatus.exe).

Step 2 On the Windows Start menu, click Run, then run cmd.

Step 3 Start OSQL by entering OSQL -E on the command line.


Caution OSQL commands are case-sensitive. Enter the instructions exactly as they appear in the procedure.

Step 4 Detach the databases from the data store application by entering the following instructions on the command line:

a. Enter use master, and press Enter.

b. Enter go, and press Enter.

c. Enter EXEC sp_detach_db 'UnityDb', and press Enter.

d. Enter go, and press Enter.

e. Enter EXEC sp_detach_db 'ReportDb', and press Enter.

f. Enter go, and press Enter.

Step 5 In Windows Explorer, create the new database and log destination directories on the drive locations you made note of in the "Determining the Drive Locations for Files on the Cisco Unity System" section. Use directory names that are easy to remember, for example:

UnityDb.mdf and
ReportDb.mdf

<Database destination drive>\<Path>\Unity Data

UnityDb_log.ldf and
ReportDb_log.ldf

<Log file destination drive>\<Path>\Unity Logs


Step 6 In Windows Explorer, copy the databases UnityDb.mdf and ReportDb.mdf from Program Files\Microsoft SQL Server\MSSQL\Data to the new database destination(s).

Step 7 In Windows Explorer, copy the transaction log files UnityDb_log.ldf and ReportDb_log.ldf from Program Files\Microsoft SQL Server\MSSQL\Data to the new log file destination(s).

Step 8 In OSQL, reattach the databases and log files to the data store application by entering the following instructions on the command line:

a. Enter use master, and press Enter.

b. Enter go, and press Enter.

c. Enter EXEC sp_attach_db 'UnityDb', '<Database destination drive>\<New database directory path>\UnityDb.mdf', '<Log file destination drive>\<New log file directory path>\UnityDb_log.ldf',
and press Enter.

d. Enter go, and press Enter.

e. Enter EXEC sp_attach_db 'ReportDb', '<Database destination drive>\<New database directory path>\ReportDb.mdf', '<Log file destination drive>\<New log file directory path>\ReportDb_log.ldf',
and press Enter.

f. Enter go, and press Enter.

Step 9 In OSQL, verify the change in the file locations by entering the following instructions on the command line:

a. Enter use UnityDb, and press Enter.

b. Enter go, and press Enter.

c. Enter sp_helpfile, and press Enter.

d. Enter go, and press Enter.

e. The file name column values should reflect the new locations.

Step 10 Enter exit, and press Enter to close OSQL.

Step 11 Optional: In Windows Explorer, rename each of the databases and log files in the old locations <Original file name and extension>.old. (For example, in its original location, rename UnityDb.mdf to UnityDb.mdf.old.)

Step 12 Restart Cisco Unity (right-click the Cisco Unity icon in the system tray, then click Start Cisco Unity; if the Cisco Unity icon is not available, browse to the CommServer directory and double-click AvCsTrayStatus.exe).