Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

At the home area of the csgrid user, create a directory for the intallation, for example, csgrid. Inside this directory, the installation procedure will expand the required directories and files.

Copy the installation file, provided by the development team or obtained from the Download page, to this directory.

If this installation is being performed over an existing installation (e.g. a previous version), and you want to keep the files used in the current installation, backup the install directory.

Uncompress using the following command:

Code Block
tar -xzf csgridInstall.tgz

assuming the csgridInstall.tgz is the CSGrid distribution file.

By decompressing, the install directory will be created, containing:

  • The executable, with the .bin extension, e.g. CG-v1_05_05-2011_06_15.bin
  • The validation properties file, Validations.properties
  • The sgad-cnf.lua file, which serves as base for the configuration of the SGAs
  • The Readme file with basic installation instructions

Anchor
src-dir
src-dir
Creating src & config directories

Inside the installation directory (see Summary of CSGrid Server Requirements), create the src and config directories. Assuming the installation directory is csgrid, the directories csgrid/src and csgrid/config will be used during the system installation.

In an existing installation, everything inside the <installation dir>/src will be removed during the new installation, with exception of the specific directories algorithms and project.

Executing the installer

The installer will execute a script that will perform the extraction of the necessary fiiles and will ajust some system properties. Attention: all files contained in the csgrid/src directory will be removed by the installer.

Using the csgrid user, execute the following command inside the created src directory:

Code Block
../install/CG-v1_05_05-2011_06_15.bin -p ../install/Validations.properties

where CG-v1_05_05-2011_06_15.bin is the name of the provided binary file, according to the CSGrid current version.

The installation process requests for some configuration options. To use the suggested options, press <ENTER>. To change the configuration option, fill the option and press <ENTER>. At the end on the installation, the scripts indicates which configuration files were changed and can be verified and, if necessary, edited before the system is executed. A summary of the installation is stored in the src/init/deployment.log file, inside the installation directory (see Summary of CSGrid Server Requirements).

The following configuration options are requested:

Code Block
Initilize the CSGRid Server ? [true] 

The initialization script will initialize the CSGrid server.

Code Block
Initialize SGA? [true] 

The initialization script will initialize the execution of an SGA on the same machine of the CSGrid Server.

Code Block
Initialize CSFS? [false]

This option shall only be changed to true if any machine running an SGA doesn't have NFS access to the data and algorithms repositories of the CSGrid server. In this case, the initialization script will initialize the execution of the CSFS server for the tranfer of files between servers.

Code Block
Type [1] to create a new properties file or any other key to use an existing file:

In case the installation is being performed for the first time, press 1. In this case, a properties file will be created and used by the CSGrid Server initialization script. If there is an existing properties file created by a previous installation, press <ENTER>.

Anchor
system.properties
system.properties

Code Block
Path to the properties file (Use an absolute path or relative to the installation directory): [../config/System.properties] 

Press <ENTER> in case de properties file (created by the installation process or by a previous installation) has the name System.properties and is inside the config directory.

Code Block
System alias: [CSGrid] 

Tha name by which the CSGrid server is recognized by the administration and configuration options. This information is only requested when the properties file is being created.

Code Block
Name of the server for the connection with the client: [serverMachine] 

The name of the machine where the CSGrid server will be executed.

Code Block
Server IP for the connection with the client: [10.0.8.169]

The IP address used to establish the connection with the CSGrid client. In the case of machines with a single network interface, press <ENTER> to use the default option which is the machine's IP address. In the case of machines with multiple network interfaces, the external IP through which the CSGrid server will communicate with the machines that will execute the CSGrid Web Client.

Code Block
Server IP for the connection with SGAs: [10.0.8.169]

The IP address used to establish the connection with algorithms execution servers (SGAs). In the case of machines with a single network interface, press <ENTER> to use the default option wich is the machine's IP address. In the case of multiple network interfaces, the IP through which the machine will communicate with SGA must be filled.

Code Block
SGA logs directory (Use only the path relative to the installation directory):  [../logs/sga] 

Press <ENTER> to use the default path where the SGA will write its logs or type the path to the directory you want to use for the SGA log files.

Code Block
Directory of SGA configuration file (sgad-cnf.lua) (Use only the path relative to the installation directory): [../config]

Press <ENTER> to use the default directory path for the configuration file to be used by the SGA or type the path you want to use.

The following informations are only requested when the properties file is being created. Any of these properties or other used by CSGrid can be manually changed editing the system.properties file directly.

Code Block
Server IP for the connection with Openbus: [10.0.8.169]

The IP address used to establish the connection with the Openbus middleware server. In the case of machines with a single network interface, press <ENTER> to use the default option wich is the machine's IP address. In the case of multiple network interfaces, the IP through which the machine will communicate with OpenBus must be filled.

Code Block
OpenBus server IP: [10.0.8.169]

IP address of the machine where Openbus is running. Press <ENTER> in case the bus is running on the same machine where the CSGrid Server is running.

Code Block
Openbus server port: [3000]

The port used by Openbus. Type the number of the port according to what has been configured on the bus installation.

Code Block
SMTP server:

Type the complete name of the SMTP server used for sending emails by the CSGrid. This configuration is important for the sending of emails about the occurrence of errors or about the termination of executions of submitted commands. Without a SMTP server, the CSGrid server won't send emails about errors or execution terminations of submitted commands.

Code Block
Type [1] to install CSGrid on the apache directory or any other key to proceed:

In case the apache server is installed on the same machine as the CSGrid server and is used to make the Web Client available, press 1. In case the CSGrid web client is being made available through Tomcat, which is already provided in the installation, press<ENTER>.

Code Block
URL for accessing CSGrid [http://csgrid.tecgraf.puc-rio.br:80/csgrid] 

Type the URL that the client will use on the browser for acessing the CSGrid desktop.

Code Block
Apache directory: [/var/apache/htdocs/csgrid] 

Type the path to the apache directory where the installer will provide the CSGrid web client files (see Summary of CSGrid Server Requirements).

Executing the SGA installer

Note: This step is only necessry when the SGA module needs to be installed separatedly from CSGrid. In general, this case occurs when the SGA will be executed in a different machine to where the CSGrid Server is installed and this machine doesn't have access (e.g. NFS) to the CSGrid installation files.

From version 1.5.5 of the CSGrid server it is possible to install only the sgad module, instead of installing the whole CSGrid system.

Using the csgrid user, execute the following commands inside the src directory created on the step Creating src & config directories:

Code Block
../install/CG-v1_05_05-2011_06_15.bin -e "./sgad"

where CG-v1_05_05-2011_06_15.bin is the name of the provided binary, according to the CSGrid version.

The command above will install the sgad module on the src/sgad directory.