ESGF Upgrade

Upgrade Procedure

Instructions specific to upgrading to version 2.4.24 Master release is available here: https://github.com/ESGF/esgf-installer/files/730182/ESGF-upgrading-to-2.4-stable.pdf Please read that carefully and also refer to instructions here.

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 environment set accordingly! Or you can more simply become root using sudo's "-s" flag.

Stop the Node

cd /usr/local/bin
esg-node stop

Clean the webapps directory

Some time, after upgrading ESGF, tomcat fails to initialize the servlet context (e.g. thredds is not available). Wipe out the webapps content before upgrading, is a good practice.

rm -fr /usr/local/tomcat/webapps/*

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.5/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.5/esg-bootstrap --no-check-certificate  
chmod 555 esg-bootstrap  
./esg-bootstrap    

Check Installer Script Version

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

Start the installation process

script -c 'esg-node --upgrade' upgrade.log

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

Release 2.5.x specific questions

If you plan to publish CMIP6 data make sure you answer Y to the question regarding that (not a default).

Most sites should automatically "peer with supernode" (this is Node Manager module specific). Exceptions are the several Tier 1 sites yet to install their supernode (answer N) which should run n the index node at LLNL, JPL, CEDA, DKRZ, and IPSL.

Tier 1 IDP only - We encourage all sites to deploy the SLCS service so please answer 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 (they last only 1 month and some services will be unavailable without clear message), as frequently observed to happen after upgrades. (TODO when this is fixed in the installer, we can remove this manual step)

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