domino unified communications services for avayafile/avucadminguide.pdf · • avaya unified...

DISCLAIMER

THIS DOCUMENTATION IS PROVIDED FOR REFERENCE PURPOSES ONLY. WHILE EFFORTSWERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATIONCONTAINED IN THIS DOCUMENTATION, THIS DOCUMENTATION IS PROVIDED "AS IS"WITHOUT ANY WARRANTY WHATSOEVER AND TO THE MAXIMUM EXTENT PERMITTED,IBM DISCLAIMS ALL IMPLIED WARRANTIES, INCLUDING WITHOUT LIMITATION THEIMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR APARTICULAR PURPOSE, WITH RESPECT TO THE SAME. IBM SHALL NOT BE RESPONSIBLE FORANY DAMAGES, INCLUDING WITHOUT LIMITATION, DIRECT, INDIRECT, CONSEQUENTIALOR INCIDENTAL DAMAGES, ARISING OUT OF THE USE OF, OR OTHERWISE RELATED TO,THIS DOCUMENTATION OR ANY OTHER DOCUMENTATION. NOTWITHSTANDINGANYTHING TO THE CONTRARY, NOTHING CONTAINED IN THIS DOCUMENTATION OR ANYOTHER DOCUMENTATION IS INTENDED TO, NOR SHALL HAVE THE EFFECT OF, CREATINGANY WARRANTIES OR REPRESENTATIONS FROM IBM (OR ITS SUPPLIERS OR LICENSORS), ORALTERING THE TERMS AND CONDITIONS OF THE APPLICABLE LICENSE AGREEMENTGOVERNING THE USE OF THIS SOFTWARE.

Copyright

Under the copyright laws, neither the documentation nor the software may be copied, photocopied,reproduced, translated, or reduced to any electronic medium or machine-readable form, in whole or inpart, without the prior written consent of IBM Corporation, except in the manner described in thedocumentation or the applicable licensing agreement governing the use of the software.

© Copyright IBM Corporation 2001, 2002

All Rights Reserved.

Lotus SoftwareIBM Software GroupOne Rogers StreetCambridge, MA 02142

US Government Users Restricted Rights — Use, duplication, or disclosure restricted by GS ADPSchedule Contract with IBM Corp.

List of Trademarks

Domino and iNotes are trademarks, and Lotus and Notes are registered trademarks of IBMCorporation in the United States, other countries, or both. IBM is a registered trademark ofInternational Business Machines Corporation.

Avaya and Unified Messenger are trademarks of Avaya Inc.

All other trademarks are the property of their respective owners.

23Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21DUCS server tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20DUCS Tell commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19DUCS NOTES.INI settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193 Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17Updating the design of the mail file manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17Installing the DUCS client component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16Disabling a subscriber or making a subscriber inactive . . . . . . . . . . . . . . . . . . . . . . . . . . . .14Enabling a subscriber for Unified Messenger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14Configuring the Voicemail Domain Summary document . . . . . . . . . . . . . . . . . . . . . . . . . . .14Installing Avaya Unified Messenger on voice servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13Editing the ACL of the Domino Directory and the Administration Requests database . . . . . . . .12Registering Avaya voice servers as Notes users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12Creating an access control group for voice servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10Installing the DUCS administration component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9Installing the DUCS server component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9Overview of installing and configuring DUCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92 Installing and Configuring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7Example of accessing a voice message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Example of processing an unanswered call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Example of enabling a subscriber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3Components of DUCS for Avaya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2Typical voice mail topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1Planning the DUCS installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

i

Contents

Chapter 1Planning

This chapter describes the concepts you need to understand before youinstall and configure Domino Unified Communications Services.

Planning the DUCS installationIBM® Lotus® Domino™ Unified Communications Services (DUCS) workswith Avaya™ Unified Messenger™ to provide a complete voice mailinfrastructure. Understanding the basic design of this infrastructure helpsyou plan the installation at your site.

This document describes configuring and installing DUCS. For completeinformation on configuring Avaya Unified Messenger, see these books,available from Avaya:

• Avaya Unified Messenger Administrator’s Guide

• Avaya Unified Messenger Concepts and Planning Guide

• Avaya Unified Messenger Solution — IBM Lotus Domino versionInstallation Guide

1

Typical voice mail topologyThe following figure shows a simplified view of a typical voice mailtopology. To route voice messages between phones and servers, youconfigure voice servers for Avaya Unified Messenger and install DUCS onevery Domino mail server that hosts a subscriber’s mail file.

Domino Domain A

Mail Server

DirectoryServer

Domino Domain B

Mail Server

DirectoryServer

Avaya Voicemail Domain

VoiceServer

VoiceServer

VoiceServer

PBX

Subscriber’sTelephone

Avaya PeerDomino Server

Avaya PrimaryDirectory Server

Avaya SecondaryDirectory Server

When configuring Avaya Unified Messenger, you identify several Dominoservers to form the connection between the Avaya voice servers in theAvaya Voicemail Domain and the Domino servers in one or more Dominodomains. You must identify the following:

• Avaya Peer Mail Server

• Avaya Primary Directory Server and, depending on the Dominotopology, one or more Avaya Secondary Directory Servers

Avaya Peer Mail ServerFor each Voicemail Domain, you must specify one Avaya Peer Mail Server,which is the Domino server that hosts one mail file for each Avaya voiceserver in the Voicemail Domain. The Domino server that you specify as thePeer Mail Server receives every incoming voice message from the VoicemailDomain, and then, using the Router, transfers the message to the recipient.Avaya Unified Messenger regularly checks the Peer Mail Server for newmessages to route to the Voicemail Domain.

2 Administrator’s Guide

Because the Peer Mail Server is the primary routing point, choose a Dominoserver that is configured for optimal mail routing within the Dominotopology. In many topologies, the Domino server that is a mail hub is agood choice as the Peer Mail Server. Which server you choose dependsentirely on your Domino topology.

In addition, when you consider which server to designate the Peer MailServer, review the locations of the mail files of users whom you will enableas DUCS subscribers. You must ensure that routing is optimally set up toreach all DUCS-enabled subscribers’ mail files. If you are working with apreexisting Domino infrastructure, you may need to move some users’ mailfiles to set up the voice message infrastructure for optimal performance.

Avaya Primary Directory ServerWithin a Voicemail Domain, you must specify one Avaya PrimaryDirectory Server, which is a Domino server that is set up as a directoryserver. Avaya Unified Messenger regularly checks the Domino Directory on the Primary Directory Server to obtain subscriber addresses and updatePerson documents.

If the voice servers in a Voicemail Domain are configured to supportsubscribers whose Notes mail files are in two or more Domino domains,you must configure an Avaya Secondary Directory Server for eachadditional Domino domain. Because the voice servers make heavy use ofthe Primary and Secondary Directory Servers, give some thought to whichDomino directory servers to specify when you set up Avaya UnifiedMessenger.

Components of DUCS for AvayaDUCS for Avaya is a set of server components, a set of administrationcomponents, and a set of client components that you install using separateinstallation programs.

Server componentsThe server components include:

• Add-in code that extends the Router, Server, and HTTP server tasks,as well as message and folder operations

• New server tasks — UCEvent and AVUMHlr — which providenotification services

• Enhancements to the mail template, which are provided in threefiles: UCTUI.NTF, UCINOTES.NTF, and UCMAIL5.NTF

Chapter 1: Planning 3

Administration componentsThe administration components include:

• The UCAdminp server task, which automates administrative tasksrelated to DUCS

• Changes to the Domino Directory, which are provided inAVUCADMIN.NTF

• Additional, optional administration components to install on amachine that doesn’t have the DUCS client installed on it but thatyou use for DUCS administration

Client componentsThe client components include:

• Features for managing voice messages

• Updates to mail templates for IBM Lotus iNotes™ and IBM LotusNotes®

• A player/recorder

• Avaya Unified Messenger Options

Example of enabling a subscriberThe following figure illustrates the process of enabling a subscriber. Thefigure depicts one Domino server set up as both a mail and directory server;however, you could use two servers — one mail server and one directoryserver.

Avaya VoiceServer

DUCS-enabledClient

Domino Server

FEDB


Domino Directory

Administration Requests Database

Subscriber’sMail File

Adminp Task

UCAdminp Task

��

��

��

��

��

��

��


1. The administrator edits the subscriber’s Person document in theDomino Directory to enable the subscriber for DUCS, and then savesthe document.

2. During the save operation, the administration request “Unknownrequest 5001” is created in the Administration Requests database to setup the subscriber’s mail file for DUCS.

3. The Adminp task passes the request to the UCAdminp task.

4. The UCAdminp task does the following to enable the subscriber’s mailfile:

• Adds hidden views

• Sets the ACL on the subscriber’s mail file to allow the voice serveraccess control group to have access

• Creates one or more Profile documents that are in the subscriber’smail file and store information about the subscriber

• Replaces the design of the iNotes mail file

5. The voice server detects that there is a change to the Domino Directoryand updates the Front-end Database (FEDB), which is a directory that ison the voice server and that stores information about subscribers in theDomino Directories on the Primary and Secondary Directory servers.

6. The subscriber calls and logs into the voice server for the first time anddoes the following;

• Sets or changes the voice mail password

• Records personal greetings

7. The voice server updates the following:

• The subscriber’s Person document to include the password andspoken name

• The subscriber’s mail file to include personal greetings


Example of processing an unanswered callThe following figure illustrates processing an unanswered call. In this case,the subscriber set up a notification so that any unanswered call causes themessage waiting indicator on the phone to turn on. The figure depicts oneDomino server set up as a mail and directory server and used as the AvayaPeer Mail Server; however, you could use three servers — one mail server,one Peer Mail Server, and one directory server.

Domino Server

Domino Directory

MAIL.BOX


Router Task

UCEvent Task

��

PBX


AVUMHlr Task

��

��

FEDB

Mailbox MonitorMWI Server

Avaya Voice Server

��

��

��

��

��

��

1. The subscriber receives an incoming call but does not answer it, so thePBX passes the call to the voice server.

2. The voice server finds the subscriber’s telephone number in the FEDB andretrieves the subscriber’s name, mail server name, and mail file name.

3. The voice server retrieves information about the subscriber from theDomino Directory and gets the subscriber’s greeting from the subscriber’smail file.

4. The voice server plays the subscriber’s greeting and records the caller’smessage.

5. The voice server writes the message to MAIL.BOX on the Avaya Peer MailServer.

6. The Router delivers the message to the subscriber’s mail file. DUCS checksthe subscriber’s Profile documents and then sets flags to indicate themessage type and to indicate that the message is new and is in the Inbox.

7. DUCS sends a new message notification to the UCEvent task.

8. The UCEvent task passes a notification to the AVUMHlr task.


9. The AVUMHlr task passes the notification to the Mailbox Monitor onthe Avaya voice server.

10. The Mailbox Monitor signals the PBX to turn on the message waitingindicator on the subscriber’s telephone.

Example of accessing a voice messageThe following figure illustrates accessing a voice message, using iNotes orthe Notes client or using the telephone user interface (TUI). In this example,the subscriber has set up a notification to use the message waiting indicatoron the phone.

Domino Server

Server TaskHTTP Task

UCEvent Task

AVUMHlr Task


��

Mailbox Monitor

Avaya Voice Server

��

��

��

��PBX


Notes Client oriNotes

��

1. One of the following occurs:

• (1a) The subscriber uses iNotes or the Notes client to open the Inboxin the mail file. Then the subscriber opens the voice message andplays the content.

• (1b) The subscriber uses the TUI to access the Inbox. The voice serverreads the Inbox summary from the $UCINBOX view and plays thesummary for the subscriber. The subscriber requests that the voiceserver play the message.

Then DUCS updates the message in the Inbox to be marked “seen.”Next, DUCS checks the subscriber’s Profile documents for informationabout notifications. In this case, the subscriber has set up a notificationto use the message waiting indicator on the phone.

2. DUCS sends the notification to the UCEvent task.

3. The UCEvent task sends notification to the AVUMHlr task.

4. The AVUMHlr task sends notification to the Mailbox Monitor.

5. The Mailbox Monitor signals the PBX to turn off the message waitingindicator on the subscriber’s telephone.


Chapter 2Installing and Configuring

This chapter describes how to install and configure servers andworkstations for Domino Unified Communications Services and how toenable subscribers.

Overview of installing and configuring DUCSTo create interoperability between the Avaya Unified Messenger and IBMLotus Domino infrastructures, you must complete the following proceduresin each Domino domain:

1. Install the DUCS server component.

2. Install the DUCS administration component.

3. Create an access control group for the voice servers.

4. Register each voice server as a Notes user, and add the voice servers tothe group.

5. Edit the ACL of the Domino Directory and the Administration Requestsdatabase.

6. Install Avaya Unified Messenger on each voice server.

7. Configure the Voicemail Domain Summary document.

8. Enable subscribers.

9. Install the DUCS client component.

Installing the DUCS server componentIn addition to copying server components and editing the NOTES.INI file to activate DUCS functionality, this installation procedure creates two newmail templates on the server: one for iNotes (UCINOTES.NTF) and one forNotes (UCMAIL5.NTF). The new templates are based on the template thatyou select during installation.

Unless your company uses a custom mail template, select MAIL50.NTF. If your company uses a custom mail template, select that template. Installdoes not destroy any customizations; rather it creates a new template that is based on the template you specify and that includes design elements thatsupport DUCS.

9

You must install the DUCS server component on:

• Each mail server that hosts voice mail subscribers

• Each mail server in a cluster that hosts voice mail subscribers

• The Avaya Peer Mail Server, which is the Domino mail server thatstores the mail files for the Avaya voice servers

1. Before you begin:

a. Make sure that the server is running a supported version ofDomino. For information on the versions that DUCS supports, see the Release Notes.

b. Exit all Windows applications, and stop the Domino server.

2. From the DUCS CD, open the DUCS_Server folder, and clickSETUP.EXE.

3. Follow the on-screen instructions in the setup program to install theserver component.

Installing the DUCS administration componentInstalling the DUCS administration component makes these changes to theDomino Directory:

• Adds fields used for Avaya Unified Messenger to the Other tab inthe Person document

• Updates the $PersonExtensibleSchema subform in the DominoDirectory

• Adds the view Avaya Voicemail Domains, which contains VoicemailDomain and Voicemail Domain Summary documents that arecreated when you install Avaya Unified Messenger

Before you begin the setup program, decide if you will update the$PersonExtensibleSchema subform automatically as part of the installationprocess or if you will manually insert a DUCS subform($AVUMExtensibleSchema) into the existing $PersonExtensibleSchemasubform. Manually inserting the subform ensures you will not lose anycustomizations that other programs may have made to the$PersonExtensibleSchema subform.

To install the administration component1. Before you begin:

a. Make sure that the workstation is running a supported version ofthe Domino Administrator or Notes client. For information on theversions that DUCS supports, see the Release Notes.


b. Switch to a Notes ID that has Designer or higher access to theadministration server for the Domino Directory. Note that after you start the install program, you cannot switch to another ID.

c. Make sure that you have access to the DUCS-enabled server andthat it is running.

d. Exit all Windows programs, including the Notes client and theDomino Administrator.

2. From the DUCS CD, open the DUCS_Admin folder, and clickSETUP.EXE.

3. Follow the on-screen instructions in the setup program to install theadministration component.

To insert the $AVUMExtensibleSchema subform manuallyPerform this task only if you choose not to update the$PersonExtensibleSchema subform automatically when you install theDUCS administration component.

1. From the Domino Designer, open the Domino Directory design forediting.

2. Choose Shared Code - Subforms.

3. Open the $PersonExtensibleSchema subform.

4. Move the pointer to the location in the subform where you want toinsert the DUCS customizations.

5. Choose Create - Insert Subform, and choose $AVUMExtensibleSchemaas the subform to insert.

6. Save the $PersonExtensibleSchema subform, and close.

To manually update the Domino DirectoryIf, while installing the administration component, the setup program cannot update the Domino Directory, you can do so manually after youinstall the component. The following are the design components to copyfrom AVUCADMIN.NTF.

FormsVoiceMail Domain

VoiceMail Domain Summary

ViewsAvaya Voice Mail Domains

($UMUsers)

($VoiceMailSummary)

Chapter 2: Installing and Configuring 11

Subforms$AVUMExtensibleSchema

$PersonExtensibleSchema (optional, can modify existing one)

Creating an access control group for voice serversVoice servers need access to subscriber mail files, the Domino Directory,and the Administration Requests database. To simplify administration, for each Avaya Voicemail Domain, create a group and add all of the voiceservers from the domain to the group.

1. Create a group named, for example:xxx_ACL_Group

Where xxx identifies the Voicemail Domain

2. Add the group to the Domino Directory in each Domino domain thatservers in the Avaya Voicemail Domain access.

Registering Avaya voice servers as Notes usersYou register each Avaya voice server as a Notes user. Then each voiceserver has a user name and mail file, both of which Avaya UnifiedMessenger uses to route voice messages from the voice server to theDomino domain that is configured to be the Avaya Peer Mail Server.

Before you register each voice server, consider the following:

1. The Domino mail server that hosts the voice servers’ mail files is theserver that you configure as the Avaya Peer Mail Server. Because allvoice messages route through the Peer Mail Server before the Routertransfers them to the recipients’ mail files, review the location of theserver in the system topology. Choose a mail server that routes mailefficiently.

2. Decide on the format for the user name that you give to each voiceserver. Depending on the capabilities of the PBX at your site, the voice server’s user name may appear in the From field of every voicemessage. Consequently, when subscribers open their mail files, theInbox and the Voice Inbox will show the voice server’s name. To dispelconfusion among subscribers, use a syntax, such as the following, whenyou assign the user name to the voice server:xxx Voiceserver

Where xxx uniquely identifies the specific voice server — for example,Atlanta Voiceserver

3. When you register each voice server, you must:

• Specify UCMAIL5.NTF as the mail file template


• Choose not to use password expiration

4. Be sure to add each voice server to the voice server access controlgroup.

To register the Avaya voice servers, use the basic Notes user registrationprocess. For more information on registering users see Administering theDomino System or Domino 5 Administration Help.

Editing the ACL of the Domino Directory and the AdministrationRequests database

You must set up the ACLs of the Domino Directory and the AdministrationRequests database so that voice servers and administrators have the correctlevel of access.

Voice servers require access to the Domino Directory so that they can create Voicemail Domain and Voicemail Domain Summary documents and update Person documents. Voice servers require access to theAdministration Process database so that they can create requests, asneeded.

Administrators need access to the Domino Directory so that they haveaccess to the DUCS-specific portions of Person documents. They needaccess to the Administration Requests database so that they can enablesubscribers.

To edit the ACL of the Domino Directory1. Create roles named UMAdmin and UMServer.

Because role names are case-sensitive, you must name them exactly as specified here.

2. Add the voice server access control group to the ACL and give it:

• Author or higher access and the Create documents privilege

• UMAdmin and UMServer roles

• The user type PersonGroup

3. Assign this access to all administrators who will enable DUCSsubscribers:

a. Editor or higher access

b. UMAdmin and UserModifier roles

To edit the ACL of the Administration Requests databaseGive Author or higher access and the Create documents privilege to thevoice server access control group and to all administrators who will enableDUCS subscribers.


Installing Avaya Unified Messenger on voice serversFor complete information on installing Unified Messenger on voice servers,see the Avaya Unified Messenger Solution — IBM Lotus Domino versionInstallation Guide, available from Avaya.

Configuring the Voicemail Domain Summary documentWhen you install Avaya Unified Messenger, Voicemail Domain andVoicemail Domain Summary documents are created in the DominoDirectory that is on the Avaya Primary Directory Server. Every DominoDirectory that is on an Avaya Secondary Directory Server stores only aVoicemail Domain Summary document.

You use the Avaya Voice Mail System Configuration application toconfigure these documents — for example, to specify whether the voiceservers in an Avaya Voicemail Domain support features such as MessageWaiting Indicator (MWI) and client notifications. For complete informationabout configuring these documents, see Avaya Unified MessengerAdministrator’s Guide, available from Avaya.

To configure the Voicemail Domain Summary documentIn Domino, you must enter the name of the voice server access controlgroup into each Voicemail Domain Summary document. Doing so allowsyou to assign a Voicemail Domain to subscribers when you enable them.

1. Open the Avaya Voicemail Domains view in the Domino Directory, and then open the Voicemail Domain Summary document.

2. In the ACL Group field, enter the name of the voice server accesscontrol group.

Enabling a subscriber for Unified MessengerWhen you set up the Voicemail Domain Summary document in AvayaUnified Messenger, you can specify that default settings appear for eachsubscriber, and you specify which Unified Messenger features to makeavailable for subscribers in the Voicemail Domain. In Domino, the defaultsettings appear in the subscriber’s Person document. For information aboutsetting up the Voicemail Domain Summary document, see Avaya UnifiedMessenger Administrator’s Guide, available from Avaya.

After you enable subscribers, notify them about the documentation thatdescribes using DUCS and Unified Messenger. Using iNotes and Noteswith DUCS is described in an online Help file. Using the TUI to access thevoice server is described in this documentation, available from Avaya:

• Avaya Unified Messenger Online TUI Guide

• Avaya Unified Messenger At-a-Glance Guide


• Avaya Unified Messenger Wallet Guide

1. Before you begin, do the following:

• Make sure that you have Editor or higher access in the ACL of theDomino Directory and the UMAdmin and UserModifier roles.

• Make sure that you have a Notes client or Domino administrationclient with either the DUCS client or the DUCS administrationcomponent installed.

• Know the Avaya Voicemail Domain to which the subscriber belongs.

2. Open the subscriber’s Person document.

3. On the Other - Basics tab, click Enable.

4. Complete these fields:

If the selected Voicemail Domain specifies a defaultpassword, it appears here. If the selected Voicemail Domain specifies a randomlygenerated password, one is generated and appearshere.If the selected Voicemail Domain does not specify adefault password, enter one.

TUI Password

Enter a number that is unique within the Dominodomain and is different from the number entered inthe Mailbox Number field.For more information on specifying this number, seeAvaya Unified Messenger Administrator’s Guide.

Numeric Address

By default, this number is taken from the Office phonefield on the Person document.

Extension Number

By default, this number is taken from the Office phonefield on the Person document.

Mailbox NumberSelect the subscriber’s Avaya Voicemail Domain.Voice Mail DomainActionField

5. Click the Advanced tab and then enable the features that you want tomake available for this subscriber to use. What appears available onthis tab depends on how you set up the Voicemail Domain Summarydocument in Avaya Unified Messenger.

6. Click the Basics tab and make sure that the “Format preference forincoming mail” field is set to No Preference, Prefers MIME, or Keep inSender’s Format.

7. Save the Person document. Domino does the following:

a. Validates the values set in the Person document.


b. Generates an e-mail alias from the value in the Numeric Addressfield. The alias is in the format UM_NUMERIC:xxx, where xxx is thevalue in the Numeric Address field. This alias is appended to thelist of names in the User Name field on the Basics tab of thesubscriber’s Person document.

c. Hashes the TUI Password for security.

d. Creates the administration request “Unknown Request 5001” in theAdministration Requests database on the current server to enablethe subscriber for DUCS. The request is passed to UCAdminp tocarry out the request on the subscriber’s mail server.

8. Check the Administration Requests database to make sure that therequest was completed for this user.

9. Check the Avaya voice server to make sure that it recognizes that thissubscriber is enabled. For information on checking that a user isenabled for Unified Messenger, see Avaya Unified MessengerAdministrator’s Guide.

10. Click Avaya Unified Messenger Options. The list of options availablefor this subscriber depends on what was specified in the VoicemailDomain Summary document and what you made available in thesubscriber’s Person document.

11. Click the options you want to enable for this subscriber.

Note that to use an enabled option, the subscriber may need to chooseActions - Avaya Unified Messenger Options to configure it. If an optionis not both enabled in the Person document and configured in AvayaUnified Messenger Options, the option may not be available for use.

Disabling a subscriber or making a subscriber inactiveOccasionally you need to disable a subscriber — for example, if thesubscriber leaves the company. Disabling a subscriber permanently deletesall subscriber information from the system, the result being that thesubscriber can neither receive nor access voice messages. After you disablea subscriber, you can reassign that subscriber’s telephone number tosomeone else.

Making a subscriber inactive turns off the subscriber’s account but does not delete the subscriber’s information from the system. Consequently, thesubscriber is not able to receive nor access voice messages until you changehis status to enabled. You might make a subscriber inactive when he takesan extended vacation or sabbatical and doesn’t want to receive or accessvoice messages during that time.

1. Before you begin, do the following:


• Make sure that you have Editor or higher access in the ACL of theDomino Directory and the UMAdmin and UserModifier roles.

• Make sure that you have a Notes client or Domino administrationclient with either the DUCS client or the DUCS administrationcomponent installed.

2. Open the subscriber’s Person document.

3. On the Other - Basics tab, do one of the following:

• Click Disable to remove the subscriber’s information permanently.

• Click Inactive to turn off the subscriber’s account temporarily.

4. Save the Person document.

Installing the DUCS client componentYou install the DUCS client component on the Notes client machine ofevery user whom you will enable for DUCS. This procedure copies DUCSprogram files to the workstation and replaces the design of the mail filewith the DUCS mail file design. For Notes subscribers, the mail file isreplaced by the design of UCMAIL5.NTF. For iNotes subscribers, the mail file is replaced by the design of UCINOTES.NTF.

If you choose not to replace the mail file design during the installationprocedure, you must later manually update the design.

1. Before you begin:

a. Verify that the DUCS-enabled server is running and that you canconnect to it.

b. Exit all Windows programs, including the Notes client.

2. From the DUCS CD, open the DUCS_Client folder, and clickSETUP.EXE.

3. Follow the on-screen instructions in the setup program to install theclient component.

Updating the design of the mail file manuallyIf you choose not to replace the mail file design when you install the clientcomponent, you must use this manual process to update the design beforesubscribers can use DUCS.

From Domino Designer, copy the following design elements fromUCMAIL5.NTF to the mail file or mail template to update:

FormsUCDisplayInfo | fa_UcDisplayInfo

Voice Message | fa_VoiceMail | fa_VoiceMessage


(Display Received Voice Message) | fa_RcvdVoiceMail

(UCMemo) | UCMemo | fa_UCMemo

ViewsVoice Inbox

($UCInbox)

SubformsUCPlayer | sa_ucPlayer

(DisplayFwrdContent) | sa_DisplayFwrdContent

(UCVoiceNote) | sa_VoiceNote

(VoiceDeliveryOptions) | sa_VoiceDeliveryOptions

Script librariesCoreUCClasses

CoreUCStrings

Unified Communications

Imagesact_EDIT.gif

act_LISTEN.gif

phone.jpg


Chapter 3Reference

This chapter describes DUCS-specific NOTES.INI settings, servercommands, and server tasks.

DUCS NOTES.INI settingsThe following are NOTES.INI settings that you can use with DUCS.

AddinmenusSyntax: Addinmenus=navaddin

Description: Required setting that launches Avaya Unified MessengerOptions from the DUCS client.

Applies to: Clients

ExtMgr_AddinsSyntax: ExtMgr_Addins=uxextn

Description: Required setting that adds the file uxextn (for the server) orucclient (for the client) to the ExtMgr_Addin setting in the NOTES.INI file.

Applies to: Servers

ServerTasksSyntax: ServerTasks=UCEvent, UCAdminp, AVUMHlr

Description: Required tasks that are automatically added to the ServerTaskssetting in the NOTES.INI file.

Applies to: Servers

Trace_UC_AllSyntax: Trace_UC_All=1

Description: Generates information that may be required by Lotus softwaresupport to diagnose system problems. The names of the files are in thesyntax UCTASKNAMEx.OUT, where TASKNAME is the name of aDUCS-specific server task and x is a number.

19

Applies to: Servers and clients

Trace_UC_DirSyntax: Trace_UC_Dir=path

Where path is a directory path.

If you don’t specify a path or the specified path doesn’t exist, trace files arestored in the TMP or TEMP directories. The log file (LOG.NSF) recordswhich directory stores trace information.

Description: Generates information that may be required by Lotus softwaresupport to diagnose system problems.

Applies to: Servers

UCLogLevelSyntax: UCLogLevel=value

Where value is one of the following:

0 — None

1— Minimal

2 — Normal

3 — Informational

4 — Verbose

Description: Specifies the level of detail recorded in the log file (LOG.NSF).

Applies to: Servers and clients

Default: UCLogLevel=1

DUCS Tell commandsThis table describes additional Tell commands you can use with DominoUnified Communications Services. For information on the basic Tellcommand, see Administering the Domino System or Domino 5 AdministrationHelp.

Log current operating statisticsTell UCEvent statsLog currently registered handlersTell UCEvent handlersResultCommand


DUCS server tasksThe following table describes DUCS-specific server tasks.

ServerTasksHandles Avaya-specificevents on a server

AVUMHlrDUCS EventHandler for Avaya

ServerTasksMonitors DUCS-specificevents on a server

UCEventDUCS EventMonitor

ServerTasksProcesses DUCS-specificadministration requests

UCAdminpDUCSAdministrationProcess

Default inNOTES.INI file

DescriptionCommand torun task

Task

Chapter 3: Reference 21

AACL

voice servers and, 12, 13Addinmenus

described, 19Administration Requests database

editing ACL of, 13Administration, DUCS

installing, 10Avaya Unified Messenger

documentation, 1, 14installing, 14Peer Mail Server, 2Primary Directory Server, 3Secondary Directory Server, 3

Avaya Unified Messenger Optionsenabling, 16

CClient, DUCS

installing, 17

DDomino Directory

documents, 14editing ACL of, 13updating design of, 11

Domino Unified CommunicationsServices. See DUCS

DUCScomponents of, 3Domino Directory and, 11, 13installing, 1, 9, 10mail file design and, 17NOTES.INI settings, 19

EExtension number, 15ExtMgr_Addins

described, 19

IInstalling

Avaya Unified Messenger, 14DUCS, 17voice servers, 14

MMail file

updating design of, 17Mailbox number, 15

NNOTES.INI settings

list of, 19Numeric address, 15

OOptions

enabling, 16

PPeer Mail Server

defined, 2Person documents

voice mail and, 14PersonExtensibleSchema, 11Primary Directory Server

defined, 3

RRegistering

voice servers, 12

SSecondary Directory Server

defined, 3Server tasks

list, 21Server, DUCS

installing, 9

ServerTasksdescribed, 19

Subscribers, voice maildisabling, 16enabling, 4, 14

TTell commands

DUCS, 20Topology

voice mail, 1Trace_UC_All

described, 19Trace_UC_Dir

described, 20TUI password, 15

UUCLogLevel

described, 20

VVoice mail

accessing, 7call-answering, 6subscribers and, 4, 14, 16topology, 1

Voice mail domain, 15Voice servers

access control and, 12, 13installing, 14registering, 12

Voicemail Domain documentscreating, 14

Voicemail Domain Summarydocuments

configuring, 14creating, 14

23

Index

domino unified communications services for avayafile/avucadminguide.pdf · • avaya unified...

Documents