cc/td/doc/product/voice/uone/srvprov/r41s
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Setting up UMSA/PMA

Setting up UMSA/PMA

Unified Messaging System Administration (UMSA) is a web-based tool that simplifies system administration tasks. It is designed to hide the complexities of adding information to the Directory Server and Messaging Server. You use UMSA to provision system-wide resources, such as FaxPrint, and Greeting Administrative mailboxes, as well as, adding, modifying and deleting Class of Service and individual users.

Personal Messaging Administration (PMA) is a web-based tool that subscribers use to set up options for their Unified Messaging mailboxes.For instance, subscribers can choose how to be notified when new messages arrive in their mailboxes, manage distribution lists, and set up various mailbox preferences.

There are six UMSA/PMA .ini files that need to be configured. These files include:

Prerequisites

Before you start UMSA/PMA, ensure that the following tasks have been completed.

Engineering Considerations

You can install the UMSA application on any HTTP Server. In large configurations, it is recommended that you install it on a standalone HTTP Server with at least one backup server for standby. To switch to the standby server, a DNS administrator would switch the http name to the second box and the ini files would have to be copied to the new system.

Upgrade issues

When you upgrade to UM 4.1S, we recommend that you copy the schemaConfig.ini file to a safe location and merge it with newly installed schemaConfig.ini file after upgrading UMSA/PMA files. The other ini files are not affected by this upgrade.

When UMSA is installed, the .ini files are placed in the MSGdata/Samples directory. The installer must copy the files to the MSGdata directory and then edit them appropriately.

Administering UMSA/PMA


UMSA and PMA are typically set up during the initial configuration of your uOne system.

Editing the schemaConfig.ini File

To edit the schemaConfig.ini, follow these steps:

Step 1 Go to the GateServer where the schemaConfig.ini file resides for UMSA/PMA.

Step 2 Login as spmaster.

Step 3 Type:
cd /home2/spmaster/ADMIN/cgi-bin/MSGadmin/MSGdata.

Step 4 Edit schemaConfig.ini files and set the following attributes (Table 2-1).

[lastLDAPHostAccessed]
host=

[<LDAP Hostname>]
port
=
rootPasswd
=
rootDN
=
searchBase
=
authoritySearchBase
=
serverSearchBase
=


Note You must add these attributes for UMSA
to work properly.


Table 2-1: schemaConfig.ini Attributes
Attribute Description Valid Values

[lastLDAPHostAccessed]

The current Directory Server label.

Should not be edited.

host=<LDAP Server Address>

The domain name of the current Directory Server.

A valid domain name.

[<LDAP Hostname>]

A Directory Server information section label.

A valid domain name. At least one Directory Server information section must match the Directory Server stated in the [lastLDAPHostAccessed] section.

port=<LDAP Server Port Number>

The port on which the slapd (LDAP daemon) is running.

Default=389

rootPasswd=<Root Password>

The password of the Directory Server.

Must be the same as the password that was entered when the Directory Server was configured.

Default=N/A

rootDN=< Root DN>

The authority to bind to the directory and to have sufficient privileges to perform all the operations required for the server.

Typically, cn=Directory Manager

Must be the same as the root DN that was entered when the Directory Server was configured.

searchBase=<Search Base>

The top node of the server.

For example, o=Organization

Default=N/A

authoritySearchBase=

Indicates where to start looking for the authority name record.

For example, ou=Root, o=Organization

Default=N/A

serverSearchBase=

Indicates where to start looking for the host name(s) of the mail server(s).

For example, o=NetscapeRoot

Default=N/A

Editing the languagesData.ini File

The uOne product supports multiple languages. Administrators can select the subscriber's preferred language for speaking prompts and e-mail over the telephone.

Administrators use the Preferred Language field on the Add a Subscriber and Modify a Subscriber pages to assign a preferred language for the subscriber. This field displays in a drop-down list box with the language options. Typically, the options in the languageData.ini file are set up during the initial configuration of the system.

Modifying the Language Options

Step 1 Go to the GateServer where UMSA and PMA reside.

Step 2 Login as spmaster.

Step 3 Type:
cd /home2/spmaster/ADMIN/cgi-bin/MSGadmin/MSGdata.

Step 4 Edit languageData.ini files and set the following attributes (Table 2-2).

[preferredlanguage]
numOfOptions=<XX>
option<YY>=<value>,< location>
defaultValue=<value>


Figure 2-1: Example of a languageData.ini file


Table 2-2: languageData.ini Attributes
Attribute Description Valid Values

[preferredlanguage]

The options list label.

Should not be edited.

NumOfOptions=<XX>

The number of language options that will be displayed in the options list. Ensure that this value matches the number of listed language options.

XX—the number of languages to be displayed.

option<XX>=<Value>, <text string>

<XX> indicates the order in which the options will appear in the drop-down list box for the Preferred Language field on the UMSA screen.

<Value> is the data that is going to be stored in the LDAP database

<Text string> is the name of the language that will appear in the drop-down list box for the Preferred Language field.

XX—A number. Must be no gaps in the numbering of options. Must start with the number 1 and increase.

Value—alphanumeric characters. Do not use commas in the value

Text string—alphanumeric characters. Do not use commas in the name.

DefaultValue=<Value>

The <Value> of the option to be used for the default.

This field can be edited, but should not be removed.

A <Value> listed in this file.

Configuring UMSA/PMA Logging

To set up logging for UMSA/PMA, you perform the following tasks:

All UMSA/PMA log messages are written to the umsa_pma.log file in the home2/spmaster/ADMIN/logs directory.

Enabling the Logging Feature

To turn on UMSA/PMA logging, follow these steps:

Step 1 Go to the GateServer where UMSA and PMA reside.

Step 2 Login as spmaster.

Step 3 Type:
cd /home2/spmaster/ADMIN/cgi-bin/MSGadmin/MSGdata.

Step 4 Edit schemaConfig.ini file and set the following attribute to yes.

[FeatureSet]

Logging=yes

Setting up the Logging Options

Step 1 Go to the GateServer where UMSA and PMA reside.

Step 2 Login as spmaster.

Step 3 Type:
cd /home2/spmaster/ADMIN/cgi-bin/MSGadmin/MSGdata.

Step 4 Edit loggingData.ini files and set up your logging choices (Table 2-3). Figure 2-2 shows a sample loggingData.ini file.


Note You must add these attributes for UMSA/PMA logging to work.

Figure 2-2: Example of a loggingData.ini file


Table 2-3: loggingData.ini Attributes
Attribute Description Valid Values

[logging]

A section label. This section determines which features are enabled or disabled for logging.

Should not be edited.

billing

Determines whether billing log messages are written to the umsa_pma.log file.

yes/no

Default=no

informational

Determines whether informational log messages are written to the umsa_pma.log file.

yes/no

Default= no

logheader

Determines whether log headers are prepended to the log messages.

yes/no

Default=no

[informational]

A section label. This section lists the LDAP attributes to be tracked and logged.

Should not be edited.

attributes for the informational section

This is an optional section. If informational logging is set to yes and there are no entries under the [informational] section label, all LDAP attributes are tracked and logged when their values are changed

attribute=yes/no

A valid attribute from the schemaData.ini or the Amteva_data.ini files. If the attribute is set to "no", that attribute is not tracked and no informational logging is written to the log file.

Examples:
mailquota=yes
pagerenabled=yes

Accessing UMSA

To access UMSA, follow these steps:

Step 1 Open a web browser.

Step 2 Type the URL for UMSA:
http://<hostname>:<port>/MSGadmin

Example: http://host1:280/MSGadmin (See Table 2-4.)

The Unified Messaging System Administration login screen displays (Figure 2-3).
Table 2-4: Variables in UMSA URL
Variable Value Description Valid Values

Hostname

The host machine on which the Unified Messaging System Administration software resides.

A valid host name

Port

The port on the host machine on which the UMSA software resides. This port is assigned in the /home2/spmaster/ADMIN/conf/http.conf file.

By convention, port 280 is used for accessing the UMSA.


Figure 2-3:
UMSA Login Screen

Step 3 Click in (or Tab to) the Email Address field and enter the e-mail address for your administrator account.

Step 4 Click in (or Tab to) the Email Password field and enter the e-mail password for your administrator account.

Step 5 Click on (or Tab to) Login.

The Welcome screen for the uOne System Administration interface displays (Figure 2-4).


Figure 2-4: UMSA Welcome Screen

hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon Sep 25 19:48:38 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.