Telestra 3 App Note

MBV Software Upgrade to 3.27 or Later (#70)

If upgrading to Model Builder Visual (MBV) software version 3.27-1 or later from MBV software version 3.26-4 or older, you must perform a Cold Start. The user must backup all configuration files and models to a different machine prior to performing the Cold Start.

To upgrade from MBV software version 3.26-4 or older to 3.27 or newer:

• Backup the System Configuration and all user Models
• Perform a Cold Start
• Recreate system configuration and users and restore models

If you are upgrading a Diskless Server, you may need to perform some additional manual backup procedures. See Application Note #67 for details.

Backing up the System Configuration and Models

If upgrading to Model Builder Visual (MBV) software version 3.27-1 or later from MBV software version 3.26-4 or older, you must perform a Cold Start. The user must backup all configuration files and models to a different machine prior to performing the Cold Start.

In addition to the System Configuration Backup, the user must back up models in the individual system accounts.

Note: The model backup also saves the sound files associated with the model.

What files are backed up via the Telestra web interface?

• TelestraConfig: All configuration settings such as network settings and system preferences
• RadioEnvironmentConfig: All Radio Environment settings including filter lists
• XServerSetup: All monitor screen settings such as your specified screen resolution
• Options: All option files loaded on your system
• SatComConfig: All satellite communications settings.
• PropagationConfig: All radio system configurations used to produce realistic communications in the virtual environment including time-of-day, time-of-year, global location, solar cycle, sunspot activity and more
• DisklessClients: All settings for the Remote Clients including name, mac address, and model name
• UsersAndConfig*: All the Telestra web interface users and their passwords, as well as any user lockout settings for the Telestra web interface

• SysUserAuthenticationConfig*: The Linux system's PAM configuration files which are used for system-level account lockouts

  * In Telestra software versions 3.31-1 and later, these system backup categories will change. The new categories and their contents will be:

• UserAccounts: Data for all Telestra web interface users, their encrypted passwords, and individual failcounts
• UserLockoutSecurityConfig: All the PAM configuration files, as well as the Telestra web interface lockout settings

Procedure

1. Open the Telestra web interface and navigate to the "Telestra >> Actions" tab and select "Telestra Backup."
2. Select the "Check All" button.

3. Select the "Start Backup" button.

   

4. Click the filename to download the archive file to your local machine.

   

5. Navigate to the "Models Management" tab and back up each model (all model sections) for each system user.

   Note: The Telestra web interface only facilitates archiving and restoring the models in its user accounts. If the user chooses to store any other information in their home directories, they are responsible for backing it up manually.

   

Telestra Cold Start

Perform a Cold Start with the latest MBV software version, as detailed in the Telestra 3.0 Cold Start Procedure

Restoring System Accounts, System Configuration and Models

All Telestra web interface users are saved and restored via the standard system configuration backup available in the Telestra web interface. Telestra web interface users do not need to be manually recreated.

1. To create the necessary system-level user accounts, click the "Manage Users" button in the top right corner of the Telestra web interface page.
2. For each system-level user, add a new user name, password and click the "Add SYSTEM User" button to add. For more information about the Telestra web interface users vs. System-Level users, refer to section 4.0 of the Telestra 3.0 User's Guide.

3. Repeat step two to recreate all previous system-level user accounts.

   

4. Navigate to the Telestra web interface Telestra >> Actions page and select "Restore System Configuration" to restore your backup files.

   

5. Select the "Choose File" button to browse for the system configuration files and model files. After the proper file is selected, click the "Upload Backup Files" button.

   

6. When presented with the contents of the system backup file, click the "Check All" button, then click "Start Restoration" to begin loading the system configuration.

   
7. Once complete, you should reboot the Telestra system before proceeding.
8. Finally, restore all the system models, as outlined in the "Uploading & Installing Model Files" section of Chapter 6 in the Telestra 3.0 User's Guide.