ServerSetup

Warning: this page is still under construction.

Service Grid Setup

The Easy Way (One Step Installer)

There is a one-step-install.sh script that can install all required packages and programs for a full ServiceGrid installation. The script assumes a fresh Ubuntu (Debian) installation with no required programs installed.

 % wget http://www.anc.org/downloads/langrid/one-step-install.sh
 % chmod u+x one-step-install.sh
 % sudo ./one-step-install.sh

Accept all prompts that follow.

Part way through the installation process the script will open a configuration file in emacs. Make any required changes. The configuration file is commented so it should be obvious what needs to be changed. If you would like to use a different editor other than emacs set the EDITOR environment variable before running the install script.

 % wget http://www.anc.org/downloads/langrid/one-step-install.sh
 % chmod u+x one-step-install.sh
 % export EDITOR=vi
 % sudo ./one-step-install.sh

The Hard Way

Download all files required for Service Grid installation and unzip the archive.

Prerequisites

1. Java 1.7 or later. Using the Oracle JDK is strongly advised.
2. PostgreSQL 9.1

Installing Java

   % sudo apt-get purge openjdk*
   % sudo apt-get install python-software-properties
   % sudo add-apt-repository ppa:webupd8team/java
   % sudo apt-get update
   % sudo apt-get install oracle-java7-installer

The above commands perform the following tasks:

1. Remove the openjdk if it exists.
2. Installs the package with the `add-apt-repository` command.
3. Adds the webup8team repository (contains the Oracle Java 7 installer)
4. Updates the repository information.
5. Installs Java 7

Install PostgreSQL

   % sudo apt-get install postgresql-9.1

Setup script

Installing Java and Postrgres can also be accomplished with the setup.sh script found in the LappsPackages archive.

   % sudo ./setup.sh java postgres

Tomcat and the Service Grid

Tomcat installation and Service Grid setup is performed by the install.sh script. Typical usage looks like:

 % sudo ./install.sh -a -u tomcat /usr/share

Option	Description
-a	Install everything
-u	Specifies the user that Tomcat will be run as.
	The last argument is the directory where Tomcat will be installed. In the above example the Tomcat instances will be installed to /usr/share/tomcat/service-manager and /usr/share/tomcat/active-bpel.

Run the install.sh script with the -h option to display additional help.

The install.sh script performs the following tasks:

1. Installs two instances of Tomcat; one for the service manager and another for ActiveBPEL.
   1. Generates the tomcat-user.xml files for both Tomcat installations.
   2. Tightens read/write permissions on the Tomcat directories.
   3. Creates a tomcat user for running Tomcat.
   4. Ensures files and directories are owned by the tomcat user.
   5. Removes the Tomcat manager applications, docs, and examples.
2. Installs PostrgreSQL 9.1
   1. Create a new database role.
   2. Creates the database for the !ServiceGrid
   3. Creates the stored procedure.

Condensed Installation Instructions

  # This assumes a fresh install of Ubuntu/Debian
  % wget http://www.anc.org/downloads/langrid/LappsPackages-1.1.0.zip
  % sudo apt-get install unzip
  % unzip LappsPackages-1.1.0.zip
  % cd LappsPackages-1.1.0
  % sudo ./bin/setup.sh java postgres emacs
  % emacs ServiceManager.config  # or install/use your favorite editor
  % sudo ./bin/install.sh -a -u tomcat /usr/share

To Do

Divide the Tomcat installations into the core Tomcat components ($CATALINA_HOME) and the two instance directories ($CATALINA_BASE).