Upgrade

This document describes how to upgrade the Sawmill software package for versions 8.5+. The current licenses apply to all 8.x.x.x versions.

• Download Software
• Software Upgrade

Download Software

See Download Software section of Installation for instructions on downloading the software.

Software Upgrade

This section describes the procedure for upgrading a previously installed version of Sawmill to a newer version.

Note: The following procedure needs to be completed for pdsrpt1 only. The instructions will explicitly denote instructions for upgrading pdsrpt2.

1. Log onto the pdsrpt1.
2. Change to the pds user:

   % sudo su pds
   	    

3. Place the downloaded Sawmill tar in the /home/pds directory
4. Navigate to /home/pds and enter the following command from the command line:

   % gunzip -c (sawmill.tar.gz) | tar xf -
               

   A directory called sawmill is created containing the software and configuration.

5. Move the directory to a more version-specific location so it is maintained:

   % mv sawmill sawmill8.6.3.1
   	    

6. Kill all running sawmill processes.

   % killall sawmill
   	    

7. Recreate a new symbolic link to the current installation:

   % rm /usr/local/report/sawmill
   % ln -s /home/pds/sawmill8.6.3.1 /usr/local/report/sawmill
               

8. Run upgrade-sawmill to remove the Sawmill default configurations and copy the PDS Engineering-specific configurations from the old installation.

   % # Usage: upgrade-sawmill <new-LogAnalysisInfo>
   % #  - <new-LogAnalysisInfo> - the LogAnalysisInfo directory within the new installation
   %
   % ./upgrade-sawmill /usr/local/report/sawmill/LogAnalysisInfo
   	    

   Note: This assumes /report_service/LogAnalysisInfo is home to load balanced LogAnalysisInfo config. Update the script if needed.

9. To run Sawmill, execute the following commands:

   % cd /usr/local/report/sawmill
   % nohup ./sawmill -ws t -v e > /usr/local/report/sawmill_logs/<current_date_in_YYYYMMDD_formate>.log 2>&1&
               

   Note: Be sure to modify this command, as needed for the shell being used, to ensure Sawmill runs as a daemon process and output is redirected into .

10. Log onto pdsrpt2
11. Complete steps 1-6 from above on pdsrpt2

12. Perform the following in the bash shell:

    % rm -fr /usr/local/report/sawmill/LogAnalysisInfo
    % ln -s /usr/local/report/LogAnalysisInfo /usr/local/report/sawmill/LogAnalysisInfo
    	    

    Note: Modify directories as needed to reflect actual installation directories.

13. Complete step 8 from above on pdsrpt2.
14. Open a web browser and go to http://pdsrpt.jpl.nasa.gov/ to open Sawmill.
15. Verify you can login using your PDS username and password.
16. Verify profiles appear as expected.