Digi Digi CM 32 User manual

90000301_B
Digi CM
Users Guide

3
Copyright  Digi International Inc. 2003. All Rights Reserved
The Digi logo is a registered trademark of Digi International, Inc.
Connectware and Digi One are trademarks of Digi International, Inc.
Information in this document is subject to change without notice and does not
represent a commitment on the part of Digi International.
Digi provides this document “as is,” without warranty of any kind, either expressed
or implied, including, but not limited to, the implied warranties of fitness or
merchantability for a particular purpose. Digi may make improvements and/or
changes in this manual or in the product(s) and/or the program(s) described in this
manual at any time.
This product could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes may be
incorporated in new editions of the publication.

4

Contents 5
Chapter 1 Introduction
User Groups.....................................................................................................9
Username and Password...............................................................................10
Ways to Configure the Digi CM......................................................................10
Web Interface ...........................................................................................10
Configuration Menu ..................................................................................11
The Command Line Interface ..................................................................11
Ways of Accessing the Digi CM.....................................................................11
Web Interface Access Menu ....................................................................11
Port Access Menu ....................................................................................11
Direct Port Access ...................................................................................12
Custom Menus .........................................................................................13
Saving and Applying Changes.......................................................................13
Chapter 2 Getting Started
Introduction.....................................................................................................15
Assigning IP Settings .....................................................................................15
Configuring HTTP and HTTPS.......................................................................16
Access Using SSH.........................................................................................16
Adding, Editing, and Removing Users............................................................17
Shell Options ............................................................................................18
Using the Configuration Menu........................................................................18
Chapter 3 Installing and Configuring PC Cards
Introduction.....................................................................................................21
Compatible PC Cards.....................................................................................21
Adding a Compact-flash Card........................................................................21
Configuring the Compact-flash Card ........................................................22
Automatic Configuration File Backup .......................................................23
Adding a Network Card..................................................................................23
Adding a Wireless LAN Card..........................................................................24
Adding A Serial Modem..................................................................................25
Using the Configuration Menu........................................................................26
Chapter 4 Configuring Ports
Introduction.....................................................................................................27
Host Mode Configuration................................................................................27
Console Server Mode ..............................................................................27
Terminal Server Mode .............................................................................28
Dial-In Modem Mode ................................................................................28
Dial-In Terminal Server ............................................................................29
Configuring Host Mode...................................................................................29
Contents

6Contents
Supported Protocols.......................................................................................30
Port Parameters.............................................................................................30
DTR Settings ............................................................................................31
Inter-character Timeout ............................................................................31
Using the Configuration Menu........................................................................32
Chapter 5 System and Port Logging
Introduction.....................................................................................................33
Enabling System Logging Services................................................................33
Enable Syslog Server ..............................................................................33
Enable NFS Server ..................................................................................33
Enable A Compact-flash Card .................................................................34
Enable Digi CM Memory ..........................................................................34
Configuring System Logging Services ...........................................................34
Viewing System Logs ...............................................................................35
Port Logging...................................................................................................36
Viewing Port Logs ....................................................................................36
Using the Configuration Menu........................................................................37
Chapter 6 Alerts and Notifications
Introduction.....................................................................................................39
Configuring SMTP Alerts................................................................................39
SNMP Information..........................................................................................40
Configuring SNMP..........................................................................................40
Managing the SNMP Protocol........................................................................42
Using the Configuration Menu........................................................................42
Chapter 7 Configuring Security and Authentication
Introduction.....................................................................................................45
Configuring Network IP Filtering.....................................................................45
Console and Web IP Filtering ..................................................................46
Serial Port IP Filtering ..............................................................................46
Using IP Tables..............................................................................................47
Configuring User Access Control...................................................................47
Sniff Session ............................................................................................48
Viewing A Sniff Session ...........................................................................49
Authentication.................................................................................................49
Configuring Authentication Methods ..............................................................50
Using the Configuration Menu........................................................................51
Chapter 8 Custom and Default Menus
Introduction.....................................................................................................53
Making Custom Menus...................................................................................53
Adding Users ...........................................................................................53
Creating Menu Names .............................................................................54
Adding Menu Items ..................................................................................54
Assigning Users To A Menu ....................................................................56
Using the Configuration Menu........................................................................57

Contents 7
Port Access Menu..........................................................................................58
Chapter 9 Configuring Remote Dial-In Access
Introduction.....................................................................................................59
Configuring For Dial-In Modem Access..........................................................59
Adding a PC Modem......................................................................................60
Configuring For Dial-In Terminal Server Access............................................61
Using the Configuration Menu........................................................................62
Chapter 10 Port Clustering
Introduction.....................................................................................................63
Configuring Port Clustering............................................................................64
Assigning Master Clustering Mode ..........................................................64
Configuring Slave Ports on the Master Unit .............................................64
Clustering Parameters .............................................................................65
Using the Configuration Menu........................................................................67
Chapter 11 Command Line Interface
Introduction.....................................................................................................69
Linux Commands ...........................................................................................69
Important File Locations.................................................................................70
Default Script ...........................................................................................70
Booting Sequence ....................................................................................70
User Storage Space .................................................................................70
Chapter 12 System Administration
Introduction.....................................................................................................71
Upgrading the Firmware.................................................................................71
Web Interface ...........................................................................................71
Resetting Factory Defaults.............................................................................71
Setting Date and Time....................................................................................72
Configuring A Device Name...........................................................................73
Adding, Editing, and Removing Users............................................................73
Using the Configuration Menu........................................................................74
Accessing the Boot Loader Program..............................................................75
Hardware Test Menu ...............................................................................76
Disaster Recovery ....................................................................................76
Chapter 13 Hardware Information
Introduction.....................................................................................................79
Hardware Specifications.................................................................................79
Serial Port Pinouts ...................................................................................80
Ethernet Pinouts ......................................................................................80
LED Indicators................................................................................................81
Cable Adapters...............................................................................................82

8Contents
DB-25 Male Console Adapter ..................................................................82
DB-9 Female Console Adapter ................................................................83
DB-25 Female Console Adapter ..............................................................84
DB-25 Female to RJ-45 Pin Assignments ...............................................84
DB-25 Male Modem Adapter (Digi P/N 76000670) ..................................85
DB-25 Male Modem to RJ-45 Pin Assignment ........................................85
Chapter 14 Certifications
Safety.............................................................................................................87
Working Inside the Digi CM .....................................................................87
Replacing the Battery ...............................................................................87
Safety Instructions ...................................................................................87
Emissions.......................................................................................................88
Immunity.........................................................................................................88

Chapter 1 9
Introduction
The Digi CM (console management) device provides for secure, flexible
management of UNIX servers, routers, switches, and other networked
devices. Key features of the Digi CM include support for:
•SSH v1 and v2 for server and clients
•IP filtering
•authentication using RADIUS, LDAP, TACACS+, and a local database
•custom menuing
•system and port logging
The configuration of these features, and many others, is simplified through the
use of a web interface. The web interface enables an administrator to quickly
access a configuration menu and configure the Digi CM as desired. The web
interface supports both HTTP and HTTPS protocols.
User Groups The Digi CM comes with built-in user groups. The four groups are defined by
their access levels. The table below displays the various user groups, their
access rights, and the default built-in user names if applicable.
.
Chapter 1 Introduction
Capabilities Default Users
User Group Access
Ports Configure
Ports Configure
System Settings Command Line Interface Login Default Password
root yes yes yes yes root dbps
system
admin yes yes yes yes admin admin
port admin yes yes no no - -
user yes no no no - -

Username and Password
10 Chapter1
Username and Password
The Digi CM comes with two default users within the user groups, root and
system admin.
Port administrators and users can easily be added by the system admin or root
user through the web interface under System administration > User
administration > Add user. Root’s password must be modified from the
command line using the command passwd.
Ways to Configure the Digi CM
There are three ways to configure the Digi CM. The three ways are:
•Web Interface
•Configuration Menu
•Command Line Interface
Web Interface
The web interface provides a simple, convenient way to configure the Digi CM.
It is accessible to all users, although not all users have the same access
privileges. Root and the system administrator have full access rights to the
web interface. The port administrator is allowed to access and configure the
ports including port clustering, but cannot modify system settings. Users can
also access the web interface, but are only permitted to access the ports.
To access the web interface, enter the IP address or Hostname for the Digi CM
in the URL of a browser page. The following page is displayed after you have
logged into the Digi CM. The menu on the left side of the page cascades as
you select the main heading.
Root’s password
can be modified
through the
command line
interface using the
command passwd.
Username Default Password
root dbps
admin admin
The Digi web
interface features
HTTPS for secure
access.

Introduction
Chapter 1 11
Configuration Menu
The configuration menu is a menu presented to the root user or system
administrator from a Telnet session or by establishing a direct serial
connection through the console port of the Digi CM. The functionality is similar
to the web interface except for the ability to create custom menus. Root and
the system administrator have full access rights to this menu. The port admin
and user cannot access this menu. Root enters this menu from the command
line interface by entering the command configmenu.
The Command Line Interface
The command line interface is accessed by the root user from a Telnet session
or by direct access to the console port of the Digi CM using the username root
and the default password dbps. A command prompt for the Linux console is
displayed. No other users have access permission to the command line
interface by default. The system administrator can be assigned command line
interface privileges, but will have read only rights.
Ways of Accessing the Digi CM
There are four ways to access the Digi CM. The four ways are:
•Web Interface
•Port Access Menu
•Direct Port Access
•Custom Menus
Web Interface Access Menu
The web interface menu also provides an easy and convenient method to
access one or more ports. All users have access to this interface and enter the
menu by entering the IP address or Hostname of the Digi CM in a web
browser’s URL. After logging in to the web interface, the user selects Serial
Port > Connection and then the port to access.
Port Access Menu
The Port Access Menu provides another option for accessing the serial ports.
This menu is accessible to all users and can be accessed through the web
interface, a Telnet session, remote access by a modem, and from SSH. Root
can access the Port Access Menu through a Telnet session from the command
line interface by doing the following:

Ways of Accessing the Digi CM
12 Chapter1
Telnet to the IP address of the Digi CM with port number 7000.
An example of the command is: telnet 192.168.100.200 7000
Accessing A Port Through the web interface
1. Access the web interface.
2. Choose a Port number or the Port Title.
A Java applet opens with a login prompt.
Direct Port Access
The Digi CM allows you to connect directly to a single port through a Telnet or
SSH session. Before you access a port using this method you need to make
sure the port you are connecting to has been configured properly. The Host
Mode Configuration must be set to Console Server Mode and the Protocol
setting must be set to either Telnet or SSH. All ports are set to Console Server
Mode and Telnet by default.
Telnet to a Port
Using a Telnet client, establish a connection to the IP address of the Digi
CM, followed by the port number of the port you wish to connect. For exam-
ple, to connect to port 3 of the Digi CM, simply enter the following com-
mand:

Introduction
Chapter 1 13
telnet [IP ADDR] 7003
This example assumes the base socket port of the Digi CM is 7000
(default).
SSH to a Port
Using an SSH client, establish a connection to the IP address of the Digi
CM using the login name and port number of the port you wish to connect.
For example, to connect to port 3 of the Digi CM using login name admin,
simply enter the following command:
ssh admin@[IP ADDR]:7003
This example assumes the base socket port of the Digi CM is 7000
(default).
Custom Menus
Custom menus are menus created by either root or the system administrator
and are designed for specific users or groups of users. The custom menu
feature enables root or the system administrator to design menus customized
to a user’s needs. Custom menus are a method for users to view and access
only those devices they have permission to enter. For details on configuring
custom menus see "Making Custom Menus" on page 53.
Saving and Applying Changes
Changes to the Digi CM configuration done through the web interface can be
saved by choosing Save to flash. These changes are then saved, but the
configuration changes are not immediately in effect. To immediately apply the
configuration changes select the Apply changes command found on the main
menu.

Saving and Applying Changes
14 Chapter1

Getting Started
Chapter 2 15
Introduction This chapter covers basic information for configuring the Digi CM. Included in
this chapter is information on assigning IP settings, enabling the web interface
for secure access, accessing the unit through SSH, and adding or removing
users. The default IP address for the Digi CM is 192.168.161.5.
Assigning IP Settings
The initial setup of the Digi CM, including attaching it to the network, is
described in the Quick Start Guide included with the product packaging. A
copy of the Quick Start Guide is also available online at http://cm.digi.com. The
Digi CM can also be assigned IP settings through the console port located on
the rear panel. To use the console port to assign IP settings, do the following:
1. Connect the Ethernet cable from the console port on the rear panel of the
Digi CM to a serial port on a workstation. Use the Ethernet cable packaged
with the Digi CM and attach the DB-9 adapter. The arrow in the following
graphic points to the console port.
2. Setup a terminal emulation program, such as HyperTerminal, using the
following port parameters: bps=9600, data bits=8, parity=none, stop bits=1,
and flow control=none.
3. Press Enter to get a command prompt.
4. The username is admin and the default password is admin.
5. From the configuration menu, enter the number 1 for Network configuration
> enter 1 for IP configuration > enter the numbers for the individual IP set-
tings when the following menu is displayed.
.
Chapter 2 Getting Started
The default IP
address is
192.168.161.5.
console port

Configuring HTTP and HTTPS
16 Chapter2
6. Press ESC when done to return to the main configuration menu.
7. Enter number 6 to Save changes.
The values are saved and applied immediately. There is no need to reboot.
Configuring HTTP and HTTPS
By default HTTP and HTTPS are enabled on the Digi CM device. To modify
these settings, do the following:
1. Enter the IP address for the Digi CM in a web browser’s URL.
2. Choose Web server configuration from the Network Configuration heading
on the web interface menu.
3. Choose Enabled or Disabled.
4. Set the desired refresh rate for statistics data.
The default value is 10 seconds.
5. Choose Save to flash and Apply changes.
Access Using SSH
The Digi CM can also be accessed through an SSH connection. The Port
Access Menu and each individual port can be configured for SSH. Access an
individual port for SSH by doing the following:
1. Access the web interface.
2. Use the username admin and the default password admin.
3. Under the Serial Port heading choose Configuration.
4. Choose the port or ports you want to configure for SSH, you can choose
either: Port Access Menu, All ports, or an Individual port.
5. Choose Host mode configuration.
The Digi CM
supports Blowfish
and 3DES
encryption methods
for SSH.

Getting Started
Chapter 2 17
6. Under Protocol select SSH.
7. Choose Save to flash and Apply changes.
To access a port that has been configured for SSH, locate your preferred SSH
client and initiate a session to the IP address and port as shown:
ssh username@IPaddress 70XX
An example for port 3 on a Digi CM would be:
ssh [email protected] 7003
Adding, Editing, and Removing Users
The system administrator can add, remove, or edit users from the web
interface. To add or remove users or edit user files do the following:
1. Access the web interface.
2. Under the System administration heading choose Users administration.
3. Choose Add User, Edit User, or Remove User.
•Add a user: Assign a name, user group, and a password
•Edit user files: Change user group, password, or their shell
•Remove a user: Remove a user from the system
4. Choose Save to flash and Apply changes.
Note: The root and admin users cannot be removed from the system. The password for
root can only be changed from the command line using the command passwd.

Using the Configuration Menu
18 Chapter2
Shell Options
The shell program selection determines the interface you see when
establishing a Telnet or SSH session with the Digi CM.
Using the Configuration Menu
The configuration menu presents the same functionality in configuring the Digi
CM as does the web interface excluding the creation of custom menus. The
configuration menu is navigated by using the number representing the menu
item and the ESC key to return to earlier menus. For the sake of clarity, the
menu item names, not their corresponding numbers, will be used to explain
the configuration options.
Use the Save changes option when you are done configuring all your
parameters, then choose Exit and apply changes to have your changes take
effect immediately.
Configuring SSH
1. Access the configuration menu from a Telnet session.
2. Use the username admin and the default password admin.
3. Choose Serial port configuration > choose an individual port number or 0
(zero) for all ports > Host mode configuration > Protocol > SSH.
4. Use the ESC key to return to the main configuration menu.
5. Choose Save changes.
User Group Shell Program Options
root command line
system admin command line, configuration menu, port access menu, custom menus
port admin configuration menu, port access menu, custom menus
user port access menu, custom menus
The Save
changes option
saves changes to
flash memory
only.

Getting Started
Chapter 2 19
Adding, Editing, and Removing Users
1. Access the configuration menu.
2. Choose System administration > User administration > Choose Add,
Remove, or Edit.
Each choice will present different menu options.
3. Configure the user as desired.
4. Use the ESC key to return to the main configuration menu.
5. Choose Save changes.
Choose Exit and
apply changes
when you have
made all your
changes.

Using the Configuration Menu
20 Chapter2