ASTi Telestra User manual

ASTi
Telestra Quick Start
User Guide
Document: DOC-01-TELS-UG-1
Telestra v1.4
Advanced Simulation Technology inc. 441-A Carlisle Drive, Herndon, Virginia, 20170 USA
Revision D (April 2001)

TABLE OF CONTENTS
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
System Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Preparing Telestra for Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Starting and Stopping the Telestra System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Telestra Setup Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Telestra Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Network Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Installing a DMSO RTI (Non-U.S. Customers only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Run the moveRTI.sh script (Non-U.S. only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
How to Run the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Using the Remote Control Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
The Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
System File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
The RTI Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
DACS Operational Differences running HLA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
System Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Accessing a Floppy Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Editing Text Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Updating the Telestra software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Appendix A: Joining a Federation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Telestra System Set-Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Setting Up the Federation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Appendix B: ASTi Radio SOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Version 3.0 OMD File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Version 3.0 OMT File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

ASTi Telestra User Guide (Version 1, Revision D)
Copyright © 1999-2001 Advanced Simulation Technology inc. 1
Overview
For domestic (U.S.) customers, Telestra comes with all required software pre-installed. This
includes the Telestra federate, the DMSO NG RTI, the rtiexec (to be used when testing Telestra
without another machine running the rtiexec), and certain support and debug facilities. For foreign
(non-U.S.) customers, the Telestra system is shipped without the DMSO RTI. Please refer to the
section entitled “Installing the DMSO RTI” for instructions and other information regarding this
topic. It is also important to note that significant information can also be determined from the
DACS node associated with the Telestra unit and hence this guide will reference both units as
appropriate.
This guide assumes the user has a basic understanding of the High Level Architecture (HLA), and
should be familiar with such terms as federate, federation, RTI, etc. It also assumes a basic famil-
iarity with UNIX, such as accounts, passwords, basic commands, etc. If you are familiar with
UNIX in general but not Linux in particular, there are some useful commands and tools specific to
Linux described at the end of this document.
This guide is intended to assist the user in initial start-up of the Telestra unit and provides an over-
view of the basic commands and facilities of the system.
Telestra documentation is also available on ASTi’s website http://www.asti-usa.com/hla.
System Accounts
The Telestra system is shipped with two accounts.The administration/super user account name is
“root” with a default password of “abcd1234”. This account is used for system maintenance, and
will be used to configure the system.
The second account is a normal user account. The account name is “hlauser” with a default pass-
word of “HLA!now!”. This account is used to run the Telestra federate.
To change the password of either account, log into the account and type:
passwd
and follow the directions printed on the screen. DO NOT lose the passwords, particularly the root
password. If the root password is lost, the system hard drive may need to be completely rebuilt!

ASTi Telestra User Guide (Version 1, Revision D)
Copyright © 1999-2001 Advanced Simulation Technology inc. 2
Preparing Telestra for Use
Standard networking hardware should be used when making connections to Telestra and the
DACS units (hubs, bridges, etc.). There are three ethernet interfaces on each Telestra system
(HLA, DACS, and Host) used for communicating with Telestra. The location of each interface
varies with chassis type. The figures below show the location of each interface.
Figure 1a. Ethernet Interfaces on a Telestra System without built-in CD-ROM
Figure 1b. Ethernet Interfaces on a Telestra System with built-in CD-ROM
Figure 2 (below )shows an example network topology for the Telestra system. Notice that an indi-
vidual Telestra system contains support for a maximum of four DACS boxes.
HLA Interface (on-board Ethernet)DACS Interface
Port A
Host Interface
Port B
Host Interface (on-board Ethernet) DACS Interface HLA Interface
Port B
Port A

ASTi Telestra User Guide (Version 1, Revision D)
Copyright © 1999-2001 Advanced Simulation Technology inc. 3
Figure 2: Example Network Topology for the Telestra System
Please note that in order to integrate Telestra into your network, certain configuration set-up pro-
cedures are required to set the IP address of the HLA Ethernet adapter and Host Interface adapter.
The second Ethernet adapter, used to connect to the DACS node, is pre-configured on shipment,
and should not be modified unless under ASTi instruction. Instructions for setting the IP address
and hostname of the Telestra system are given in the “Telestra Setup Procedure” section.
A mouse (3 button PS/2 - supplied), keyboard (supplied) and monitor (not supplied - available to
order separately) must be connected to the unit in order to configure it.
Once the system is configured, it can be run and shutdown remotely. Instructions for this are
described in the document Telestra Remote Control Interface User Guide.
HLA/RTI
Network
USB RESET POWER HDD
HLA Interface
(on-board Ethernet)
Host Interface
(dual Ethernet, B)
DACS Interface
(dual Ethernet, A)
Telestra System
DACS System 1
Host #1
Host #2
Host #
n
DACS System 2
DACS System 3
DACS System 4
Hub Hub

ASTi Telestra User Guide (Version 1, Revision D)
Copyright © 1999-2001 Advanced Simulation Technology inc. 4
Starting and Stopping the Telestra System
The Telestra system runs the Linux operating system and therefore must be started and more
importantly shutdown in the correct manner in order to maintain file system integrity. To start the
unit, apply power via the front mounted on/off switch. The unit will boot-up and run the Telestra
federate on the first console. To log into the system and edit files, you must switch to the second
console by pressing the ‘Alt-F2’ key combination. The normal user account is “hlauser” with
associated password “HLA!now!”. The root account is “root” and the password is “abcd1234”.
Note that these passwords may be changed by the user if required.
The Linux command “shutdown -h now” may be entered from a console screen to power down
the system. Wait until the screen display reads “Power down” before turning the power switch off.
It is also possible to shutdown and reboot the system via remote control over the network - see the
document Telestra Remote Control Interface User Guide for more details.

ASTi Telestra User Guide (Version 1, Revision D)
Copyright © 1999-2001 Advanced Simulation Technology inc. 5
Telestra Setup Procedure
Telestra Configuration Utility
The Telestra system ships with a console GUI configuration tool that supports configuring all net-
work interfaces, host access, terrain queries, tactical data links, and access to the federate remote
control interface. To start the configuration utility, login as root and run the command con-
figTelestra.pyc. Figure 3 shows the welcome screen for the Telestra Configuration Utility. The
remainder of this section will describe configuring general settings. For instructions on setting up
specific features such as tactical data links or terrain queries, please see the corresponding appli-
cation note at http://www.asti-usa.com/ for more details.
Figure 3: Telestra Configuration Utility Welcome Screen
When the configuration utility first starts, the welcome screens displays general information about
using the application. After selecting the OK button, the Main Menu screen shown in Figure 4
appears. This menu has four options, Network Settings, Host Access, Remote Control Interface,
and Quit. The Quit option causes the configuration utility to exit and prompts the user about sav-
ing configuration changes. Any changes to the system configuration will require a system reboot
in order for the changes to take affect. The Network Settings submenu allows configuration of eth-
ernet interfaces as well as general settings such as Hostname, Domain, and Nameserver. The Host
Access choice allows users to configure the additional features of the Telestra system (i.e. host
interface and tactical data links). Finally, the Remote Control Interface option allows users to
enable or disable access to the Remote Control Interface for the Telestra federate software.

ASTi Telestra User Guide (Version 1, Revision D)
Copyright © 1999-2001 Advanced Simulation Technology inc. 6
Figure 4: Telestra Configuration Utility Main Menu

ASTi Telestra User Guide (Version 1, Revision D)
Copyright © 1999-2001 Advanced Simulation Technology inc. 7
Network Configuration
Figure 5 shows the Network Settings Menu, where users configure network information for all
three ethernet interfaces. Under the General Settings menu, users specify the Hostname, Domain,
and Nameserver for the system. For each of the remaining interfaces, the Telestra Configuration
Utility contains options for the IP address, Netmask, and Gateway. The Telestra system ships with
default values for all three interfaces. Users will need to modify the settings for the HLA and Host
interfaces to match their specific network configurations. Note that the DACS interface does not
require configuration unless under direction from ASTi. Please see Appendix A for more informa-
tion on how to configure the HLA interface in order to join a federation.
Figure 5: Network Settings Menu

ASTi Telestra User Guide (Version 1, Revision D)
Copyright © 1999-2001 Advanced Simulation Technology inc. 8
Installing a DMSO RTI (Non-U.S. Customers only)
The Telestra system normally comes with some version of the DMSO RTI installed. However, due
to legal restrictions, it is difficult to export a system with the DMSO RTI installed. To accommo-
date our overseas customers, we have installed a script which makes it easy to install a DMSO
RTI on the Telestra system. Using this script, a system can be exported and the RTI can be down-
loaded and installed by the end customer.
To download the DMSO RTI, go to the DMSO web site at http://hla.dmso.mil and register with
the software distribution center. You will need the latest RTI compiled for Red Hat Linux 6.1.
Please refer to the table below for the RTI version required for your system.
DMSO distributes the RTI in the form of self extracting shell files, which have an extension
“.sh”.Take this downloaded file and copy it to the Telestra system. The easiest way to do this is via
ftp.
Then, log in as root and execute the command ‘sh <RTIFilename>’ in the directory where the
shell file was downloaded. This will unpack the RTI into the following subdirectories: <RTI-Ver-
sion>/<platform build type>. Upon successful completion, continue to the next section. If you
have any problems extracting the RTI, contact DMSO RTI Support via their website at http://help-
desk.dctd.saic.com .
NOTE : ASTi can only guarantee that the system will work with an RTI that has been tested and
approved for use with the Telestra federate. Switching to an untested RTI may cause the system to
stop functioning.
Run the moveRTI.sh script (Non-U.S. only)
To complete the RTI installation, change directory (cd command) into the <RTI-Version>/<plat-
form build type> subdirectory. Then list the directory contents (ls command) to confirm the fol-
lowing subdirectories exist:
apps
bin
doc
etc
config
include
lib
Next, execute the ‘moveRTI.sh’ command to move the RTI components into their ASTi specific
locations.
To test if the RTI has been properly installed, log out and log in as hlauser. Then type “telestra -t”
at the prompt. If the last line printed reads “TEST OK”, then the installation was successful.
Telestra Version DMSO RTI Version
Telestra-1.1-1 RTI-NG-1.3v2
Telestra-1.2-1
Telestra-1.4-1
RTI-NG-1.3v3.1