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.
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 email@example.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.
- For encrypted internal passwords please see System Security.
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.
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:
Stop Cloud Hub:
cd gw8 docker-compose stop cloudhub
docker-compose exec nagios bash vi /usr/local/groundwork/config/cloudhub.properties connector.monitor.hostname=foundation
Return to the gw8 directory and start Cloud Hub:
exit docker-compose up -d cloudhub
Uncheck the Monitor configuration option for each connector that had it enabled.
Stop Cloud Hub (from gw8):
docker-compse stop cloudhub
docker-compose exec nagios bash vi /usr/local/groundwork/config/cloudhub.properties connector.monitor.hostname=ConnectorMonitor
Return to the
gw8directory and start Cloud Hub:
exit docker-compose up -d cloudhub
FAQs (Knowledge Base)
How To's (Knowledge Base)
How to add a host to black list (Knowledge Base)
What open source licenses are used in GroundWork (Knowledge Base)
How to manage your device count (Knowledge Base)
FAQs (GroundWork Support 8)
How can I find the local timezone? (GroundWork Support 8)
How To's (GroundWork Support 8)
How to manage my GroundWork license (GroundWork Support 8)