TM-2000 Release Notes

Version 9.1.2




Compatibility

Licensing

Change History

Version 9.1.2

Version 9.1.1

Version 9.1.0

Version 9.0.0

Version 8.9.1

Version 8.9.0

Version 8.8.1

Version 8.8.0

Version 8.7.2

Version 8.7.1

Version 8.7.0

Older revisions

SNMP

Software organization

Hardware requirements

Serial ports

Ethernet adapters

PCI  slots and interrupts

Distribution

Running a TM-2000 demonstration

Installing the TM-2000 software

Updating the TM-2000 software

Login names

Shutting down and restarting

Baud rates

Customized files

Networking information

Useful Linux tricks


Compatibility

Active/Standby
Version 9.1.2 of the TM-2000 requires version 9.1.x, version 9.0.x, or version 8.9.x as the standby TM-2000.
When running as the standby controller, TM-2000 version 9.1.2 can communicate with an active TM that is version 8.8.0 or 8.7.x, e.g. when updating the TM-2000 firmware.
TrunkEdit
Support for all features requires TrunkEdit version 1.7.0 or later.
Trunk Supervisor
Support for all features requires Trunk Supervisor version 1.8.0 or later.
Intercom Controller
The following are the minimum versions of Intercom Controller that are supported, and the minimum versions required for support of features added in recent releases:
Controller Type Minimum Version Larger Scroll Lists Ethernet IFB Tallies IFB-SL Tallies OOS Trunks
Standard ADAM MC / ADAM-CS 9.16.0 n/a n/a n/a n/a n/a
ADAM Peripheral Controller (with DBX) 10.9.0 n/a n/a n/a n/a n/a
ADAM MCII-e 1.0.0 n/a n/a n/a n/a n/a
ADAM PeriphII-e (with DBX) 1.14.0 1.20.0 1.23.0 1.25.0 1.26.0 n/a
ADAM MCII-e (with Tri-Bus support) 2.1.0 2.1.0 2.2.0 2.5.0 2.6.0 2.6.0
Cronus 0.3.0 1.5.0 1.6.0 1.9.0 2.0.0 n/a
ZEUS-2 3.1.0 n/a n/a n/a n/a n/a
ZEUS-III 1.0.0 1.0.0 1.1.0 1.4.0 1.5.0 n/a
CS9500 / CS9600 / CS9700 Not supported n/a n/a n/a n/a n/a
(OOS = Out Of Service)

Licensing

The TM-2000 software no longer requires licensing.
 
 

Change History

Version 9.1.2

Version 9.1.1

Version 9.1.0

Version 9.0.0

Version 8.9.1

Version 8.9.0

Version 8.8.1

Version 8.8.0

Version 8.7.2

Version 8.7.1

Version 8.7.0

Version 8.6.1

Version 8.6.0

Version 8.5.0

Version 8.4.1a

Version 8.4.1

Version 8.4.0

Version 8.3.1

Version 8.3.0

Version 8.2.1

Version 8.2.0

Version 8.1.0

Version 8.0.1

Version 8.0.0


SNMP

The TM-2000 now supports SNMP versions 1, 2c, and 3.

For SNMPv1 and SNMPv2c, the TM-2000 is configured with the following default community strings:

These community strings can be viewed and modified with TrunkEdit (v1.4.0 or later).

SNMPv3 supports security levels noAuthNoPriv and authNoPriv; however, security level authPriv (i.e. message encryption) is not supported. SNMP is initially configured with the following users:

The usmUserTable can be manipulated via SNMPv3 to clone these entries as required to create new users.

The Telex-TM-MIB implemented by the TM-2000 can be obtained from Telex.


Software Organization

The TM-2000 Trunk Master consists of a PC running a Linux kernel with real-time extensions. The TM-2000 software consists of some kernel load modules (i.e. they can be dynamically loaded and unloaded; when loaded, they become part of Linux), in cooperation with some executable programs.

All of the TM-2000 software is installed in the /tm directory. (Unlike DOS and Windows, Linux uses the forward slash, "/", as a directory separator.) There are some other files in other directories which are customized, e.g. to automatically start the TM-2000 software when the system is rebooted.

Please note that, although this document describes some of the configuration files under Linux, and includes a section on useful Linux tricks, it should not normally be necessary to log on to the TM-2000 computer and do anything from Linux. Configuration of the TM-2000 is done by running the TM-2000 software (which automatically happens when the computer is booted) and then running TrunkEdit on another computer which is connected via Ethernet or a serial port to the TM-2000 computer.
 
 

Hardware Requirements

Serial Ports

The TM-2000 requires the standard COM1 and COM2 devices. (These are referred to as /dev/ttyS0 and /dev/ttyS1, respectively, in Linux.) COM1 is used for TrunkEdit; COM2 is used for the Trunk Supervisor.

In order to communicate with intercoms, one or more serial cards must be installed. The cards to be used are PCI-COM485/8 cards, from ACCES I/O Products Inc. The TM-2000 will run without any ACCES cards being installed; however, it will not be able to be connected to any intercoms.

PCI slots each have a unique number. The first 8 serial ports are on the ACCES card in the lowest-numbered slot; the next 8 serial ports are on the serial card in the next-highest slot, etc. (The cards do not have to be in adjacent slots. If 2 cards are installed, they will provide serial ports numbered 1 through 16, whether they are adjacent or not.) Unfortunately, the numbering of PCI slots varies from manufacturer to manufacturer. However, it is usually possible to determine in which order the slots are numbered from the PCI information printed out by the BIOS when the computer is booted. This information can also be determined by booting off the TM-2000 installation disk and selecting option 3 ("List PCI devices and check for interrupt conflicts").

If a VDP (VTR Delegate Panel) controller is to be used, it must be connected to the first serial port on the first ACCES card; otherwise this serial port can be used for intercom communications. The selection of whether or not to enable VDP operation is made when the software is installed from the CD.

Ethernet Adapters

The TM-2000 supports the use of a single Ethernet adapter. This is used for active/standby communications, and also for TrunkEdit communications via Ethernet. If TrunkEdit via Ethernet is to be used, the computers must be connected by a switch or hub; otherwise, a single Category-5 cross-over cable can be used between the active and standby computers.

The following Ethernet adapters are supported:

Note that there are many Ethernet adapter cards that are listed as being supported by Linux. However, in order to support any other cards, the Linux kernel that is included with the TM-2000 software must first be rebuilt to add support for those cards. In other words, if you install an Ethernet card other than one from the above list, it won't work without modifications to the software, even if the card is listed as being supported by Linux.

PCI Slots and Interrupts

The PCI architecture is designed to allow multiple PCI cards to share an interrupt line. The TM-2000 software allows multiple ACCES cards to share an interrupt. However, an interrupt line which is used by an ACCES card MUST NOT be shared with another device. (It is possible for the same interrupt line to be assigned to an ACCES card and to another PCI device which doesn't actually generate interrupts - for example, a VGA controller. In this case, the system should be okay.)

When a computer is booted from the TM-2000 installation CD, one of the options is "List PCI devices and check for interrupt conflicts". If this option is selected, a list of all PCI devices which use interrupts will be printed. The device/slot number is also printed, which can be used to identify how the PCI slots are numbered. Note that the lowest-numbered slot may be something other than 0 or 1.
 
 

Distribution

The TM-2000 software is distributed on a CD-ROM. This CD is bootable. If a computer is rebooted with this CD in the drive, the CD will boot Linux, and then prompt for what to do next:

Running a TM-2000 Demonstration

If the option to run the TM-2000 in demo mode is selected, the TM-2000 software is run off the CD-ROM. The hard disk is not touched in this case. The computer is configured with a name of demo_tm and  an IP address of 10.201.202.203. It runs in stand-alone mode (i.e. it will not run in an active/standby configuration with another TM-2000 computer).

The only file systems used in this configuration are the CD-ROM (which is read-only) and a RAM disk (which disappears if the computer is shut down or restarted). In this mode, it is possible to restart by simply hitting the reset button; however, it is better to shut down the computer, either by hitting Control-Alt-Del (which will shut down and reboot the computer), or by logging on as root and then executing the command "shutdown -h now". If a "shutdown" command is executed, the computer will print out a number of messages, and then eventually display "Power down.", when it is safe to cycle power.
 
 

Installing the TM-2000 Software

When the option to install the software is selected, the computer will prompt for various pieces of information. There are defaults for most of the options.

The first question addresses whether the computer is to be part of an active/standby configuration. There are 3 choices. The following choices are available:

In addition, the following parameters are set by default: After selecting the configuration, you have the ability to change the computer name or any of the networking parameters, if needed. See the section on networking information for more details.

The software next prompts for whether the TM-2000 will be used with VTR Delegate Panels. This affects whether the first ACCES serial port is available as an intercom connection or not. Most installations will not need VDPs.

Next, the software attempts to determine the hard disk drive size and partition information. You have a choice, of either controlling how the hard disk is partitioned, or of letting the software generate default partitions. If the default partitioning is chosen, 2 partitions will be generated: one of 5 MB (containing the files essential for booting) and one of 250 MB.

Once the partitions have been selected, the partitions will be formatted, and the software installed on the hard disk drive.

Once this is complete, a tm_demo login: prompt will be displayed. When the computer is next rebooted (and the CD-ROM removed from the drive), the computer should automatically boot off the hard drive and start the TM-2000 software.
 
 

Updating the TM-2000 Software

In order to update the TM-2000, the following files are required: These must be copied to a CD.

To perform the update:

  1. Log on to the console as the user root . (A password may have been set for this user when the software was initially installed.) You should get a line or two of information, followed by a prompt. This will be similar to
    root@tm1 ~ #
  2. Shut down the TM-2000, by executing the command
    /tm/stop_tm all
    You should get several lines of output (not necessarily in this order) such as
    nvconfig: exiting
    Trunk Master: exiting
    LAN interface: exiting
    followed by another command prompt.

  3. Put the CD containing update_tm.sh and the update file in the CD drive. Enter the following commands:
    mount /cd
    sh /cd/update.sh
    You should then get the following lines:
    Extracting new files...
    Updating existing files...
    Finally, you should get the prompt:
    Update complete. You must now reboot the computer in order to
    re-start the TM-2000.
  4. Enter the following command:
    umount /cd
    Remove the CD from the drive.

  5. Reboot the computer. You can either use the DOS reboot sequence (Control-Alt-Delete), or you can enter the command
    shutdown -r now

Login Names

When the TM-2000 software is installed, there are 3 login names that are set up: root, guest, and tm_admin. root and guest are configured without a password; tm_admin is configured with a password of KermitFrog .

The password for any login name can be changed by logging on with that name and entering the passwd command. In addition, root can set the password for any login name by executing passwd guest (for example).

The root login is used for administrative functions. This user name has full permission to do anything. It is possible to delete critical files that prevent the system from booting, for example.

The guest login should be used for normal logins, e.g. to check system logs or look at the system configuration.

The tm_admin login has been set up for TM-2000 maintenance functions, such as installing new versions of the software. This user has been configured with full access to the /tm directory, where the TM-2000 program files are stored.

The TM-2000 system is also configured so that /tm can be accessed from Windows machines. In this case, /tm should be mapped to a network drive, using the login name tm_admin with a  password of KermitFrog . This password can be changed, independent of the login password, via the smbpasswd command.
 
 

Shutting Down and Restarting

The simplest method to shut down and restart the TM-2000 is to reboot the computer - see the section on useful Linux tricks.

In some cases, it may be necessary to shut down the TM-2000 software, but still leaving the computer running (e.g. to update the TM-2000 software). This can be done by logging on as root and executing the following command:

/tm/stop_tm all
The TM-2000 can be restarted by either rebooting the computer, or by executing the command
/tm/run_tm
Alternatively, you can execute the command
/tm/run_tm solo
which starts the TM-2000 software running, but in a stand-alone mode (the computer starts up as active, and does not try to communicate with another TM-2000 over Ethernet).
 
 

Baud Rates

The TM-2000 defaults to 38,400 baud for both TrunkEdit and the Trunk Supervisor. These baud rates can be changed by logging in as root and executing either or both of the following commands:
/tm/set_baud edit 9600

/tm/set_baud supv 9600

These settings are saved to disk. If the TM-2000 is stopped and restarted, the baud rates will be restored automatically.

The baud rates for communications with the various intercoms are defined from the Intercom Setup screen in TrunkEdit.
 
 

Customized Files

This section lists those files which are customized when the TM-2000 software is installed, along with a brief description of what changes are made. This would allow the user to change IP addresses, for example, without having to re-install the software. Note that, if any of these files is changed, the computer may need to be rebooted for the changes to take effect. The files in /boot contain files which are used in the initial booting of Linux. The file /etc/lilo.conf contains information about which hard disk partition contains the main file system; the command lilo reads this file and builds the file /boot/System.map which is used during the boot process.

The file /etc/fstab lists, amongst other things, which hard disk partitions are used, and where they are mounted.

A script file is available to assist in changing the network parameters of the TM-2000. Please contact your local Telex System Support Engineer if you need this.
 
 

Networking Information

This section provides some background information on assigning IP addresses to computers.

The TM-2000 computers use Ethernet to communicate with each other when running in an active/standby configuration. They also support Ethernet communications with TrunkEdit.

Each computer on a network must have a unique IP address. The Internet Assigned Numbers Authority (IANA) has reserved the following three blocks of the IP address space for private networks (i.e. ones not directly connected to the Internet):

10.0.0.0 through 10.255.255.255

172.16.0.0 through 172.31.255.255

192.168.0.0 through 192.168.255.255

Hence, many companies' private intranets use one of the above three blocks of addresses; and their connection to the Internet goes through a firewall which translates the IP addresses.

If the TM-2000 computers are going to be used on a private network with no other devices, there should be no need to change the default IP addresses that the TM-2000 uses. However, if they are going to be connected to an existing network, the default IP addresses may not be suitable. The local network administrator should be consulted to obtain the proper IP addresses, network mask, etc. The previous section describes which files need to be changed in order to change the network configuration without reinstalling the TM-2000 software.
 
 

Useful Linux Tricks

On the computer console, Shift-Page Up and Shift-Page Down can be used to scroll through the last 6 or so screenfuls of text. Each keystroke scrolls forward or back by half a screenful.

The TM-2000 is configured with 2 virtual consoles. Normally, everything is done on the first virtual console. However, Alt-F2 can be used to switch to a second virtual console (the first time you do this, you will be at another login prompt); Alt-F1 can be used to switch back to the first virtual console. This can be useful if you are logged in and doing something, and you want to quickly look something up, without disturbing your first session.

The computer can be rebooted by typing Control-Alt-Del. You do not have to be logged in to do this. Alternatively, if you are logged in as root, you can type the command "shutdown -r now". To halt the computer, rather than reboot it, type the command "shutdown -h now", and wait for the "Power down." message to appear.

If you are logged in, you can log out by typing the command "exit", or by pressing Control-D.

If the computer is restarted without shutting it down properly (e.g. there is a power failure), the computer will automatically run fsck ("file system check", similar to DOS's chkdsk). However, this will normally only take a few seconds, since there is not that much data stored on the hard disk.

There are lots of Linux resources on the Internet. For example:

 http://www.linuxdoc.org/HOWTO/DOS-Win-to-Linux-HOWTO-2.html provides a table listing a number of DOS commands and their  Linux equivalents. (This is section 2 in a larger document - click the "contents" link on this page to see the rest of the document.)

http://www.linux.org/lessons/ provides an on-line "course" giving the fundamentals of Linux.

(Please note that it is not necessary to become a Linux expert. Once the TM-2000 software is installed, it should not be necessary to log on to Linux, except to perform certain functions such as updating the software. The links listed above are provided for the convenience of those who are interested in learning more about Linux.)