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 RMS?
  • 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
  • RMSUsersAndConfig*: All RMS users and their passwords, as well as any user lockout settings for RMS
  • 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:

  • RMSUserAccounts: Data for all RMS users, their encrypted passwords, and individual failcounts
  • UserLockoutSecurityConfig: All the PAM configuration files, as well as RMS lockout settings

Procedure
  1. Open RMS and navigate to the "Telestra >> Actions" tab and select "Telestra Backup."
  2. Select the "Check All" button.
  3. Select the "Start Backup" button.
    RMS screen capture
  4. Click the filename to download the archive file to your local machine.
    RMS screen capture
  5. Navigate to the "Models Management" tab and back up each model (all model sections) for each system user.

    Note: RMS 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.

    RMS screen capture

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 RMS users are saved and restored via the standard system configuration backup available in RMS. RMS 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 RMS 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 on RMS 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.
    RMS screen capture
  4. Navigate to the RMS Telestra >> Actions page and select "Restore System Configuration" to restore your backup files.
    RMS screen capture
  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.
    RMS screen capture
  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.
    RMS screen capture
  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.