GridScope 2.0 Installation Guide
This document is an installation guide for the GridScope
Service Manager. Its purpose is to guide users through the process
of installing the GridScope Service Manager and its supporting components. This
process installs all the components of the GridScope Service Manager including the
Repository, Gateway, and Console.
The GridScope Service Manager is supported by several open-source standards and applications, which are freely available over the Web. The supporting applications should be installed first. If you already have one or more of these applications installed, you can skip the associated installation step. You do not need to reinstall them for this process.
When installing the supporting applications (or working with existing installations), GridScope does not place any restrictions on the directory locations. However, you will need to know the full path to their home directories to properly configure GridScope after installing it.
The sequence of installation below is highly recommended but not required.
GridScope is a 100% Java/J2EE-based implementation. It is compatible with all operating systems that support Java/J2EE.
A Java SDK is required to run GridScope. If not already installed, download the J2SE 5.0 / JDK 5.0 - also referred to as JDK 1.5 (this is the preferred and fully tested version for GridScope) from http://java.sun.com/j2se/1.5.0/download.jsp. Install the SDK through the standard Java installation process (usually a self-installing executable). Be sure to note the location of the Java home directory. This value will be needed to properly configure the GridScope installation.
A web server is required to run GridScope. We recommend you install the Apache Jakarta Tomcat Web Server. Download Tomcat Server 5.5.x from http://jakarta.apache.org/site/downloads/downloads_tomcat-5.cgi. Install the Tomcat Server through the standard Server installation process (usually a self-installing executable). Please refer to http://jakarta.apache.org/tomcat/tomcat-5.0-doc/index.html for details on installing and configuring the Tomcat Server. During the installation process, make sure to point the Java Virtual Machine location (JVM) to the Java Runtime Environment (JRE) folder of the JDK 1.5 version installed in the previous step. Be sure to note the location of the Tomcat Server home directory. This value will be needed to properly configure the GridScope installation.
A database is required to run GridScope. We recommend you
install MySQL. If not already installed, download MySQL 4.x from http://dev.mysql.com/downloads/mysql/4.1.html.
Follow the instructions at that same location to complete the installation. Be
sure to note the location of the MySQL home directory. This value will be
needed to properly configure the GridScope installation.
Once the preliminary installations are complete, you can begin the process of installing the GridScope SOA Framework. The steps below assume that Tomcat Server 5.5.x and MySQL have been installed in support of GridScope.
1. If you have not already downloaded your copy of the GridScope Service Manager, the entire binary distribution for GridScope 2.0 may be found at http://www.gridscope.com/r2b/gridscope.zip. If you have already downloaded gridscope.zip from another source (e.g. download.com, an affiliate site, or from a software CD), please skip this step.
2. From the gridscope.zip file, extract the gridscope directory anywhere on your system. Examples include:
a. Windows: C:\
b. Linux/Unix: /usr/local
NOTE: In the following sections, the term <GRIDSCOPE_HOME> is used to denote the root directory for GridScope examples: C:\gridscope (Windows) or /usr/local/gridscope (Linux/Unix).
3. Once you have extracted the gridscope directory, confirm that the <GRIDSCOPE_HOME> directory has the following structure/subfolders.
a. axis
b. bin
c. config
d. service_manager
e. gridscope_samples
f. lib
g. sql
4. Go to <GRIDSCOPE_HOME>/bin
5. Open the environment variables file - setGridScopeEnv.bat (Windows) or setGridScopeEnv.sh (Unix/Linux)in edit mode.
6.
Set the environment variables as shown below. Ensure
that the full and correct path is specified in each case; otherwise GridScope
may not function properly.
b. Set JAVA_HOME = full path to the installed Java SDK
c. Set CATALINA_HOME = full path to the Tomcat Server home directory
d. Set MYSQL_HOME = full path to the installed MySQL home directory
e. Set all the other database-related parameters as appropriate
7. To complete installation, run the installation script located in the <GRIDSCOPE_HOME>/bin directory:
a. Windows: installGridScope.bat
b.
Unix/Linux: ./installGridScope.sh
To start the GridScope Server run the following script from the <GRIDSCOPE_HOME>/bin directory:
1. Windows: startGridScope.bat
2.
Unix/Linux: ./startGridScope.sh
After installation is complete, verify that GridScope is functioning as required by completing the steps below:
1. Launch your web browser and point to http://gridscop.startlogicmysql.com:8080/service_manager/index.do. This will open the GridScope Console to the login page. Login as admin/admin (which is the default user/password values for the administrator). Verify that the sample services provided out-of-the-box are present. Click through the application and verify the functionality of the various sections services, registries, activities, exceptions, alerts, and admin.
2. Next, browse the services by clicking on the 'services' tab. Click on the 'Call' link for any of the services. Verify that it takes you to a page that displays a successful sample service request and that you are able to call the service successfully.
CONGRATULATIONS! You have now successfully installed and tested the GridScope Repository, Gateway, and Console.
Please refer to the GridScope User Guide at http://www.gridscope.com/doc/product/r2/guides/GridScopeUserGuide.html for more information and suggestions for using GridScope to manage your service-oriented business applications.