Cisco Unity Installation Guide (With Microsoft Exchange), 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

Exchange 2000

Exchange 5.5

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).

If you are installing license files for a Cisco Unity system without failover or on the primary server for a Cisco Unity system with failover, do the first procedure, "To install the license file(s)."

If you are installing the secondary Cisco Unity server now, do the second procedure, "To install the default license file on the secondary Cisco Unity server."

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.


Do the following procedure if you are installing the secondary server now for a Cisco Unity system with failover. Otherwise, do the first procedure, "To install the license file(s)."

To install the default license file on the secondary Cisco Unity server


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 Install the default license file:

a. Browse to the CommServer\Licenses directory.

b. Double-click CiscoUnity40.lic.

Step 6 Click Next.

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

Step 8 Click Next.

Step 9 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.

This section contains procedures for configuring the message store on an Exchange 2000 system and on an Exchange 5.5 system. Do the procedure for your version of Exchange:

Exchange 2000

Exchange 5.5

If Cisco Unity subscribers will be homed on both Exchange 2000 and Exchange 5.5 servers, do the procedure for Exchange 2000.

Exchange 2000

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 Exchange is running on the server where you want to create new mailboxes. If Exchange 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 Microsoft Exchange 2000, and click Next.

Step 6 Choose the Exchange server and mailbox store in which to create new mailboxes.

For the Cisco Unity Unified Messaging configuration:

All voice messages pass through the server you choose here on their way to user mailboxes. Use Microsoft guidelines to choose a server based on its ability to handle the additional traffic.

If Exchange is configured for active/active clustering, choose either an Exchange server outside the cluster or the virtual server that is running Exchange Message Transfer Agent.

If Exchange is configured for active/passive clustering, you may choose either a server outside the cluster or the virtual server in the cluster.

Step 7 Click Next.

Step 8 Select the domain in which you want Cisco Unity to create users and distribution lists.

Step 9 If you created custom organizational units for users or distribution lists, click the corresponding Change button to specify them here.

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 Next.

Step 13 Click OK to stop Cisco Unity services.

Step 14 Set how administrators will create Cisco Unity subscriber accounts in the Cisco Unity Administrator:

Create New Accounts
or Import Existing Accounts
Click if administrators will create subscriber accounts either by adding a new user to Exchange or by importing existing user data from Exchange.
Import Existing Accounts Only

Click if administrators will create subscriber accounts only by importing existing user data from Exchange.


Step 15 Click Next.

Step 16 By default, the installation account appears as the account that Cisco Unity directory services log on as. If you want to use the default, skip to Step 17.

If you created a directory services account in the "Creating the Accounts" section, click Change. In the Select User dialog box, double-click the name of the directory services account.

Step 17 Specify a password for the account, and click Next.

Step 18 When message store configuration is complete, 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.


Exchange 5.5

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 Exchange is running on the server where you want to create new mailboxes. If Exchange 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 Microsoft Exchange 5.5, and click Next.

Step 6 Choose the Exchange server in which to create new mailboxes.

For the Cisco Unity Unified Messaging configuration, Cisco recommends that you choose one of the less busy Exchange servers in the site. All voice messages pass through the server you choose here on their way to user mailboxes.

Step 7 Enter the LDAP port number for the Exchange server that you made note of in the procedure "To change the LDAP port number of the Exchange 5.5 server (when Active Directory is installed)" in the "Installing Exchange 5.5 Software—Unified Messaging with Exchange 5.5 on a Separate Server" section.


Note When Active Directory and Exchange 5.5 are installed on the same server, the Exchange LDAP port number must be reset from the default of 389, because Active Directory reserves port 389 for LDAP. If you do not know the LDAP port number of the Exchange server, consult the Exchange administrator.


Step 8 Click Next.

Step 9 If you created a Cisco Unity Administrator account (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 10 Click Next.

Step 11 Click OK to stop Cisco Unity services.

Step 12 Set how administrators will create Cisco Unity subscriber accounts in the Cisco Unity Administrator:

Create New Accounts
or Import Existing Accounts
Click if administrators will create subscriber accounts either by adding a new user to Exchange or by importing existing user data from Exchange.
Import Existing Accounts Only

Click if administrators will create subscriber accounts only by importing existing user data from Exchange.


Step 13 Click Next.

Step 14 By default, the installation account appears as the account that Cisco Unity directory services log on as. If you want to use the default, skip to Step 15.

If you created a directory services account in the "Creating the Accounts" section, click Change. In the Select User dialog box, double-click the name of the directory services account.

Step 15 Specify a password for the account, and click Next.

Step 16 When message store configuration is complete, 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.

If you are integrating the phone system for a Cisco Unity system without failover or on the primary server for a Cisco Unity system with failover, do the first procedure, "To integrate the phone system with Cisco Unity and test the integration."

If you are integrating the phone system on the secondary server now, do the second procedure, "To integrate the phone system with Cisco Unity on the secondary server."

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.



Do the following procedure if you are integrating the phone system on the secondary Cisco Unity server now for a system with failover. Otherwise, do the first procedure, "To integrate the phone system with Cisco Unity and test the integration."

To integrate the phone system with Cisco Unity on the secondary server


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 Fill in the fields with the same values you used for the primary server, with the exception of the Cisco CallManager Device Name Prefix field value for a Cisco CallManager integration. The value used on the primary Cisco Unity server is different from the value used on the secondary Cisco Unity server.

Step 4 When the message appears saying that you have entered more ports than you are allowed, click OK.

Step 5 Continue to fill in the fields with the same values you used for the primary server.

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 6 Click Close to exit the assistant.


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).