DEPRECATED - REMOVE IT SmartGears gHN Installation
Contents
Introduction
As very well described in the dedicated gCube developer guide section, SmartGears is a set of Java libraries that turn Servlet-based containers and applications into gCube resources in a transparent way.
In order to achieve the goal of Software-as-resource and Container-as-resource infrastructure administrators and site-managers have been equipped with a bundle for the installation and management of the software needed to :
- enable any servlet-based container as a resource on the infrastructure
- enable any application running on the container as a resource on the infrastructure.
Prerequisites
The following are prerequisite for the installation of a SmartGears gHN:
-
J2SE 1.6 update 4 SDK
or greater. Sun's reference implementation is recommended, but versions from IBM, HP, or BEA should work equally well.
-
GNU tar
to install gCore from archived distributions.
- An existing installation of one of the available Servlet Containers
The following are pre-requisites for the operation of gHN in any infrastructure:
- A static IP address and preferably a DNS name.
Installation
The SmartGears gHN is available as archived distribution from the gCube Nexus Maven repository. ( link). Once downloaded the distribution can be expanded in any location of the filesystem. The distribution contains all the relevant files and in particular the install script, which performs the real installation of SmartGears within the servlet container:
usage: install [-d <distro directory>] -s tomcat|<lib directory> -a [app directory] [-g gHN directory] [-x|-h] <distro directory> = the directory with the distribution of SmartGears XXX. By default, this is the parent directory of this script. <lib directory> = the directory with libraries shared by all applications in the target container. <app directory> = the directory with all the applications in the target container. <gHN directory> = the directory with logs and files related to the gCube Hosting Node. By default, this is value of the GHN_HOME env var. tomcat = Sets <lib directory> and <app directory> for a target Tomcat container. x = dry run. h = shows this help.
The structure of the installation is the following: