Skip to end of metadata
Go to start of metadata

Note: These instructions applies to previous versions of CSGrid 2.0. For CSGrid 2.0, see Installation Guide.

With the system user created and the environment configured, the next step is the actual installation of the system, which is performed from a distribution file. This file is aways generated by the development team and built from the final test installation, after all tests have been performed.

Uncompressing the installation file

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:

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

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:

../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:

Initilize the CSGRid Server ? [true] 

The initialization script will initialize the CSGrid server.

Initialize SGA? [true] 

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

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.

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>.

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.

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.

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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>.

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.

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:

../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.

 

  • No labels