TSAT AS TSAT 3000 Installation manual

Product: DOC3010, Revision: 1.6.3
January 2013
Telemetry and data transfer via SATellite
TSAT 3000 Command Line Interpreter
Command Reference Manual
1.6.3

Command Reference Manual
TSAT 3000 Command Line Interpreter January 2013 Page 2 of 41
Document Status
Product description: TSAT3000 Command Line Interface Command Reference
Document
Revision Date Bundle Release Description
1.0.0 2008.02.15 2.0.0 Initial revision
1.0.1 2008.03.13 2.0.0 Word and grammer corrections.
1.1.0 2008.11.27 3.1.0 Adding/updating commands for Release 3.1.0.
1.1.1 2008.12.01 3.1.0 Modified command description layout.
1.2.0 2008.12.09 3.2.0 Added commands for Release 3.2.0.
1.3.0 2009.07.02 3.6.0 Modified for Release 3.6.0
1.4.0 2009.12.09 4.0.0 Modified for Release 4.0.0
1.5.0 2011.06.24 4.3.0 Changed “net ping”
1.6.0 2011.10.20 4.4.1 New “sys rf tx level cal”
New “sys rf tx calibrate”
Changed “rf info”
1.6.1 2012.01.09 4.4.3 Changed “net ping”: Add [-I ifname] [-S srcAddr].
Described “net ifconfig”: [bits]
1.6.2 2012.10.12 4.7.2 New RIP [3.3.5] options: nosplithorizon + noinvalidate.
New RIP [3.3.5] command: “net rip debug [0-9]”.
1.6.3 2013.01.28 4.8.0 Changed RIP [3.3.5] options: noinvalidate.
New RoHC [3.3.4] command: “net sat hcmode [enable | disable | rx-only]”.

Command Reference Manual
TSAT 3000 Command Line Interpreter January 2013 Page 3 of 41
Documentation Comment Form
TSAT AS encourages you to comment on the documentation supplied with our products. This
information helps us to provide quality products to meet your needs.
Edition Date: 28 January 2013
Product: DOC3010 Rev. 1.6.3
Please comment on the correctness, completeness, clarity, organisation and usefulness of the
manual.
If you find errors in the manual, please record the page numbers and describe the errors.
Thank you for your help.
Name___________________________________________________________________
Title_____________________________________________________________________
Company_________________________________________________________________
Address__________________________________________________________________
Phone (________)________________________________________________________
Further information about TSAT 3000 can be obtained from:
AV SatCom AS
P.O. Box 1
1330 Fornebu
NORWAY
Telephone: +47 / 66 77 44 40
Fax: +47 / 66 77 44 41
AV SatCom AS makes no warranty of any kind with regard to this material, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose. AV SatCom AS assumes no responsibility for any errors
that may appear in this document. AV SatCom AS makes no commitment to update or to keep current the information
contained in this document. Specifications and procedures may change at any time without notice. No part of this
document may be copied or reproduced in any form or by any means without prior written consent of AV SatCom AS.
Brand names used in this document are the property of their respective owners. Company and product names are
trademarks or registered trademarks of their respective companies.

Command Reference Manual
TSAT 3000 Command Line Interpreter January 2013 Page 4 of 41
Table of contents
1. SCOPE................................................................................................................................................................5
2. COMMAND SYNTAX AND CONVENTIONS..............................................................................................5
3. CLI COMMAND DESCRIPTION ..................................................................................................................6
3.1 GENERAL COMMANDS ........................................................................................................................................6
3.2 USER MANAGEMENT (USER) ...............................................................................................................................7
3.3 NETWORK MANAGEMENT (NET)..........................................................................................................................8
3.3.1 Routes.........................................................................................................................................................8
3.3.2 Interface control.......................................................................................................................................11
3.3.3 Network debugging commands ................................................................................................................12
3.3.4 IP over satellite commands ......................................................................................................................15
3.3.5 RIP (Routing Information Protocol) control commands..........................................................................17
3.4 OPERATING SYSTEM (OS)..................................................................................................................................19
3.5 FILE SYSTEM (FILE)...........................................................................................................................................23
3.6 PARAMETER DATABASE (DB)............................................................................................................................26
3.7 SOFTWARE UPGRADE (SW)................................................................................................................................27
3.8 LOGS (LOG).......................................................................................................................................................28
3.9 RF COMMANDS (RF)..........................................................................................................................................29
3.10 SYSTEM COMMANDS (SYS) .............................................................................................................................30
3.10.1 DSP ........................................................................................................................................................30
3.10.2 Date/Time...............................................................................................................................................30
3.10.3 Analog to Digital / Digital to Analog converter control........................................................................31
3.10.4 RF Synthesizer control...........................................................................................................................32
3.10.5 RX/TX Switch control.............................................................................................................................32
3.10.6 Automatic Gain Control (AGC) Control................................................................................................33
3.10.7 Receive (RX) and transmit (TX) Level Control.......................................................................................33
3.10.8 Receive and transmit control..................................................................................................................35
3.10.9 Block Up-Converter (BUC) Control.......................................................................................................36
3.10.10 Low Noise Block (LNB) Control...........................................................................................................36
3.10.11 Kernel Boot Path Control ....................................................................................................................37
3.10.12 Misc. commands...................................................................................................................................38
4. COMMAND SUMMARY...............................................................................................................................39

Command Reference Manual
TSAT 3000 Command Line Interpreter January 2013 Page 5 of 41
1. Scope
The purpose of this document is to describe the commands and parameters that are implemented
in the TSAT3000 Command Line Interface (CLI).
2. Command syntax and conventions
The commands described in this document follow these notational conventions;
•Square brackets ( [ and ] ) identify an optional parameter. If you use an optional parameter,
you specify the information within the brackets.
Unless the square brackets are in a bold typeface, do not enter the brackets themselves.
•Angle brackets (chevrons) (< and >) are used to denote a required parameter.
Each command and associated parameters are described in the following manner (framework with
dotted lines just for illustration);
The executable command syntax you shall use on the command line is written
first.
Usage
field
Then a short text describing the result of the command when executed.
Release:
Limits the availability of this command to the bundle
releases written here. Commands with no Release field
works for all releases.
Parameter(s):
Parameter name
Function or value description
Example:
A demonstration of the executed command and output
Not all commands will have release information, parameters or examples.
Commands marked with DEBUG in the Usage field are not meant to be run by the Customer.
Debug commands might disturb the operation of the TSAT3000 modem and display information that
only relates to installation, factory testing or fault-analysis by a TSAT - representative.
Important: The CLI is case-sensitive. All commands must adhere to the case
in its corresponding command description.

Command Reference Manual
TSAT 3000 Command Line Interpreter January 2013 Page 6 of 41
3. CLI Command Description
3.1 General commands
exit or quit
Close an active telnet session.
reboot / [reset]
Reboots modem.
The reboot command attempts a graceful reboot by allowing tasks to shut
down properly before a system reboot.
(Release 3.0.x and earlier: The reset command will directly activate the reset
circuitry, and should only be used in the event that reboot fails.
history
Lists the previous executed commands.
cmdstat
Displays debugging information resulting from the last command executed by
the CLI.

Command Reference Manual
TSAT 3000 Command Line Interpreter January 2013 Page 7 of 41
3.2 User management (user)
The TSAT3000 main unit has built-in user access control. This user access control prevents
unwanted access to the system.
Access to the system via the console port, Telnet and FTP are restricted to the users registered in
the system.
user login
Changes current user after entering correct user name and password.
user who
Displays login information for the current user.
user list
Displays login information for all registered users.
user pwdgen <pwd>
This command is used to generate a clear-text encrypted password.
The takes a desired password as input <pwd> and creates an encrypted
password string. This password string is needed when a new user is to be
added to the system. (Details on how this is done can be found in the
document; DOC3030; TSAT 3000 User Guide, Configuration files )
Parameter:
<pwd>
New login password
Example:
OSLO [RT1]> user pwdgen tsat3000
Password: tsat3000 Encrypted password: ScSQcRQcSz
OSLO [RT1]>

Command Reference Manual
TSAT 3000 Command Line Interpreter January 2013 Page 8 of 41
3.3 Network management (net)
3.3.1 Routes
net route
Lists the routes available in the routing table.
Example (R2.x.x):
OSLO [RT2]> net route
Destination/Pfx Gateway Flags RefCnt Use Proto Tos I/f
10.0.0.0/22 10.0.3.2 2000101 1 0 2 0 sat0
127.0.0.1 127.0.0.1 2200005 0 0 2 0 lo0
192.168.10.0/24 10.0.2.1 2010803 0 0 1 0 sat0
192.168.16.8/29 10.0.2.1 2010803 0 0 1 0 sat0
192.168.16.16/29 10.0.2.1 2010803 0 0 1 0 sat0
192.168.16.24/29 10.0.2.1 2010803 0 0 1 0 sat0
192.168.16.32/29 192.168.16.33 2000101 0 0 2 0 motfcc0
192.168.16.40/29 192.168.16.41 2000101 0 0 2 0 motfcc1
OSLO [RT2]>
Example (R3.x.x):
OSLO [RT3]> net route
INET route table - vr: 0, table: 254
Destination Gateway Flags Use If Metric
127.0.0.0/8 localhost UR 0 lo0 0
localhost localhost UH 8 lo0 0
192.168.0.0/24 link#3 UC 1 eth1 0
ethb link#1 UH 0 lo0 0
192.168.0.137 00:0f:1f:d9:d4:20 UHL 13024 eth1 1
OSLO [RT3]>

Command Reference Manual
TSAT 3000 Command Line Interpreter January 2013 Page 9 of 41
net route add <dest. addr> <gw addr> <mask> [options…]
This command adds a network route to the routing table.
The route only exist until the power of the main unit is cycled. Routes are added
to the routing table when the unit boots using the RouteAdd keys in the
[Network] section of the system.conf file.
Release:
R1.0.0 => R3.0.2
Parameters:
<dest.addr>
Destination address in internet dot notation (ex: 192.168.0.1).
<gw addr>
Gateway address in internet dot notation.
<mask>
Hexadecimal value representing the netmask for the destination
address (ex: 0xFFFFFF00 for a 256 address network).
[options…]
Multiple select for type of service and route flags.
“host” : Single address network (Use mask=0 for host
routes).
R2.x.x options only:
“lowdelay” : Minimize delay
“throughput” : Maximize throughput
“reliability” : Maximize reliability
“mincost” : Minimize monetary cost
Example (R2.x.x):
OSLO [RT1]> net route add 192.168.16.32 10.0.2.1 0xFFFFFF00
ROUTE ADD: IP Addr = 192.168.16.32 Gateway = 10.0.2.1 Mask = 0xFFFFFF00 Type of
service = 0x0 Route flags = 0x800
OSLO [RT1]>
net route add <destination/bitcount_mask> <gateway addr> [options…]
net route add <destination> <netmask addr> <gateway addr> [options…]
This command adds a network route to the routing table.
The route only exists until the power of the main unit is cycled. Routes are
added to the routing table when the unit boots using the RouteAdd keys in the
[Network] section of the system.conf file.
Release:
R3.1.0 =>
Parameters:
<destination>
Destination address in internet dot notation (ex: 192.168.0.1).
<bitcount mask>
Netmask given as bitcount (ex: 192.168.0.1/24 for 256
address subnet ).
<netmask addr>
Netmask given in internet dot notation (ex: 255.255.255.0)
<gateway addr>
Gateway address in internet dot notation.
[options…]
“host”:
Single address network.
“hopcount” <value>:
Route prioritizing (metric)
Examples:
OSLO [RT1]> net route add 192.168.100.0/24 192.168.0.1
OSLO [RT1]>
OSLO [RT1]> net route add 192.168.100.0 255.255.255.0 192.168.0.1
OSLO [RT1]>
OSLO [RT1]> net route add 192.168.101.1/32 192.168.0.1 host
OSLO [RT1]>
OSLO [RT1]> net route add 192.168.101.0/24 192.168.1.1 hopcount 2
OSLO [RT1]>

Command Reference Manual
TSAT 3000 Command Line Interpreter January 2013 Page 10 of 41
net route delete <dest. addr> <mask> [options…]
Remove a network route from the routing table. The route will only be removed
as long as the modem is kept on (if route is persistent). If you want to remove
the route for good, you must make sure that the route is removed from the
Network section of the configuration file ‘system.conf’.
Release:
R1.0.0 => R3.0.2
Parameters:
<dest. addr>
Destination address in internet dot notation (ex: 192.168.0.1).
<mask>
Hexadecimal value representing the netmask for the destination
address (ex: 0xFFFFFF00 for a 256 address network).
[options…]
Multiple select for type of service and route flags.
“host” : Single address network (Use mask=0 for host
routes).
R2.x.x options only:
“lowdelay” : Minimize delay
“throughput” : Maximize throughput
“reliability” : Maximize reliability
“mincost” : Minimize monetary cost
Example (R2.x.x):
Assume the following route table entry:
Destination/Pfx Gateway Flags RefCnt Use Proto Tos I/f
192.168.16.0/29 10.0.3.1 3010803 0 0 1 0 sat0
The route can be removed by issuing the following CLI command:
OSLO [RT1]> net route delete 192.168.16.32 0xFFFFFF00
ROUTE DELETE: IP Addr = 192.168.16.32 Mask = 0xFFFFFF00 TOS = 0x0 Flags = 0x0
OSLO [RT1]>
If “Tos” is different from 0, you will have to add the correct option(s) to remove
the route.
net route delete <destination> [options…]
Remove a network route from the routing table. The route will only be removed
until power is cycled (if route is persistent). If you want to remove the route for
good, you must make sure that the route is removed from the Network section
of the configuration file ‘system.conf’.
Release:
R3.1.0 =>
Parameters:
<destination>
Destination address in internet dot notation (ex: 192.168.0.1).
[options…]
“host”: Single address network
Example:
Assume the following route table entry:
Destination Gateway Flags Use If Metric
192.168.6.0/24 ethb UGS 0 lo0 2
The route can be removed by issuing the following CLI command:
OSLO [RT1]> net route delete 192.168.6.0
OSLO [RT1]>