-
Notifications
You must be signed in to change notification settings - Fork 22
ESGFNode|InstallationProcedure
This page contains information extending that documentation.
The installation script is written in BASH and is targeted to run on *NIX operating systems. In particular the target platform is RH or CentOS, because of minor command idiosyncrasies, however, the script has been used successfully executed on other *NIX systems. The install script pulls down installation artifacts from our distribution server. All artifacts and even the scripts themselves are verified against posted checksums. If verification fails the script will abort. There is a single master script, however, there is actually a series of scripts that are used to install the ESGF Node stack. The script is able to run at start up via chkconfig, supporting [start|stop|restart|update] directives. The script is also self- updating and will alert you if it has been tampered with. There are many flags that may be used with the script (see usage by using --help|-h options), as it is the central mechanism for controlling the maintenance life cycle of the data node.
The script is the preferred way to install the ESGF Node stack. It is recommended to create an "esg-user" account that is able to issue the command "sudo -s" to become root.
Execute the installer with the command:
%> esg-node --type data --install --verify
(this will install a "data" configuration of the esgf node)
.
This will perform all installation and verification steps in sequence, prompting the user each time during an initial install. Order of installation is important! If the script aborts at any point do not continue until the issue at hand has been resolved. The general sequence is as follows:
esg_root_dir = /esg
workdir = /usr/local/src/esgf
Location
Description
${esg_root_dir}
Top level directory location of the ESG configuration files and logs (default /esg).
${esg_root_dir}/backups
Application stack and database data archive location
${esg_root_dir}/config
ESGF configuration files
${esg_root_dir}/content
Thredds catalogs & LAS data files
${esg_root_dir}/data
Top level directory for data (.nc) files
${esg_root_dir}/data.replica
Top level directory for all replicated data from other nodes
${esg_root_dir}/data-index-*
Search index directories
${esg_root_dir}/gridftp_root
Chroot directory for gridftp access to data
${esg_root_dir}/log
ESGF log files
${esg_root_dir}/tools
ESGF tools (currently; esg_usage_parser)
${esg_root_dir}/config/esgcet/esg.ini or ~/.esgcet/esg.ini
esg publisher setup file. (system vs personal install)
%{esg_root_dir}/etc
Ancillary scripts and files
${esg_root_dir}/esgf-install-manifest
Log of all installed components of the application stack (date, name, location, version)
/etc/esg.env
Environment variables required by the script and used in node operation
${workdir}
Installation "scratch" directory for installation-time artifacts; source, helper scripts, et. al.
${workdir}/globus
globus sources
${workdir}/esg
publisher,thredds and other sources
The esg-node installation script is also the boot script
To stop/start or restart or check the status of the node...
%> esg-node stop
%> esg-node start
%> esg-node status
%> esg-node restart