How to use the Amazon EC2 AMI for GroundWork Monitor 6.5

GroundWork Monitor 6.5 in the Amazon Cloud (EC2)

Last updated: September 27th 2011
GroundWork Monitor 6.5 Enterprise is available as a ready-to-run 64-bit Amazon Machine Image (AMI) running on CentOS

Quick-start information

If you're an experienced EC2 users this the information you'll need:
AMI name: ami-7bb17c12 in the US-East region.
Minimum instance size: Large
Recommended instance size: Large
Administer your instance using the web interface:e.g. http://ec2-xx-xx-xx-xx.z-2.compute-1.amazonws.com/
The instance uses EBS for persistent storage. Amazon EBS I/O and storage charges apply in addition to CPU time.
Application login user name/password: admin/admin
Operator login user name/password: operator/operator
MySQL Root password: groundwork

The ami called ami-7bb17c12 has had all the relevant technical bulletins for 6.5 up to the date of release applied.

Getting Started With GroundWork Monitor 6.x and Amazon EC2 Cloud


This guide walks through getting started with GroundWork Monitor 6 in the Amazon EC2 cloud. This enables you to evaluate Groundwork Monitor 6 in a completely hosted, private copy.
If you have not already created an account on Amazon's EC2 service please do so now. Amazon will charge your account for the resources you consume on their service; GWOS does not receive any of this money.
You can sign up for a new account at:
http://aws.amazon.com/ec2/

The GroundWork Monitor 6.5 and above EC@ ami images are public AMIs. There is no need for you to be granted access. You can, of course, launch it, modify it, and bundle it into your own copy.

  • The instance has been left essentially as a clean, patched install of GWMEE 6.5. The Network Notification service is ON, and will submit anonymous usage data back to GroundWork when launched. A valid license is required for use, and will be needed on first login.
  • The GroundWork instance has not been logged into, or set up with a license, however a small amount of default logs have been generated. The database has been purged of these entries, but a few RRD files and log entries remain from the initial install. These files will not cause any operational issues.
  • As will all EC2 instances, this one should be launched with your keys, which will give you root access to the console. See Amazon documentation for key setup.

Locating the GroundWork Monitor Enterprise 6.5 AMI

  1. Go toaws.amazon.com and login to the AWS management console and select the EC2 tab
  2. Search for "GroundWork Monitor Enterprise 6.5" in the AMI section
  3. Right click on the Image and Launch an instance.
  4. Configure the instance to be created:
    In particular the following choices are recommended:


Follow the on screen instructions.Default values are fine.

Create Key Pair:

4. Press the "Launch" button

5. Click on "Instances" in the left side Navigation panel to check the instance creation process:

After a few minutes the status will change from "starting" to "running" The GroundWork application will then launch for the first time, this process takes approximately 4-5 minutes after the instance begins running.

Configuring the public access point for the GroundWork portal

The AMI instance has a private IP Address and a Public DNS. The Public DNS is used to access the GroundWork Monitor portal. The AMI instance needs to be configured with the Public DNS name. To configure the AMI instance a user needs console access to the instance which is done by using an ssh client (Linux native, Putty for Windows). Prior to connecting to the instance you need:

Public DNS configuration steps:

6. Access the GroundWork Monitor application by opening a new browser tab at the "public DNS" address of the newly created instance.

If you receive a "Service Temporarily Unavailable" message please wait 2-3 minutes for the system to complete initialization and try again.

7. Login using the default administrator credentials: Username: admin
Password: admin
Note: changing the default passwords is highly recommended (Administration -> User Management)
At this point copy and paste the license key for your GroundWork installation. Your license key was emailed shortly after your purchase.

8. Once the license key has been entered navigation to any tabs is enabled.

9. You're now ready to explore GroundWork Monitor. You will see a messages about missing the localhost device in the Views screen until the database is populated, but this is normal. This is due to the fact that the database was purged of all messages after installation. As soon as you perform a Configuration > Control > Commit, these messages will clear.

Be sure to change the password for the admin user, and to either disable or change the other default web accounts (User and Operator).
You can now proceed to configure monitoring of your cloud and web resources, or any hosts or applications reachable from your EC2 instance.
The ami we produced is set for the most popular zone, on the Eastern seaboard of the United States. We applied the timezone adjustment to PHP referred to in technical bulletin 6.3-3 Timezone for php must be set in 6.3 so that the ami will work when launched in the Eastern US availability zones, but you will need to adjust this parameter for whatever time zone you launch the AMI in. Follow the instructions in the technical bulletin if you need to launch the ami in another time zone.



Learning about GroundWork Monitor

Check out the "Getting Started with GroundWork Monitior" training course on our web site .
Need to justify a monitoring investment?  Try our whitepapers http://www.groundworkopensource.com/resources/white-papers/