User Guide: Vista Manager AWC Plug-in version 3.11.0

# Backup and Restore AWC Plug-in System

Backup System Data
Backup via Web Management Screen
Backup via External Utility
Restore System Data
Restore via Web Management Screen
Restore via External Utility
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

> > 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.

### Backup via Web Management Screen

You can perform backup and restoration from the System Settings screen.

1. Log in to Vista Manager EX using an Admin account.
2. Select "System Setting" from the AWC Plug-in menu.
3. Check the "Include Log Data" checkbox on the right side of the "Backup" button in "System Maintenance" as desired.
   Check the checkbox if you want to download the log data together as a backup file.
   If you do not need the log data, uncheck the checkbox.
4. Click the "Backup" button under "System Maintenance".
5. After the backup is taken, download of the backup file starts.
   Use your web browser's dialog box to save the backup file to your local computer.
   A backup filename will be in the format of "config_atawc-X.X.X_BXX-YYYYMMDD-hhmmss.zip".

### Backup via External Utility

To restore the AWC Plug-in settings from a backup file, launch the "AT-AWC Plug-in Backup and Restore Utility" that comes with the AWC Plug-in.

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. At "Log" in "Backup" tab, select whether you want to save the logs to a file.
   By checking the "Back up the logs.", the backup file will be output with the log data included.
   Also, check "Save logs separately" so that the logs are exported to a CSV file.
   By default, both option are 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

> 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

> > The users' network permissions database for AWC management group is retained in Vista Manager EX.
> > 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 management group 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' management group 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' management group permissions again after the restoration.

> Note

> > Restoring a backup file made on another platform is not supported.

### Restore via Web Management Screen

You can perform backup and restoration from the System Settings screen.

> Note

> > Backup files created with passwords using external utilities cannot be restored from the management web interface.
> > Backup files with passwords should be restored using the external utility.

1. Log in to Vista Manager EX using an Admin account.
2. Select "System Setting" from the AWC Plug-in menu.
3. To restore system settings from a backup file, check the "Restore System Setting" checkbox under "Restore" in "System Maintenance".
   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
   - Log Setting
     - Maximum Number of Logs
     - Retention Period
   In addition, Client Location Estimation History data is also recovered from the backup file.
4. Click the "Restore" button under "System Maintenance".
   The "Restore" dialog box will appear.
5. Click the "Select File" button to select the backup file.
6. Click "Run".
7. Click "OK" on the confirmation dialog box.
8. After the restoration process has finished, a dialog box which shows the restoration is complete will appear. Click "OK".
   In addition, Client Location Estimation History data is also recovered from the backup file.

### Restore via External Utility

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.

#### 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. Select "Plug-ins" in the list on the left side of the Content section.
3. Click "AWC Plug-in" in the plug-in list at the bottom right of the screen.
4. Click "Delete Plug-in" at the top right of the plug-in information.
5. A confirmation message will be displayed in the "Delete Plug-in" dialog box.
   Click "Delete" again.

#### Restore

To restore the AWC Plug-in settings from a backup file, launch the "AT-AWC Plug-in Backup and Restore Utility" that comes with the AWC Plug-in.

> Note

> > If disk space is insufficient when restoring the AWC Plug-in's backup file, the restoration process will fail.
> > In such a case, free up disk space 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.

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. Click the "Restore" tab, select 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
   - Log Setting
     - Maximum Number of Logs
     - Retention Period
   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. Select "Plug-ins" in the list on the left side of the Content section.
3. Click "Add Plug-in" on the right side of the "Plug-in Management" screen.
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".

   Once you enter an appropreate URL, the verification of connection runs automatically.
5. 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.
6. 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.

14 Dec 2023 10:09