You are here: 2.0 Installation and Initial Configuration > Upgrading Moab

2.3 Upgrading Moab

Depending on which version of Moab you are presently running, upgrade instructions may vary. If you are presently running 5.4, you must upgrade first to 6.0 and then to 6.1 if you want to run 6.1. Perform the steps that follow for upgrading to 6.0 first; then repeat the steps for upgrading to 6.1. If you are presently running 6.0 and want to upgrade to 6.1, just perform the steps that follow.

Upgrading Moab may require changing the database. Please see the README.database file included in the Moab distribution for specific version information. Also, please see Migrating Your Database to Newer Versions of Moab for specific details on migrating your database from 5.4 to 6.0 and from 6.0 to 6.1.

You can test the newest version of Moab on your system (before making the new version live) to verify your policies, scripts, and queues work the way you want them to.

Note The Moab 5.4 uninstaller does not remove the 5.4 man pages. These must be removed manually when upgrading from Moab 5.4. You can use this script to remove the man pages:

------Start of script------
#!/bin/bash

LIST="checkjob.1 mdiag.1 mdiag-n.1 mjobctl.1 mrmctl.1 mshow.1 releaseres.1 schedctl.1 showconfig.1 showstart.1 checknode.1 mdiag-f.1 mdiag-p.1 mjstat.1 mrsvctl.1 mshowa.1 resetstats.1 setres.1 showq.1 showstate.1 mcredctl.1 mdiag-j.1 mdiag-S.1 mnodectl.1 mschedctl.1 msub.1 runjob.1 showbf.1 showres.1 showstats.1"

MAN_DIR=/usr/local/share/man

for file in $LIST
do
rm -f $MAN_DIR/man1/$file
done
------End of script------

To upgrade Moab

  1. Untar the distribution file. 
    > tar -xzvf moab-6.1.0.tar.gz
  2. Navigate to the unpacked directory. 
    > cd moab-6.1.0
  3. Configure the installation package.

    Use the same configure options as when Moab was installed previously. If you cannot remember which options were used previously, check the config.log file in the directory where the previous version of Moab was installed from.

    For a complete list of configure options, use ./configure --help.

  4. Stop Moab.

    The Moab server must be stopped before the new version is installed.

     > mschedctl -k
moab will be shutdown immediately
    NoteWhile Moab is down:
    • All currently running jobs continue to run on the nodes.
    • The job queue remains intact.
    • New jobs cannot be submitted to Moab.
  5. Install Moab. 
    > sudo make install
    NoteMoab should be installed by root. If you cannot install Moab as root, please contact Customer Support.
  6. Verify the version number is correct before starting the new server version. 
     > moab --about
 
Defaults:   server=:42559  cfgdir=/opt/moab  vardir=/opt/moab
Build dir:  /home/admin01/dev/moab/
Build host: node01
Build date: Tue May 17 16:38:27 MST 2011
Build args: NA
Compiled as little endian.
Version: moab server 6.1.0 (revision 992)
Copyright 2011 Adaptive Computing Enterprises, Inc., All Rights Reserved
  7. Start Moab. 
    > moab
    Notemoabd is a safe and recommended method of starting Moab if things are not installed in their default locations.

2.3.1 Upgrading the Moab Database

The Moab database schema might change from release to release. Please see Migrating Your Database to Newer Versions of Moab for more information.

Copyright © 2012 Adaptive Computing Enterprises, Inc.®