ESGF Upgrade

Upgrade Procedure

Unix User

You must be root or effectively root to run this program, prefixing the command with sudo will not allow the use of needed environment variables! If you must use sudo, do so only to become root proper then source your user's .[bash]rc file so that root has it's envronment set accordingly! Or you can more simply become root using sudo's "-s" flag.

Stop the Node

cd /usr/local/bin
esg-node stop

Download and Execute the Bootstrap Script

To upgrade a 'devel' install

cd /usr/local/bin
wget -O esg-bootstrap http://distrib-coffee.ipsl.jussieu.fr/pub/esgf/dist/devel/esgf-installer/2.3/esg-bootstrap --no-check-certificate  
chmod 555 esg-bootstrap  
./esg-bootstrap --devel   

To upgrade a 'master' install

wget -O esg-bootstrap http://distrib-coffee.ipsl.jussieu.fr/pub/esgf/dist/esgf-installer/2.3/esg-bootstrap --no-check-certificate  
chmod 555 esg-bootstrap  
./esg-bootstrap    

Check Installer Script Version

esg-node --version
Version: v2.3.8-master-release
Release: Centaur
Earth Systems Grid Federation (http://esgf.llnl.gov)
ESGF Node Installation Script

Start the installation process

esg-node --update

Use script instead of tee to log the installation. tee can cause configuration files corruption. Make sure you specify the type without square bracket or pipe.

Primary Configuration

Please select the ESGF distribution mirror for this installation (fastest to slowest): 
-------------------------------------------
 [1] http://dist.ceda.ac.uk/esgf 
 [2] http://esg-dn2.nsc.liu.se/esgf 
 [3] http://distrib-coffee.ipsl.jussieu.fr/pub/esgf 
 [4] http://aims1.llnl.gov/esgf 
-------------------------------------------

Are you ready to begin the installation? [Y/n] Y

Post-upgrade

• Recommended to run esg-node --install-local-certs if you have your signed certs in place for gridftp/myproxy as the certificates might be replaced by temporary ones, as frequently observed to happen after upgrades. (TODO when this is fixed in the installer, we can remove this manual step)

• It has been observed that on node upgrades (both data-only and full installations now) that several .xml files in /esg/config are overwritten. Suggested to check that these files contain the correct properties vs those in the [https://github.com/ESGF/config] repo. For instance, esgf_shards_static.xml may be an old version with all the old nodes listed but commented out by region (and default behavior is a local search only).

• An (additional) localhost shard may have be written to esgf_shards_static.xml. This will result in datasets listed twice in the facet counts.

For upgrades to 2.2.3, following steps are required.

esg-node --update-apache-conf
touch /etc/httpd/conf/esgf-httpd-local.conf /etc/httpd/conf/esgf-httpd-locals.conf
esg-node restart