Table Of Contents Table Of Contents ..........................Introduction ............................Before you start ............................ VLC basic configuration ........................Network configuration ........................How to connect to the VLC ........................ The file '/etc/rc.vlc' .......................... The file '/etc/satnms.rc' ......................... Adding serial interfaces ........................4 / 8 Port Cards ..........................Moxa Intellio Cards ........................
Page 3
A short introduction to 'vi' ......................... Common commands ........................'vi' in the MS Windows telnet client ....................(C) 2020, SatService GmbH www.satnms.com VLC-IM-2002 Page 2/39...
Introduction The VLC installation manual describes the steps of the basic configuration for a new VLC which shall be prepared for it's first use. These steps apply to VLCs which are going to be upgraded or re-used as well. The chapter 'Before you start' gives some advice which information to collect before you start to configure a VLC.
Page 6
Before you start To configure a VLC, there are some information about this VLC you need to collect. First of all you have to assign an ID to the VLC. Each VLC managed by the NMS has it's unique ID. VLC IDs are number s in the range 1 ...
VLC basic configuration To prepare a VLC before it is used the first time (or if it shall be re-configured), the following parameters must be set at the VLC: You can use the setup program for new VLC's to configure these settings. VLC number/ID: Within the NMS, each VLC must have a unique ID assigned to it.
'How to connect to the VLC' explains, which options the VLC provides to do this task. Chapter The file '/etc/rc.vlc' provides a reference of all parameters which can be set in this configuration file. Chapter 'setup program' describes the use of the setup program for new VLC's and Chapter 'The file '/etc/satnms.rc'' provides a reference to all parameters.
Page 9
NMS and VLC are able to act as IP routers and to provide an on demand IP link between the LAN the NMS is connected to and the Ethernet trunk behind the VLC. For this reason, the NMS uses a unique IP address space for each VLC during an online PPP session to it. VLCs are assigned to IP addresses in steps of 16, starting at 192.168.100.1.
interface eth0 directly (not in the satnms configuration file). auto eth0 iface eth0 inet static address 192.168.2.222 netmask 255.255.255.0 gateway 192.168.2.254 up route add -net 192.168.1.0 netmask 255.255.255.0 gw 192.168.2.253 down route del -net 192.168.1.0 netmask 255.255.255.0 The last two lines sets a static route to the 192.168.1.0 network if the interface goes up and removes this route if the interface goes down.
Page 11
The VLC by default is configured to the address 192.168.2.222. 4. Connect the VLC to the LAN and use SSH to login Use the Secure Shell (ssh) to connect to the VLC via LAN. The connection is encrypted and is much more secure as the plaintext protocol from Telnet.
Remember to connect the security device coming with the VLC to the 25 pin connector. The VLC will not work without this! The file '/etc/rc.vlc' See the following chapter for the description of the new configuration file /etc/satnms.rc Below the file '/etc/rc.vlc' with the factory default settings is listed. Comments in the file describe the meaning and valid range of each setting at great length.
Page 13
# will assign an address to the interface which is suitable for the # remote control of LAN controlled devices through a PPP connection # to the NMS. This address gets derived from the VLC_ID, a unique # /28 subnet is assigned to each VLC USES_ETHERNET=yes ETHER_ADDR=192.168.2.222 ETHER_SNET=192.168.2.0...
The file '/etc/satnms.rc' Below the file '/etc/satnms.rc' with the factory default settings is listed. Comments in the file describe the meaning and valid range of each setting at great length. To change some of the settings, connect to the VLC and login as described in How to connect to the VLC and then start the setup...
Page 16
# Address of the dns name server, leave empty if not needed SATNMS_IP_DNSSERVER="192.168.2.253" ######################################################################## # Serial interface settings ######################################################################## # Sets up the serial ports (passive cards and Comtrol Rocketport cards) # in the computer. Replaces the original Debian setserial script. # Basically three types of cards are supported: 4-port MOXA Smartio/Industrio 4 port card...
# startup. You must have a running Ethernet interface for this, # the file /etc/els.conf must be adapted to the unit's configuration # you want to access SATNMS_ETHERLITE=no ######################################################################## # Modem settings ######################################################################## # Set this to "yes" if you have a modem/terminal-adapter connected # to /dev/ttyS0 and you want to use a PSTN line for the VLC-NM # communication.
Digi Etherlite For large systems an external terminal server may provide a nearly arbitrary number Terminal Server of serial ports. The terminal server is connected to the VLC via Ethernet. The serial IO cards are not automatically recognized by the VLC. Each card must be configured to the address/irq settings expected by the software.
are configured by jumpers/DIP switches. The port names generated for Intellio cards follow a similar scheme as the passive cards do. The variable name was changed to SATNMS_INTELLIO. Digi Etherlite Terminal Server The VLC also supports the Digi Etherlite terminal server series. Set the variable USES_ETHERLITE in the file /etc/rc.vlc to 'yes' if you have connected one or more terminals servers to the VLC's Ethernet port.
Page 23
1. Shut down the VLC, switch it off. 2. Open the housing. 3. Install the board in a free slot. 4. Install the jumper at the rounded corner of the board (it's the only jumper on this board). 5. Connect a VGA computer monitor and a keyboard to the VLC. 6.
Serial IO Hardware Setting (4-PORT / 2) To install a Moxa Smartio/Industrio 4-port board in a VLC as the second serial board, the IO port and IRQ settings of the board must be changed to 0x200 / IRQ 5 by means of the DOS based configuration utility shipped with the board.
The jumpers for enabling the termination resistors are places beside the connector at the board's bracket. By closing the pins with a jumper, a termination resistor of 120 ohms gets placed across the receive lines of the port. Serial IO Hardware Setting (4-PORT / 3) To install a Moxa Smartio/Industrio 4-port board in a VLC as the third serial board, the IO port and IRQ settings of the board must be changed to 0x380 / IRQ 11 by means of the DOS based configuration utility shipped with the board.
Speed Normal Normal Normal Normal Int.Vec. 11. Press F10 to save the changes. 12. Remove the jumper from the board. 13. Close the housing and reboot the VLC (CTRL+ALT+DEL) The RS485 version of the 4-port card additionally has 4 jumpers to enable the line termination resistors and eight dip switches to select the behavior of the RS485/RS422 ports.
5. Connect a VGA computer monitor and a keyboard to the VLC. 6. Switch on the unit. 7. Press 'F5' when the VLC asks to do so. The VLC only waits for 3 seconds at this point, so keep an eye on the messages on the screen.
Int.Vec. 11. Press F10 to save the changes. 12. Remove the jumper from the board. 13. Close the housing and reboot the VLC (CTRL+ALT+DEL) Serial IO Hardware Setting (8-PORT / 3) To install a Moxa Smartio/Industrio 8-port board in a VLC as the third serial board, the IO port and IRQ settings of the board must be changed to 0x380 / IRQ 11 by means of the DOS based configuration utility shipped with the board.
Serial IO Hardware Setting (ROCKET / 2) To use a Comtrol Rocketport card as the second serial board, the DIP switches on the board must be set to the configuration shown below: Please note, that the use of a Rocketport card as the second board only is permissible if the first board in the VLC also is a Comtrol Rocketport.
The setup program The setup program is a tool to configure the VLC. You have to login as root (see How to connect to the VLC) and then start the program by enter 'setup' at the command prompt. The dialog based program ask for the parameters, writes them to the sat-nms configuration file and finally applies the setting to the system and the appropriate configuration files of the Linux operating system.
Configuring the VLC for the equipment setup Telling the VLC which types of devices are connected to which serial interface you preferably will do at the NMS. The NMS software provides a graphical user interface which easily lets you add or remove interfaces or assign device drivers to interfaces.
Operating the VLC The VLC is built to run 24 hours a day without local user interaction. There is no local control of a VLC. Once installed, a VLC will run under control of the NMS. Power supply The VLC is a computer containing a hard disk. Like with any computer, it may be damaging for the VLC to switch off the power while the VLC is running! It is strongly recommended to use a battery backed up power supply for the VLC.
Appendix Device driver / protocol reference list Device setup configuration file format A short introduction to 'vi' Device driver / protocol reference list The table below list the device types supported by the VLC together with the name of the communication protocol to be used with this device type.
Tadiran-Scopus-E1000 Tadiran-Scopus Tandberg-Alteia Tandberg-Alteia Tandberg-TT1260 Tandberg-TT1200 Vertex-7134-Step-Track Vertex-7134 Vertex-7200-Step-Track Vertex-7200 Vertex-Digital-Tracking-Receiver Vertex-7200 Wegener-UNITY44XX Wegener-Terminal Device setup configuration file format At startup the VLC software reads the file 'vlc.setup'. This file tells the software, which kind of device shall be controlled at which interface of the VLC. The file is free formatted (line breaks are treated like spaces). C/C++-style comments are recognized and removed before the file is interpreted.
Page 36
Keyword Reference Below the keywords which may appear in a 'vlc.setup' file are shown in tabular form. COMMENT The COMMENT keyword defines an identification string which should describe the purpose and the revision of this configuration file. A message with the string defined with COMMENT is listed in the event log when the software starts.
Page 37
Example: DEVICE CAM-SW IS NAIS-FP-Simple-Output IDLE For each port the software maintains an own 'thread' which polls the device(s) in an endless loop. In order not to eat up all the computer's CPU time, the thread rests in every loop cycle for a certain time. The default for this idle time is 1000 msecs. The IDLE parameter lets you set the idle time for each port individually.
Page 38
following chapter lists the most frequently used commands for the vi editor as a reference. Common commands The table below lists some frequently used commands for the vi editor. Pleas note that all the commands except must be typed in COMMAND mode. This means if the editor is in another mode than the COMMAND mode, you have to press the key first.
Page 39
File / buffer commands :qa! Quit, abandon all changes. Exit, save changes. :e file-name Edit a file in a separate buffer. Step through buffers. Find / replace commands / pattern Goto the next occurrence of 'pattern'. Repeat the last search. :%s/pattern/text/gc Replace each occurrence of 'pattern' in the document with 'text'.
Page 40
The keys 'Ins', 'Del', Pos1', 'End', 'Pg Up' and 'Pg Dn' do not work. You should not try to use them as they might insert strange characters in the text instead of doing the function you expect. (C) 2020, SatService GmbH www.satnms.com VLC-IM-2002 Page 39/39...
Need help?
Do you have a question about the SatService sat-nms VLC and is the answer not in the manual?
Questions and answers