Monitoring, Management & Location Tracking

If the VisualRF data has become corrupted and VisualRF will not run, here are the steps for restoring VisualRF data by extracting it from a data backup file. 

(See examples at bottom of article for quick reference.)

The backup must be from a time when VisualRF was running correctly. If VisualRF stopped working immediately after upgrading, you can use the pre-upgrade backup. If VisualRF stopped working after nightly maintenance, you can use the last good nightly data backup. Please be advised that any changes made to VisualRF after the backup was created (like adding floor plans) will be lost.

The backup files are located in:

/var/airwave-backup/

Overview:
1. DISABLE VISUALRF
2. Add amp.parser.cache.refresh=false to the end of /usr/local/airwave/lib/java/amp.properties.
3. Copy off existing data from /var/airwave/cache and /var/airwave/data
4. Remove existing data from /var/airwave/cache and /var/airwave/data
5. Extract data from backup file
6. Enable VisualRF
7. DISABLE VISUALRF again
8. Remove edit made to amp.properties file in Step 2
9. Enable VisualRF

Detailed Steps

1. DISABLE VISUALRF

- SSH into the AMP and tail the VisualRF log

# tll visualrf.log

- In the GUI go to the VisualRF > Setup page, select Disable and <Save>.
- Check the log to see that VisualRF has shut down completely. You should see something like:

. . . com.airwave.core.ShutdownHook shutdown complete

- Ctrl-c to end tail


2. Using vi, nano or the editor of your choice, edit /usr/local/airwave/lib/java/amp.properties and add the entry amp.parser.cache.refresh=false to the end of the file.

# vi /usr/local/airwave/lib/java/amp.properties

- Add the following line to the bottom of the file

amp.parser.cache.refresh=false


3. Copy off existing data from /var/airwave/cache and /var/airwave/data

# mkdir /tmp/visualrf-save
# mkdir /tmp/visualrf-save/cache
# cp -r /var/airwave/cache/* /tmp/visualrf-save/cache
# mkdir /tmp/visualrf-save/data
# cp -r /var/airwave/data/* /tmp/visualrf-save/data
# ls -R /tmp/visualrf-save


4. Remove existing data from /var/airwave/cache and /var/airwave/data

NOTE: DO NOT remove the /var/airwave/cache/ and /var/airwave/data/ directories themselves.

# cd /var/airwave/cache/
- Check that you're in the right directory and check its contents
# pwd
# ls -R
- Delete contents
# rm -r *

# cd /var/airwave/data/
- Check that you're in the right directory and check its contents
# pwd
# ls -R
- Delete contents
# rm -r *


5. Extract data from backup file

- Run the following commands. (Replace BACKUP_FILE with something like pre-upgrade-6.2.3-data.tar.gz or nightly_data001.tar.gz. See examples at bottom of article.)

# cd /
# tar -zxvf /var/airwave-backup/[BACKUP_FILE] var/airwave/cache -Cp /var/airwave/cache 

# tar -zxvf /var/airwave-backup/[BACKUP_FILE] var/airwave/data -Cp /var/airwave/data

- Check that the permissions on the files are correct:

# ls -R /var/airwave/cache
# ls -R /var/airwave/data

- They should look something like this:

drwxr-xr-x 2 visualrf apache 4096 Jun 9 13:57 fastmmap/


6. Enable VisualRF

- Go to the VisualRF > Setup page, select Enable and <Save>.
- Wait a couple of minutes for VisualRF to come back up completely before accessing any floor plans.
- Check floor plans to make sure everything is correct

7. DISABLE VISUALRF again
(see Step 1.)

8. Remove edit made to amp.properties file in Step 2

# vi /usr/local/airwave/lib/java/amp.properties

- Remove the following line from the bottom of the file

amp.parser.cache.refresh=false

9. Enable VisualRF
(See Step 6.)

DONE

Example 1 -- from 6.2.3 pre-upgrade backup:

# cd /
# tar -zxvf /var/airwave-backup/pre-upgrade-6.2.3-data.tar.gz var/airwave/cache -C /var/airwave/cache 
# tar -zxvf /var/airwave-backup/pre-upgrade-6.2.3-data.tar.gz var/airwave/data -C /var/airwave/data

Example 2 -- from nightly backup:

# cd /
# tar -zxvf /var/airwave-backup/nightly_data001.tar.gz var/airwave/cache -C /var/airwave/cache 
# tar -zxvf /var/airwave-backup/nightly_data001.tar.gz var/airwave/data -C /var/airwave/data