Update Install

This section steps through an update installation for GroundWork Monitor 8.1.0. The Update Install uses the Update from Installer method which is an offline method, it does not require internet access other than for the download, and it uses a GroundWork Installer file to install.

Prepare

1. First, verify your running GroundWork 8.0.0 or 8.0.1 system is up to date as described in System Requirements. It most likely is, but it's a good time to update and patch the OS. 
2. Review the Release Notes for 8.1.0, which contain details of issues fixed, new features, and items of interest to those users who have customized or significantly enhanced a previous version of GroundWork Monitor. 
3. You may need to obtain a new license for 8.1.0 from GroundWork Support. This version will not work with licenses that are specifically for 8.0.x (like the default 50-host core licenses issued with 8.0.x), and you don't want to go all the way through an upgrade just to wait for a license to be generated before you can use the system. Existing customers are welcome to equivalent 8.1.0 licenses at no extra cost, and many existing customers have been issued licenses that are for 8.x.x, so you may just want to check with support to be sure.

4. Running the Installer will update an existing GroundWork Monitor installation without any changes to configuration or license.

   It is recommended you perform a backup before updating your installation. 

5. Open a command line to the directory where you installed GroundWork Monitor 8. This is the directory above the gw8 directory. Check with an ls command to be sure. You should see the gw8 directory listed. 
6. Next, go to the Downloads page, navigate to and select the Installer file for the new version and place it in this directory.

7. Change the installer mode:

   chmod +x gw8setup-8.1.0-GA.run

8. If you are running the optional NeDi netflow or nfpcapd containers, stop them manually: 

   docker ps |grep nfcapd
   docker ps |grep nfpcapd

   This will give you the container name as the last column in the output, for example: 

   e5a971431d05      groundworkdevelopment/nedi:8.0.1-GA     "nfpcapd -i eth0 -T …"   49 minutes ago      Up 49 minutes (health: healthy)      nfpcapd_capture  

   Usually, these are nfcapd_collector (for NetFlow) and nfpcapd_capture (for packet capture). For each of these containers, type: 

   docker stop <name>

   where <name> is the name of the container, e.g., nfcapd_collector.

Run

After completing the Prepare steps above, you can proceed by running the installer:

1. Run the installer: 

   ./gw8setup-8.1.0-GA.run

2. The installer will function much as it does during a New Install, with the exception that it will not prompt for a host name or installation type. The installer will shut down GroundWork, extract all the new containers, update the system and restart it.

3. If you want to run the optional NeDi netflow or nfpcapd containers again, start them with the following: 

   docker start nfcapd_collector
   docker start nfpcapd_capture

   or re-create them with this procedure NeDi Flowi NetFlow sFlow and packet capture.

4. Log in as an administrative user and apply your new license to use 8.1.0.

Migrate Install

This section steps through the process for migrating Monarch to GroundWork Monitor 8. You will first need to refer to the New Install tab above to perform a new installation. After installation you can refer to the migration tasks on this page.

GroundWork Monitor 7.x

The following steps can be used to capture your existing GroundWork Monitor 7.x Nagios configuration database from your latest backup.

1. Access the command line on your Groundwork 7.x server, for example via SSH. We assume you are using a user that is not root, but has sudo access. If you use root, then you can omit the sudo part. 

2. Copy and paste the following command and run it:

   sudo tar -C /usr/local/groundwork/core/monarch/backup \
       -czf /tmp/$(ls /usr/local/groundwork/core/monarch/backup | tail -1).tar.gz \
       $(ls /usr/local/groundwork/core/monarch/backup | tail -1)

   This will produce a file such as /tmp/2018-12-26_16-44-47.tar.gz. This is the backup to be transferred. Note the date portion of the filename as the timestamp for the next steps, e.g., "2018-12-26_16-44-47" in this example. 

GroundWork Monitor 8

1. Transfer the backup you made above to the GroundWork 8 server. Place it in the gw8 directory. Use any secure method of transferring files you like, e.g., SCP. 

2. From the command line on the GroundWork 8 server, change to the gw8 directory:
   

   cd gw8

3. Substitute the appropriate timestamp from your captured filename and set it as the timestamp variable. For example (you will need to use your own timestamp):
   

   timestamp=2018-12-26_16-44-47

4. Copy and paste the following two commands to set the TAG variable and load the configuration:

   TAG=$(grep '^TAG=' .env | sed 's/^TAG=//')
   docker run --rm \
       -v ${PWD}/$timestamp.tar.gz:/$timestamp.tar.gz \
       -v dockergw8_monarch-backup:/usr/local/groundwork/monarch/backup \
       --name gw8 groundworkdevelopment/gw8:${TAG} \
       /src/docker_cmd.sh loadMonarchBackup $timestamp.tar.gz

5. In GroundWork Monitor 8, go to Configuration > Nagios Monitoring > Control > Back up and restore and proceed to restore the GroundWork Monitor 7.x backup with the noted timestamp.

   You should disable notifications before committing the imported configuration. This will allow to identify any unforeseen problems without creating a notification storm. 

   Notifications are automatic in NoMa as well as Nagios. To disable notifications, for NoMa go to Configuration > Notifications and check each notification rule that is currently active (green checkmark) to be disabled (grey checkmark), and for Nagios go to Configuration > Nagios Monitoring > Control > Nagios main configuration > Notification and uncheck Enable notifications.

Uninstall

This uninstall process completely removes GroundWork Monitor 8, removing volumes and containers and the docker directory. It does not remove other docker containers and volumes that may exist on the same host. 

1. Go to the Docker directory you created when you installed GroundWork Monitor 8.

2. Go to the gw8 directory:

   cd gw8

3. Shut down the existing containers:
   

   docker-compose down

4. Remove GroundWork Monitor 8 volumes and containers:
   

   docker volume ls | grep "$(grep COMPOSE_PROJECT_NAME .env | sed -e 's/^[^=]*=//')_" | \
       awk '{print $2}' | xargs docker volume rm
   docker images -a | grep "groundworkdevelopment/" | \
       awk '{print $3}' | xargs docker rmi

5. Remove the docker directory:
   

   cd ..
   rm -rf gw8