Preface, Router configuration v4.0-9 and earlier, Router configuration v4.0-10 and later – Thinklogical Router - Configuring the ASCII Interface User Manual

Page 2

Advertising
background image

Preface

The router is controlled via an ASCII interface. This interface is accessible via a serial RS-232
port or over the network via a TCP port. Both ports use the same syntax. The command syntax
is defined in the document:Router-ASCII-API.pdf.

The serial port is configured for 9600 baud, 1 stop bit, no parity, and software flow control. Each
line contains only one command and must end with a carriage return (CR) and line feed (LF), or
just a line feed (LF). The characters are not echoed.

The network interface listens on TCP port 17567. It accepts the same commands as the serial
interface. You may use telnet to manually open a connection and control the VxRouter.

(references to a VxRouter also apply to a HdxRouter and a MxRouter)

Router Configuration V4.0-9 and earlier

The router interface is controlled by entries in the file /etc/inittab. Listed below are the relevant
portions of the file that control the interfaces:

#run the ASCII interface program
::respawn:/usr/local/sbin/vxrapi --verbose
::respawn:/usr/local/sbin/vxrapi --serial

The line with '

--verbose

' starts the network connection. By default the network interface is

started unless the '

--serial

'

option is present.

After making changes to the file /etc/inittab, you must run the commands:

kill -hup 1
killall vxrapi

for the changes to take effect.

Router Configuration V4.0-10 and later

Starting in version 4.0-10 and later, the interface program no longer requires the --serial option.
Both the serial and network interfaces are started with the one command. Listed below are the
relevant portions of the file that control the interfaces:

#run the ASCII interface program
::respawn:/usr/local/sbin/vxrapi --verbose

The version of the API program may be determined by any of the following:

1) looking in the system log file: /var/log/api for the API signon message
2) running the command:

vxrapi ­v

on the VxRouter

3) sending the command 'xversion' to the API command port

Revision: G

Advertising