Important: This procedure only applies to QSystem Monitor v12 or lower.

MSM-BACK and MSM-RSTR Tools

The purpose of the MSM-BACK and MSM-RSTR scripts is to back up and restore the configuration of the QSystem Monitor (QSM) PC software. The scripts contain settings such as the window layout for the Monitor module, groups in the Monitor module, and the local threshold definitions.

Quick Start

Backing up the configuration

On the PC on which you want to save the QSM configuration:

  1. Save these scripts to the PC.

  2. Open a command line (cmd).

  3. CD to the folder in which these scripts have been placed.

  4. Run this command: msm-back "".

    Note: Enclose path in quotation marks.

Restoring the configuration

On the PC on which you want to restore the QSM configuration:

  1. Save these scripts to the PC.

  2. Open a command-line (cmd).

  3. CD to the folder in which these scripts have been placed.

  4. Run this command: msm-rstr "".

    Note: Enclose path in quotation marks.

Files that are Provided

The files are:

  • msm-back.bat: Backs up the local PC software configuration.

  • msm-rstr.bat: Restores the PC software configuration to the local PC.

  • replace.vbs: A utility script used by msm-rstr.bat.

  • getmsmprogramfolder.vbs: A utility script used by msm-back.bat and msm-rstr.bat.

  • Read Me for...: This is a ReadMe file.

The .bat script files may have been provided to you with a file extension other than .bat. In that case, rename the extension to .bat (for the msm-back and msm-rstr scripts) before you use the files.

The .vbs script files may have been provided to you with a file extension other than .vbs. In that case, rename the extension to .vbs (for the replace and getmsmprogramfolder scripts), before you use the files.

Usage Notes

The following notes contain information you should be aware of as you follow the backup and restore procedures.

  • There's only one command line argument for both scripts: the path of the backup folder.

  • If the backup folder path contains blank spaces, you will need to enclose it in quotation marks. Following are two examples:

    msm-back C:\Temp
    (<---- the="" path="" contains="" no="" spaces="" quotation="" marks="" are="" optional="" p="">

    msm-rstr "H:\Shared\MSM Restore"
    (<---- the="" path="" contains="" a="" space="" therefore="" quotation="" marks="" are="" required="" p="">

     

  • To display the help for the scripts, use the /help arguments:

    msm-back /help

    msm-rstr /help

  • The scripts must be run by a Windows user account that has Administrator permissions.

  • Both scripts require the QSM PC software to have been installed on the local PC. So, on the target PC, be sure to install QSM before running the msm-rstr script.

  • If you use the msm-back script and specify a backup folder that resides on a removable drive, such as a USB stick, then after running msm-back, make sure to eject the USB drive before physically removing it.

  • If the QSM PC software is installed in different folders on the source and target PC:
    • The scripts generally handle that situation. The only exceptions are described below.

    • You may receive error messages when you first use a QSM PC module after using msm-rstr. The error messages state that a .msm file or a .msm.bak file is corrupt, or that the file contains an incorrect path. This is because the path of background images are contained in the .msm and .msm.bak files, but cannot be altered by the msm-rstr script. Click OK on all of the error messages. Then use the Monitor module to reassign background images as needed.

    • If the source PC runs under a 32-bit version of Windows and the target PC runs under a 64-bit version of Windows (or vice versa), and in the QSM installation program the default suggestion was used as the installation folder, then this also results in QSM residing in two different folders between the source and target. This may also cause error messages as described above.

Setting a Unique PC Name

The msm-rstr.bat script recommends that you use the Connection Wizard to provide a unique name for your PC. The reason is that in situations where the QSM configuration is copied from one PC to another, the PC Name is copied as part of the configuration, which may lead to use of duplicate PC names.

The PC Name is a QSM setting that allows the MSM host to uniquely identify each PC on which QSM PC modules are running. If the same PC Name is used on more than one PC at one time, QSM is not able to correctly identify each PC. Therefore, using the Connection Wizard to define a unique name (a name that is only used on one PC at any given point in time) is strongly recommended.

 

 


Still have questions? We can help. Submit a case to Technical Support.

Last Modified On: January 11, 2018