Quick Configuration Tool

The installation script discussed in the previous chapter automates the loading of uOne software packages, including the Quick Configuration tool. The Quick Configuration (quickconfig) tool automates the configuration of the platform and initial the LDAP database setup, as well as the uOne application environment. This tool assists in ensuring that all necessary areas are not overlooked. However, in many deployment scenarios, the final operational configuration may involve further editing of certain files. Refer to the later chapters of this document and the uOne Back End Servers Reference Manual, as needed.

Note The quick configuration tool is the recommended method for configuring uOne. Although this manual provides much information concerning various aspects of uOne configuration and integration, it is provided as a resource to make modifications to your system once it is operational rather than for configuring uOne initially.

Background

The Quick Configuration (quickconfig) tool is an initial configuration tool. In addition, it may be run as often as needed; however, only the most recent configuration takes effect as it overwrites any previous configurations. The applications can be installed independently. In fact, they most likely will not be installed on the same server. Before running, the quickconfig tool will back up any previous configuration locally to a cpio file.

If a process cannot be automated, the Quick Configuration tool echoes a note to the user that a manual change must be performed in order for this feature to work. The Quick Configuration tool configures all of the software components as a whole and not just a subset of them. For example, the tool assumes CMA must be configured every time when setting up a uOne host. When software is optional (for example, MWI), the user will be prompted.

The quickconfig tool sets up uOne Administration separately if requested. The tool asks the questions necessary as they relate to the directory and messaging servers. In addition, the directory server still needs to be setup with the appropriate schema and indexing attributes.

The quickconfig tool confirms that the certified platform and application releases are valid. It also provides two scripts—ldapsetup.sh and ldapsetup.swc—to provision the database with the proper groups, communities, permissions, and users in order for uOne and uOne Administration to function properly.

Note For Intermail setup, you must run ldapsetup.swc in conjunction with the correct script file for the installed version of Intermail: kw42.sh, mx50.sh, or mx51.sh.

Note You must install and configure the directory and messaging servers are already installed and configured according to the uOne Back End Servers Reference Manual prior to running the quickconfig tool. Information related to these servers is required to successfully use the configuration tool.

Prerequisites

On the gateserver where you will run the quick configuration tool, ensure that the required platform and application packages are installed.

Note Depending on which option you choose, the corresponding table below should be filled out prior to using the quickconfig tool. The Notes column is available for this purpose and will greatly facilitate the process. However, note that information presented in the tables will not always correspond to the order in which the questions are presented on the screen.

Steps

Step 1 This tool must be run as superuser.

Step 2 The uoneqcfg package installs the executable in the $HOME/quickconf/scripts directory.

Step 3 Once in this directory, issue the following command:
./quickconfig

Overview

Table 6-1: Capabilities of Quick Configuration Tool

Does Does Not

Initial installation only - not reconfiguration. If it is run multiple times, only the most recent configuration is used. The location of previous configuration files is displayed when the tool is executed.

Checks and validates that the certified platform and application releases are installed. It does not install interim patches. Check the uOne Release Notes for further instructions about interim patches.

Set up back end servers (i.e., messaging, directory, paging, etc.). These servers should be set up prior to running this tool, as information from these servers will be needed during configuration.

Configure complex installations to include sophisticated dial plans.

Does	Does Not
Initial installation only - not reconfiguration. If it is run multiple times, only the most recent configuration is used. The location of previous configuration files is displayed when the tool is executed. Checks and validates that the certified platform and application releases are installed. It does not install interim patches. Check the uOne Release Notes for further instructions about interim patches.	Set up back end servers (i.e., messaging, directory, paging, etc.). These servers should be set up prior to running this tool, as information from these servers will be needed during configuration. Configure complex installations to include sophisticated dial plans.

The main menu has seven options:

1. Configure uOne System for calls (includes Notification and FaxPrint if selected)

2. Configure uOne Subscriber Administration tool (Netscape 4.1)

3. Configure uOne Subscriber Administration tool (InterMail Mx 5.0 Rel. 10)

4. Configure uOne Subscriber Administration tool (InterMail Mx 5.1)

5. Configure uOne Subscriber Administration tool (InterMail Kx 4.2)

6. Configure uOne Manager

7. Exit - You may run quickconfig later

Note If the uOne software is already installed and running, be sure to stop it before continuing with the quickconfig tool.

After the uOne software has been shut down—

Do you wish to perform required and non-required operating system setup for UCS?

Currently, answering yes to this will only set up the NTP daemon.

Do you wish to configure this server to be a Network Time Protocol (NTP) client? If yes, you will need to provide an NTP server name or IP address.

Option 1 - Configure uOne System for calls

The following table specifies entries necessary for configuring the uOne system. This includes notification and faxprint services.

Table 6-2: Information Needed When Running the Quickconfig Tool

Item Detail Available Entries Notes

SNMP & BASE

Configure Autorestart

This will enable the ACB (BASE) agent and static applications to restart without manual intervention. Also, the agent/applications will be restarted after a reboot.

On, Off

SNMP traps

Send traps for ACB and agent transitions, or application events.

Yes, No

Note   If Yes, you will be prompted for the following parameter (SNMP Manager).

SNMP Manager

The name of the SNMP Manager where traps are directed.

Valid SNMP Manager name.

Network Logging Server

The name of the Network Logging Server.

Name of the Network Logging Server that does not include the domain name.

ACB (APP) Object

MWI Token Routing

Allows the system to send MWI_Off toggles to the actual system with the SMSI link.

Yes, No

If yes, must answer the the next two entries.

MWI Route Token

Defined by mapping the first part of a telephone number to a system that has an SMDI link.

Valid telephone number prefix.

MWI host

Host that will receive the MWI signal.

Valid host name.

Voice Ports

Enter maximum number of voice ports for incoming calls.

Minimum value is 24
Maximum value is 96.

If 48 or higher, must run the file /etc/rc2.d/S99uonetune to tune the kernel.

CMA (TNT)

Gatekeeper Registration

Registration is needed if the system is engineered to have calls coming through a gateway.

Yes, No

If yes, must input the gatekeeper IP address, tech-prefix and H323 node id. If no, must input the gateway IP address.

Voice Encoding Format

If Mulaw is selected, must answer the next entry.

Silence Compression Setting

If enabled, then the DialPeer must be configured to enable silence compression (vad).

Note   The Cisco 5300, by default, sets compression to on. Ideally, it should be set to on here as well.

On, Off

DTMF Detection

Type of detection required by the node.

RTP, FFT, H245, DEFAULT

Note   If G729 was selected for voice encoding, this option will be automatically set to the Default DTMF detection, and this screen will not be shown.

If RTP is selected, then the DialPeer must be enabled to allow RTPDTMFRelay.

Gateway IP Address

IP address through which the gateway routes all outbound calls.

Valid IP address.

Gatekeeper IP Address

IP address for the gatekeeper.

Valid IP address.

Note   If gatekeeper is present, you will be prompted for the following two parameters (Tech-Prefix and H323 node).

Tech-Prefix

The prefix that identifies the gateserver to the gatekeeper.

Usually in the format of 2#.

H323 Node Id

The name that will identify this server to the gatekeeper.

Valid server name.

Send Outbound Fax(es)

Enables this system to send outbound fax(es).

Yes, No

Note   If Yes, you will be prompted for the following parameter (gateway), as well as all Fax admin parameters.

Fax Gateway

Name of the gateway server that will send outbound faxes.

Valid gateway server.

TTS

Will system support TTS capabilities?

Yes, No

Switch/Voice Bridge

System connected to either of these devices for the purpose of sending MWI.

Yes, No

Note   If Yes, the following four parameters must be addressed.

Baud Rate

19200, 9600, 2400, 1200

Data Bits

8,7,6

Parity

None, Even, Odd

Stop Bits

1,2

Hardware Flow Control

Off, On

UNIFIED MESSAGING

Directory Server
(LDAPhost)

The name of the LDAP host.

Valid Directory Server Name (DSN).

Bind DN
(LDAPBindDn)

Authority to bind to the Directory Server.

Valid bind entry.

Directory Manager Password
(LDAPDnPassword)

The e-mail password of the above authority.

Valid e-mail (IMAP) password.

Directory Search Base
(LDAPSearchBase)

The DN of the organizational community entry from which uOne can see all the entries that are to be accessed.

Valid search base:

o=
or
ou= ,o=

Messaging Server Type

Messaging server platform.

Netscape 4.1
InterMail MX 5.1
InterMail KX 4.2

Activate Personal Access Support (SNAMode)

Allows Personal Access to be available to subscribers.

Enabled/Disabled

Paging Notification

Do you want paging notifications sent to a Paging Server on SNR attempts?

Yes, No

Initial Application

Scheduled application to be launched.

UM

Note   TELdemo is available for test purposes only.

DNIS/RDNIS

This is the number (token) needed to launch UM or TNTdemo agent.

Valid 1-10 digit number.

Fax Admin

FaxAdmin account name.

Valid FaxAdmin account.

Mail Server of the Fax admin account.

Valid Messaging Server.

FaxAdmin account password.

Password for FaxAdmin account.

Name of the FaxPrint IMAP retry folder.

Postmaster address for FaxPrint errors.

Note   Faxes will not print unless Fax Services are enabled via the COS and the DialMap.ini file is configured correctly.

Notification Entries

SMS services

Yes/No

Note   If yes, the following three parameters must be addressed.

SMS administration account

Valid account name.

Messaging Server

Valid host name.

Postmaster e-mail address for returned message notification via SMS attempts

Valid e-mail address.

Notification requests

Yes, No

Note   If yes, next two entries will need to be entered.

If Yes, run MWI_OnOff (which receives request from MWI_PassOff)

Messaging Server Name

Valid host name.

Postmaster e-mail address for returned message notification via SMS attempts

Valid e-mail address.

Note Reboot for all changes to take effect.

Options 2, 3, 4 and 5 - Setup uOne Administration tool for Subscriber Administration

The following table concerns entries necessary for setting up the uOne Administration tool for Subscriber Administration.

Table 6-3: Setup uOne Administration Tool for Subscriber Administration

Item Detail Available Entries Notes

Intermail or Netscape Directory Server

Name

Root Bind DN

Designated during Directory Server installation.

Root Bind DN Password

Designated during Directory Server installation.

Root Search Base

Note This screen will not be shown for Intermail options (3, 4 and 5).

Designated during Directory Server installation.

Community Search Base

Reference ou=

Community group

Reference unique location of uOne Administration users.

uOne Administration (UMSA) authority name

Reference unique name.

Netscape Messaging Server

Name

Supported Mail Domain Name

Designated during Messaging Server installation

uOne Administration Login Name

uOne Administration login

Note The appropriate ldapsetup script (ldapsetup.sh or ldapsetup.swc) for your installation will need to be run. See previous note relating to Intermail .

Option 6 - uOne Manager

The following table specifies entries necessary for configuring uOne Manager.

Table 6-4: Information Needed for uOne Manager Setup

Item Detail Available Entries Notes

SNMP Setup Information

Configure Autorestart

This will enable the ACB (BASE) agent and static applications to restart without manual intervention. Also, the agent/applications will be restarted after a reboot.

On, Off

SNMP Traps

Send traps for ACB and agent transitions, or application events.

Yes, No

Note If Yes, you will be prompted for the following parameter (SNMP Manager).

SNMP Manager

The name of the SNMP Manager where traps are directed.

Valid SNMP Manager name.

Hostname

Enter hostname of 1 uOne server to be managed by uOne Manager.

Community Search Base

uOne Manager will be set up initially to manage 1 uOne community. Enter the community search base to be managed by uOne Manager.

Reference ou=

Table of Contents

Quick Configuration Tool