Quick Start FAQs


This page outlines Quick Start troubleshooting tips. Please refer to the Bookshelf in its entirety for detailed product documentation. If you need help contact GroundWork Support.


Q: How do I set up DNS config?
A: If you use a hostname for the GroundWork server, verify that it can be resolved using ping. You may need to add a DNS host entry on the GDMA client for the GroundWork server called "gdma-autohost". This needs to work prior to installing GDMA.

  1. From the GDMA client command prompt or command line, ping the GroundWork server host name:
    • For Windows:
      C:\Users\Administrator>ping <gwserverhostname>
    • For Linux:
      [root@gdmaclient /]# ping <gwserverhostname>
  2. If you receive a message similar to Ping request could not find host name you will need to add an entry to the hosts file (e.g., GroundWork server with an IP address     gdma-autohost
    • For Windows: Start > Computer, and make your way to edit the C:\Windows\System32\drivers\etc\hosts file, add an entry, save the file.
    • For Linux: From the command line, open an editor to the etc/hosts file, add an entry, save the file.
  3. Now, if properly registered in DNS, entering ping gdma-autohost from the client should resolve to the GroundWork server (showing Windows):
    Pinging gdma-autohost [] with 32 bytes of data:
    Reply from bytes=32 time=254ms TTL=64
    Reply from bytes=32 time=99ms TTL=64
    Reply from bytes=32 time=2ms TTL=64
    Reply from bytes=32 time=2ms TTL=64
    Ping statistics for
        Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),
    Approximate round trip times in milli-seconds:
        Minimum = 2ms, Maximum = 254ms, Average = 89ms

Q: How do I check the port config?
A: Ensure the server to be monitored can communicate with the GroundWork server on ports 80 and 5667. For Linux based operating systems the procedure for opening ports in the Linux firewall iptables is relatively simple.

Q: How do I enable downloading the agents from the GroundWork server?
A: Since not all customers use GDMA, browsing to the agents directory on the server is not enabled by default, therefore you will need to edit the httpd.conf file to add an allowance. Additionally, on the GroundWork server you will want to ensure Build Externals is enabled to write out the agent configuration files.

  1. On the GroundWork server edit the httpd.conf file:
    vi /usr/local/groundwork/apache2/conf/httpd.conf
  2. Add the following lines in the Directory section, and save the file:
    <Directory /usr/local/groundwork/apache2/htdocs/agents>
    Options +Indexes -FollowSymLinks -ExecCGI -Includes
    AllowOverride None
    Order Allow,Deny
    Allow from all
  3. Restart Apache:
    /etc/init.d/groundwork restart apache

Q: How do I verify externals are enabled?
A: Log in to GroundWork Monitor as a GroundWork Administrator (e.g., admin/admin). Go to Configuration > Control, and select Setup. Verify the Enable externals option is checked, if not, check and Save, and run Pre flight and Commit.

Q: How do I add services?
A: By default, the GDMA agent will automatically check the services assigned in the gdma-21-linux or gdma-21-windows profiles located in Configuration > Profiles. While you can certainly add services by following the Resources > Documentation, we ask that you contact demo support for assistance the first time.

Cloud Hub

Q: What Cloud Hub information will I need to establish a connection?
A: To configure Cloud Hub for VMware, you will need the following information:

  • Is SSL enabled on VMware the server?
  • VMware Server Name: (FQDN)
  • VMware Server URI: (usually sdk)
  • VMware Server Username: (usually esxuser)
  • VMware Server Password: (password for username)

Q: How do I obtain the RESTAPIACCESS user token?
A: You need to obtain the RESTAPIACCESS user token from the GroundWork server:

  • Open a terminal or ssh session to the GroundWork server.
  • As sudo or root user, locate and copy the webservices_password token value from the ws_client.properties file:
    cat /usr/local/groundwork/config/ws_client.properties \| grep webservices

Return to Quick Start.


quickstart quickstart Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.