Table of Contents

C.1 Before You Start
C.2 Working with UNIX

C.2.1 Logging In
C.2.2 Changing Your Password
C.2.3 Getting help in UNIX

C.3 Software Directory Map

UNIX System Operation

The telephony controller software runs on a Sun host server using the UNIX operating system. This chapter provides a basic overview of UNIX commands. It also provides a directory map of the telephony controller software.

C.1 Before You Start

You must set up your UNIX shell environment, transpath group, and users. See "Preparing Your Telephony Controller," for more information.

C.2 Working with UNIX

The Sun host computer uses the UNIX operating system. UNIX has the following characteristics:

• UNIX is case-sensitive

• UNIX allows multi-tasking

• UNIX is a multi-user system

To work in UNIX, you must have a user ID and password assigned to you by your system administrator. You can log in directly to your host machine or connect with a telnet session from another terminal.

C.2.1 Logging In

To log into your telephony controller:

Step 1 Connect to your host computer directly or via telnet.

Step 2 At the login: prompt, type your user ID.

Step 3 At the Password: prompt, enter your password. The system displays the UNIX prompt. The following example shows a log in session.

login: scuser
Password:
Last login: Fri Jan 22 11:22:12 from va-dhcp196-236.c
Sun Microsystems Inc.   SunOS 5.5.1     Generic May 1996
va-test%

C.2.2 Changing Your Password

It is a good idea to change the password given to you by your system administrator after 30 days. To change a password in UNIX:

Step 1 At the UNIX prompt, enter passwd. The system requests your current password.

Step 2 Enter your current password.

Step 3 The system requests your new password. Enter the new password.

---

Note Your password must have at least 6 characters, and only the first 8 characters are recognized. Your password must contain at least 2 alphabetic characters and at least 1 numeric or special character. Your password must differ from your user login name and any reverse or circular shift of that login name. For example, if your login name is josephl, you cannot use lhpesoj for your password. Your new password must differ from your old password by at least 3 characters. Uppercase and lowercase versions of the same letter are not considered different.

---

If the system accepts your password, you are prompted to re-enter the new password. The system compares the two new passwords. If they match and meet all of the password requirements, the new password is accepted.

If the new password does not meet accepted requirements, it is rejected. You are prompted up two times more for a correct new password. If you do not enter the correct password, the system returns you to the command prompt. Continue using your old password.

Step 4 Re-enter your new password. The system returns a message that your password has been changed.

C.2.3 Getting help in UNIX

UNIX provides online help for standard UNIX commands. Each help page is called a man (MANUAL) page. Man pages contain the command name, usage, and proper syntax. To access help on any UNIX command, perform the following steps:

Step 1 At the UNIX prompt, enter man <command name>. For example, to get information on the cp command (used to copy files), enter man cp.

Step 2 Press the space bar to scroll through the man page on the cp command.

Step 3 Enter q to exit the man page.

C.3 Software Directory Map

This section presents the directory map of the software along with a brief description of the purpose of each directory. This section is useful for finding files referenced in the operating procedures.

During installation procedures, the user is asked for a base directory location to install the software (the default is /opt). The TransPath directory is created under the base directory and contains everything in the database.

Within the /opt/TransPath directory, the following subdirectories are created.

Subdirectory	Contains
/bin	Executable programs provided by Cisco Systems that cannot be customized.
/local	Executable programs provided by Cisco that can be modified to reflect site-specific requirements. See the procedures for customizing files. Generally the default values are sufficient.
/data	MDL source files (if provided).
/dialPlan	Dial plan provisioning files.
/dialPlan/DPP_ CONFIG_LIB	Configuration file library (a simple version control system for dial plan configuration changes).
/etc	All configuration files required for proper operation of the system. These are the .dat files listed in "Configuration Data File Reference."
/etc/CONFIG_LIB	Configuration file library (a simple version control system for configuration file changes).
/dialPlan/STAGING	Dial plan log file(s).
/lib	MDL object files. These are the executables that are created from the MDL source files and are dynamically loaded by the engine at run-time.
/snmp	SNMP configuration files and management information base file.
/var	All files and devices providing communications between the various subsystems of the software. Also contains the files providing persistent storage of data.
/var/log	Command, alarm, platform, and current dumper logs.
/var/spool	Historic dumper logs.
/var/trace	All signal path trace logs used for conversion analysis.

Posted: Wed Apr 28 11:57:07 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.