5. Update Applications

If there is an OOD update it is almost guaranteed that there will be web application updates. So it is recommended to always perform these steps when updating your OOD installation. The apps installation is handled by a script that is maintained by the ood-apps-installer project.

The following steps assume you previously installed the apps following the Install Applications procedures.

5.1. Do I need to update?

Most likely, yes.

5.2. Instructions to update

  1. Make backups of your locally installed copies of the apps. This is a highly recommended since app configuration is located underneath the installation directory of each app (may change in the future). So if something goes wrong, we don’t want to lose your custom setup.

    cp -r /var/www/ood/apps/sys /path/to/backup/location
    

    This step may take awhile but it is worth it.

    Tip

    If this is a development or test instance of OOD and you already version your custom configuration files for the various apps then you can probably skip this step.

    Warning

    The various OOD apps can support custom configuration files at:

    • .env.local (Dashboard, ActiveJobs, MyJobs)
    • config/initializers/ood.rb (Dashboard)
    • config/initializers/filter.rb (ActiveJobs)
    • templates/ (MyJobs)
    • .env (Shell)
    • local/ (Desktops)

    If these exist for your installation please version these at your center and back them up.

  2. Fetch the latest changes and check out the latest tag:

    cd ~/ood/src/apps
    scl enable git19 -- git fetch
    scl enable git19 -- git checkout v1.0.0
    
  3. Confirm that the local configuration files for the various apps exist under the appropriate app build directory as build/app_dir/....

  4. Rebuild the apps (may take ~15 min):

    scl enable rh-ruby22 nodejs010 git19 -- rake
    
  5. Finally, we install the apps to their system location at /var/www/ood/apps/sys with:

    sudo scl enable rh-ruby22 -- rake install