GroundWork Developer's Kit Installation
From GroundWork Developer Kit
Contents |
[edit] Installing the GroundWork Developer's Kit (GDK)
NOTE: Refer to GroundWork Developer's Kit (GDK) for information on pre-requisites.
- Download the GDK package for your operating system from:
xxxx
- Type the following command to change permissions on the file to executable:
chmod +x groundworkgdk-6.0-<operating_system>.bin
- Type the following command to execute the installer:
./groundworkgdk-6.0-<operating_system>.bin
At installation, the GDK Installer automatically installs and configures the following:
- GroundWork Monitor Run Time
- GroundWork Developer's Kit (GDK)
- user nagios under:
/usr/local/groundwork/user/nagios
[edit] GDK Directory
The GDK Installer installs the GDK in:
/usr/local/groundwork/gdk
In the figure below, the GDK directory is indicated with a red dot.
[edit] Sub-Directories and Configuration Files
The GDK Installer creates the following gdk sub-directories and Eclipse configuration files (.metadata, .classpath, .project):
- /usr/local/groundwork/gdk/.metadata
- /usr/local/groundwork/gdk/foundation
- /usr/local/groundwork/gdk/foundation/.classpath
- /usr/local/groundwork/gdk/foundation/.project
- /usr/local/groundwork/gdk/jbossportal
- /usr/local/groundwork/gdk/jbossportal/.classpath
- /usr/local/groundwork/gdk/jbossportal/.project
- /usr/local/groundwork/gdk/monitor-portal
- /usr/local/groundwork/gdk/monitor-portal/.classpath
- /usr/local/groundwork/gdk/monitor-portal/.project
[edit] User nagios
The GDK Installer creates and configures the user nagios.
After running the GDK Installer, you must change the nagios password. To change the password to 'nagios', follow these commands:
- su
- Password: <<enter the superuser password>>
- passwd nagios
- New password: nagios
- Reenter New Password: nagios
[edit] User nagios Shell Configuration
The user nagios shell configuration is located in the users/nagios directory:
/usr/local/groundwork/users/nagios/.bashrc
[edit] Development Directory
The GDK Installer creates the monitor-portal/applications directory:
/usr/local/groundwork/gdk/monitor-portal/applications
The GDK Installer installs the following in the monitor-portal/applications directory:
- /usr/local/groundwork/gdk/monitor-portal/applications/console
- /usr/local/groundwork/gdk/monitor-portal/applications/dashboard
- /usr/local/groundwork/gdk/monitor-portal/applications/reportserver
- /usr/local/groundwork/gdk/monitor-portal/applications/statusviewer
- /usr/local/groundwork/gdk/monitor-portal/applications/sample-php
Use the monitor-portal/applications when developing custom portlets or other objects. For example, when developing a custom portlet in PHP, use the sample-php directory located within the gdk/monitor-portal/applications directory:
/usr/local/groundwork/gdk/monitor-portal/applications/sample-php
In the figure below, the monitor-portal directory is indicated with a red dot and the sample-php directory is indicated with a yellow dot.
[edit] Eclipse
The GDK installs Eclipse under the gdk/tools directory:
/usr/local/groundwork/gdk/tools/eclipse
Eclipse configuration and ICEfaces jar files are located in the users/nagios directory:
- /usr/local/groundwork/users/nagios/eclipse-plugin – ICEFaces jars
- /usr/local/groundwork/users/nagios/.eclipse – Eclipse configuration
In the figure below, the eclipse directory is indicated with a green dot.
[edit] Maven
The repository of all Maven jar files is found under the nagios home directory:
/usr/local/groundwork/users/nagios/.maven/repository
