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:
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.
- The validation properties file,
sgad-cnf.luafile, which serves as base for the configuration of the SGAs
Readmefile with basic installation instructions
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/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
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:
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:
The initialization script will initialize the CSGrid server.
The initialization script will initialize the execution of an SGA on the same machine of the CSGrid Server.
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.
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>.
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.
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.
The name of the machine where the CSGrid server will be executed.
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.
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.
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.
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.
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.
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.
The port used by Openbus. Type the number of the port according to what has been configured on the bus installation.
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.
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>.
Type the URL that the client will use on the browser for acessing the CSGrid desktop.
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:
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