User Guide: Vista Manager AWC Plug-in version 3.3.1

Backup and Restore AWC Plug-in System

AWC Plug-in > Operation Reference > Plug-in System Data Management > Backup and Restore AWC Plug-in System

Backup System Data
Restore System Data
Unregister AWC Plug-in
Restore
Re-register AWC Plug-in

This section explains how to backup and restore the AWC Plug-in system.

Note
Make sure that directories and files used for backup and restoration do not contain any multibyte characters.
Note
Do not apply the EFS encryption function of Windows to the directory where Vista Manager EX is installed or the directory where backup files are stored.

Backup System Data

System Data includes the AWC Plug-in's AP management configuration and system settings.
Note
The following settings are not backed up because they are environment-dependent. Please re-configure manually according to your environment:

- Server PC's IP address
- Protocol (http/https) used for Server PC's management web interface
- Server Certificate
Note
It does not contain Vista Manager EX's AMF device information, licenses, and the SNMP Plug-in's network management data.
Data managed by Vista Manager EX and the SNMP plug-in system should be backed up by a separate utility for each system.
Therefore, it is recommended that you also take backups for Vista Manager EX and the SNMP Plug-in when you backup AWC Plug-in system data.
Note
It is recommended that you take a backup regularly.
  1. From the Windows program menu, select "AT-Vista Manager EX", right-click "AT-AWC - Backup Restore" and click "Run as administrator".

  2. The "AT-AWC Plug-in Backup and Restore Utility" dialog box will appear.

  3. Select the "Backup" tab and enter a destination folder, a password (optional), and a comment (optional).
    Note
    The file save destination should be a directory to which the EFS encryption function of Windows has not been applied.

  4. Choose whether to save logs to a file.
    Logs are not backed up to the backup file. If you want to view existing logs after an update, check "Save logs in a separate file" so that the logs are exported to a CSV file.
    By default this option is not checked.

  5. Click "Run".

  6. Click "Yes" to the confirmation message.

  7. After the backup process has finished, a dialog box which shows the backup is over will appear. Click "OK".
    A backup filename will be in the format of "config_atawc-X.X.X_BXX-YYYYMMDD-hhmmss.zip".
    If you checked "Save logs in a separate file", the logs will be exported to the file with the name in the format of "log_atawc-X.X.X_BXX-YYYYMMDDhhmmss.zip".

Restore System Data

To restore system data for the AWC Plug-in, you have to unregister the AWC Plug-in from Vista Manager EX, restore its backup file, then re-register the Plug-in.
Note
When Vista Manager EX starts for the first time after restoring the previous version's backup file, the AWC Plug-in will automatically apply the settings to the APs. Please note that this operation will temporarily stop wireless traffic.
Note
If the disk space is insufficient when restoring the AWC Plug-in's backup file, the restore process will fail.
In such a case, make more free space on the disk by deleting unused files and perform the restore operation again.
Note
The SNMP Plug-in service stops temporarily while the AWC Plug-in is being restored.
The SNMP Plug-in will automatically resume its operation after the AWC Plug-in's restoration is complete.
Note
The users' network permissions database for the Management Group is retained in Vista Manager EX itself.
When restoring the backup file of the AWC Plug-in, the data related to the AWC Plug-in will be initialized once. If you restore the AWC Plug-in after Vista Manager EX, the network permissions information of the users for the Management Group will be deleted and the association may not be correct even after the restoration.
If you restore Vista Manager EX after the AWC Plug-in, the users' network permissions information for AWC Plug-in's Management Groups will be restored correctly.
When restoring only the backup file of the AWC Plug-in to the operating Vista Manager EX system, set the users' network permissions again after the restoration.

Unregister AWC Plug-in

If you have registered the AWC Plug-in on Vista Manager EX's Plug-in Management page, unregister the Plug-in.
  1. Select "System Management" from the main menu.

  2. Click "Manage Plug-ins" from "Vista Manager EX" on the "About" tab.

  3. Click "AWC Plug-in" on the plug-in list at the left side of the screen.

  4. Click "Delete" at the bottom of the plug-in information on the right side of the page.

  5. A confirmation message will be displayed in the "Delete Plug-in" dialog box.
    Click "Delete" again.

Restore

  1. To stop the AWC Plug-in server, select "AT-Vista Manager EX" > "AT-AWC - Stop Server" from the program menu.

  2. From the Windows program menu, select "AT-Vista Manager EX", right-click "AT-AWC - Backup Restore" and click "Run as administrator".

  3. Select the "Restore" tab and enter a backup filename, and a password if needed.

  4. To restore system data from a backup file, check "Restore system information".
    System Configuration includes the following:

    • Database Setting
      • Maximum Memory Usage
    • Data Retention Period Setting
      • Associated Client History
      • Client Location Estimation History
      • IDS Report History
    • Network Map Setting
      • Wireless Client Update-Interval

    In addition, Client Location Estimation History data is also recovered from the backup file.

  5. Click "Run".

  6. Click "Yes" to the confirmation message.

  7. After the restoration process has finished, a dialog box which shows the restoration is complete will appear. Click "OK".

◼ If the floor map image is not shown properly after the restoration process
If the EFS encryption function of Windows is applied to the installation directory or the directory that stores the backup file, the restored floor map image may not be shown properly.

If your environment security policy enforces the EFS encryption function on the installation directory or the directory that stores the backup files, use the following procedure to remove the EFS encryption function of the floor map image.
  1. Open the [Vista Manager EX Installation Directory]\Plugins\AT-AWC\amf_gui\ver\FloorMap folder.

  2. If you have a file with a key mark, right-click the file and click "Properties".

  3. In the "General" tab of the "(file name) Properties" window, click the "Advanced" button in "Attributes" group.

  4. Uncheck the "Encrypt contents to secure data" of "Compress or Encrypt attributes", and click "OK".

  5. Click "OK" in the "(File name) Properties" window to close it.

Re-register AWC Plug-in

  1. Select "System Management" from the main menu.

  2. Click "Manage Plug-ins" from "Vista Manager EX" on the "About" tab.

  3. Click "Add Plug-in" at the top right of the "Plug-in Management" page.

  4. Enter the AWC Plug-in's URL in the "Server URL:" field.

    • AWC Plug-in: https://localhost:5443/wireless_plugin
    Note
    If you have changed the port of the AWC Plug-in service, specify the port number after the hostname and colon in the URL, for example "localhost:8443".

  5. Click the "Test Connection" button.

  6. When a response is received from the AWC Plug-in URL, the SHA1 and SHA256 fingerprints of the plug-in certificate will be displayed in the "Plug-in Certificate Fingerprints" field.
    Confirm the fingerprints and click "Save" to register the plug-ins.

  7. Upon successful registration, "AWC Plug-in" will be added to the plug-in name list.
    The AWC Plug-in menu icon will be also added to the Vista Manager EX main menu.


(C) 2020 Allied Telesis, Inc. All rights reserved.

C613-04089-00 Rev A

06 Oct 2020 11:30