Update Install

Update from Installer

This page steps through an update installation for GroundWork Monitor 8.0.0. The Update from Installer is an offline method, does not require internet access, and uses a distributed GroundWork Installer file to install.

Prepare and Run

  1. First, check your system is prepared as described in System Requirements, including installing Docker CE and Docker Compose.
  2. Review the Release Notes for the version you are upgrading to, 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. The Installer method of installation supports updates, and  running the Installer will update an existing GroundWork Monitor installation.

    It is recommended you perform a backup before updating your installation. 
  4. 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. 
  5. Next, go to the Downloads page and select the Installer file for the new version and place it in this directory.
  6. Change the installer mode:

    chmod +x gw8setup-8.0.1-GA.run
  7. If you are running the optional NeDi netflow or nfpcapd containers, stop them by hand: 

    docker ps |grep nfcapd
    docker ps |grep nfpcapd

    This will give you the container name as the last column in the output, like this: 

    e5a971431d05      groundworkdevelopment/nedi:8.0.0-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

  8. Run the installer: 

    ./gw8setup-8.0.1-GA.run
  9. The installer will function much as it does during a New Install, with the exception that it will not prompt for a host name if the host name is already set. The installer will shut down GroundWork, extract all the new containers, update the system and restart it.
  10. If you want to run the optional NeDi netflow or nfpcapd containers again, start them with: 

    docker start nfcapd_collector
    docker start nfpcapd_capture

     or re-create them with this procedure.

Related articles