How to manage my GroundWork license

REDIRECT: This URL has changed to https://support8.gwos.com/gw/gw8/latest/faqs/how-to-manage-my-groundwork-license
Click the link above if you are not automatically redirected in 10 seconds.
Q: How to manage my GroundWork license?
A: As a user with the Admin role, from the Administration menu item, choose License.

License details

The Administration > License page displays Licensed to, Version licensed, Version installed, Hosts licensed, Hosts monitored, License start and end dates, Today's date, and the Time remaining on the license, and the license field where you can apply or update your license key.

New and existing installations

Each installation of GroundWork Monitor Enterprise requires a key. 

  • If you need a new key, please Submit a Ticket from the GroundWork Support portal, or contact Sales at sales@gwos.com.
  • For new installations a key is emailed to customers following purchase.
  • For existing installations, you will need to input a new key if your existing key has reached the subscription expiration date or you have exceeded the number of devices purchased. The License page will display a Warning when your device allocation is over the soft limit (typically slightly less than the hard limit).
  • For a free 60-day trial license key for larger numbers of devices, please see Request a Trial.

Password maintenance

Over license limit

It is recommended to check your license limit prior to configuring Cloud Hub connections. Please see Cloud Hub troubleshooting

If you exceed your hard limit of devices, you will not be able to log in and adjust anything but the license key. Your system will continue to monitor and alert. If you encountered this in error, please Submit a Ticket to get a temporary key. It is also possible to remove devices from the command line in many cases.

Default gw8-docker* hosts

GroundWork Monitor 8.x out-of-the-box includes self monitoring of containers, named gw8-docker*, which comprise a total of 24 hosts. You can view these hosts by going to Configuration > Dashboards > Status > GroundWork Servers. As of GroundWork Monitor 8.1.0, These hosts do count against your license. You can choose to delete these hosts from Nagios and delete the Docker connector to reduce the posted device count on the License page. If you have the overhead, however, you can choose to keep these to have the server perform the self monitoring. These hosts are optional, however it is best practice is to maintain these hosts.

For 8.1.0 updates, if you do choose to remove the Docker Cloud Hub connection with the self-monitored containers, please note the ConnectorMonitor host is not removed. See next section.

ConnectorMonitor host

GroundWork Monitor 8.0.0 and 8.1.0 include a host called foundation, which has been renamed in 8.1.0 to ConnectorMonitor. The purpose of this host is to provide connector status for configured Cloud Hub connections. It consumes one license count, however it is optional and may be removed for post 8.1.0 updates. For 8.1.0 the ConnectorMonitor host is not enabled by default.

To remove the foundation host after updating to GroundWork Monitor 8.1.0:

  1. Stop Cloud Hub:

    cd gw8 docker-compose stop cloudhub
  2. Edit the cloudhub.properties file from connector.monitor.hostname=ConnectorMonitor to connector.monitor.hostname=foundation and save:

    docker-compose exec nagios bash
    vi /usr/local/groundwork/config/cloudhub.properties 
    connector.monitor.hostname=foundation
  3. Return to the gw8 directory and start Cloud Hub:

    exit docker-compose up -d cloudhub
  4. Uncheck the Monitor configuration option for each connector that had it enabled.

    Stop Cloud Hub (from gw8):

    docker-compse stop cloudhub
  5. Re-edit the cloudhub.properties from connector.monitor.hostname=foundation to connector.monitor.hostname=ConnectorMonitor and save:

    docker-compose exec nagios bash 
    vi /usr/local/groundwork/config/cloudhub.properties 
    connector.monitor.hostname=ConnectorMonitor
  6. Return to the gw8 directory and start Cloud Hub:

    exit docker-compose up -d cloudhub

Related articles