SOP MultiMon Annual Reset

From PTAGISWiki

	Standard Operating Procedure
Subject:	SOP - MultiMon Annual Reset
Author:	Dave Marvin
Approved by:	Dave Marvin

Contents 1 Objectives 2 Scope 3 Responsibilities 4 Procedure 5 References

Objectives

This document describes how to reset the MultiMon computer platforms at the PTAGIS Separation-by-Code (SxC) sites annually prior to the beginning of each migration season. The objectives of this procedure are to:

1. Clear the persistent counter files from the previous year's SxC configuration that could impact Action Code quotas in the current year's configuruation;
2. Delete extraneous MultiMon diagnostics files, accumulated over the previous year, that might be deleterious to the performance of MultiMon;
3. Ensure that the MultiMon application, and its support applications, are correctly installed and configured to operate in a "lights out" environment; and
4. Ensure that the MultiMon application, and its support applications, can be easily and quickly accessed remotely, via pcAnywhere.

Scope

This procedure applies specifically to production PTAGIS data collection platforms running the MultiMon application.

Responsibilities

This procedure is to be performed by PTAGIS staff.

Procedure

Note: This procedure should be performed as early as possible each year, prior to activation of the bypass facility and certainly prior to the initiation of any SxC activities. Since the GRA and BO3 adult traps may remain in operation during December and January, and since the full-flow bypass pipes at the juvenile fish bypass sites may now also operate through the winter, it is increasingly likely that the reset activities described here will occur while the site is watered-up and the MultiMon application is actively collecting data. The following instructions assume that the site is active, and must be followed precisely to ensure that the collection data are reported to the PTAGIS database without interruption, and in the correct sequence. To keep things simple, do not initiate this process within an hour of a scheduled file change.

1. Prior to any work on the production machines (PC1 and PC2), first set the current time on the utility machine, using either the About Time application or by navigating to the official U.S. atomic clock at http://nist.time.gov/timezone.cgi?Pacific/d/-8/java. The time on the utility machine does not necessarily need to be set to Pacific Standard Time (PST), but PST is required when setting the time on PC1 and PC2 (see below).
   
   
2. Perform steps 3-26, starting on PC2.
   
   
3. From a full DOS screen in MultiMon, stop data collection ([F10]) and exit (X) the application.
4. Move all previous days' data files from the /multimon/pc2data directory to /multimon/archive. Copy all of today's files from /multimon/pc2data to /multimon/archive; this ensures that existing files will not be overwritten with new and different data when the application is reset. Write down the name of the most recent data file.
5. Create a new directory for the previous year under "Previous Years' Data" and move all of the previous year's data files from the /multimon/archive directory into this new directory.
6. Move the previous year's last seasonal (cumulative) counter file ({SSS}{YY}365.SEA) from the /multimon/counters directory to /multimon/counters/Archive. Delete all remaining counter files for the previous year from the /multimon/counters directory.
7. Delete all files from the /multimon/log directory with dates prior to the beginning of the current year.
8. Delete all report files from the /multimon/report directory.
9. Clean up the /multimon/system directory.
   1. Delete all of the persisted daily configuration files (*.001 - *.031).
   2. Delete any SxC configuration files (*.map, *.db, and *.zip) with Julian dates in the file titles ({SSS}{YY}{DDD}.map|db|zip). Do NOT delete the generic configuration files (including hardware files with the title {SSS}-0600.HWx).
   3. Delete the default.cfg file. This step is critical to clearing all persistent data, including counter quotas, from the MultiMon environment.
10. Compare the Properties for the MultiMon shortcut in the Startup Group with the expected values listed in Multimon_PIF_Properties_and_Window_positions.pdf. Make any corrections as necessary.
11. Start MultiMon from the shortcut on the PC2 desktop. Verify that it opens minimized to the taskbar, and that it transitions to a full window DOS box when maximized. Verify that the MultiMon application automatically starts up in data collection mode.
12. Stop data collection.
13. From the main MultiMon menu, sequentially access the Hardware, Map, and Database sub-menus, and assign the generic configuration files. Explicitly save each configuration file reference. If there is a {SSS}-0600.HWx file available, preferentially select this instead of the {SSS}-GEN.HWx file. (The only difference between these two hardware files should be the counter reset time!)
14. Verify that the applications appear as expected on the PC2 desktop. Use the screenshot in Multimon_PIF_Properties_and_Window_positions.pdf as a reference.
    1. Switch MultiMon from a full DOS box to a partial window ([Alt]-[Enter]). Verify it is a partial rather than a full window, that it occupies the upper right corner of the desktop, and that it extends to, but does not occlude, the first column of application shortcuts on the desktop.
    2. Open (or restore) the Windows Commander (or Total Commander) application. Verify that the left pane is set to the /multimon/pc2data directory (sorted in descending order by date) and that the right pane is set to the /multimon/system directory (sorted in ascending order by filename). Verify that, in a partial window, the application window is located slightly below the MultiMon application window. Save this location, if necessary, and then close Windows Commander.
15. Maximize MultiMon to a full screen DOS box, and then exit from the application.
16. Reset the time on the PC to match the current (PST) time on the utility machine.
17. Reboot the PC through the Windows Start menu, verifying that the "Shut Down Windows" option is set to "Restart".
18. When PC2 restarts, bring MultiMon up in its full screen DOS box and verify that the current data file has been incremented by (1) from the last file reported in step #4 above.
19. Switch MultiMon to a window, and verify that it is anchored in the upper right corner of the screen.
20. Open Windows Commander, navigate to the /multimon/pc1data directory in the left pane, delete the default *.00x file created in that directory, and then navigate back to /multimon/pc2data. Close Windows Commander.
21. Open PTTP Uploader, click the "Manual" button, verify that the "Archive Only" option is selected by default, and then transfer all outstanding data files to the archive. Close the manual upload window and exit PTTP Uploader.
22. Switch MultiMon back into a full screen DOS box.
    
    
23. Switch data collection from PC1 to PC2.
    1. Write down the name of the current data file on PC1.
    2. Open a new data file on PC2 ([Alt]-[F10]) and simultaneously stop data collection ([F10]) on PC1. Verify that PC2 assumes gate control from PC1.
    3. Write down the name of the current data file on PC2.
    4. Exit from MultiMon on PC1.
       
       
24. Switch to PTTP Uploader and close the application.
25. Copy all of today's files from the /multimon/archive directory back to /multimon/pc1data.
26. Repeat steps #5 - 17 on PC1.
27. When PC1 restarts, bring MultiMon up in its full screen DOS box and verify that the current data file has been incremented by (1) from the last file reported in step #23.1 above. Verify that PC2 relinquishes gate control back to PC1.
    
    
28. Switch data collection back from PC2 to PC1.
    1. Verify that the current data file on PC2 has not changed since step #23.3 above.
    2. Open new data files simultaneously on PC1 and PC2 ([Alt]-[F10]).
       
       
29. On PC1, switch MultiMon to a window, and verify that it is anchored in the upper right corner of the screen.
30. Switch to PTTP Uploader, click the "Manual" button, select all of the outstanding data files except for the file identified in step 23.1 above, and click the "Archive Only" button . Click the Upload and Archive button to transmit the remaining file to PTAGIS. Close the manual upload window, and verify that the Auto Upload option is enabled. Move the PTTP Uploader window to the right of the desktop, and then minimize the window.
31. Restore MultiMon to a full screen DOS box on PC1.
32. On PC2, switch MultiMon to a window.
33. Open PTTP Uploader. Click the "Manual" button, select the single file identified in step #23.3 above, and click the Upload and Archive option to transmit that file to PTAGIS. Then select all the remaining files and click the "Archive Only" button to transfer those files to the archive directory. Close the manual upload window, and exit PTTP Uploader.
34. Restore MultiMon to a full screen DOS box on PC2.
35. Press [F4] simultaneously on both PCs to confirm that the clocks are within one second of each other and Atomic Time.
36. Procedure complete.

References

Atomic Time – The time reference used by PTAGIS. Specifically, Pacific time zone, Coordinated Universal Time -8 hours; not Daylight Saving Time. This can be accessed from the Web at http://nist.time.gov/timezone.cgi?Pacific/d/-8/java.

MultiMon PIF Properties - The standard configuration for the MultiMon DOS application running in Windows 98. Screen shots of these attributes can be accessed from the PTAGIS FTP Portal at ftp://ftp.ptagis.org/Software/multimon/MultiMon%20PIF%20Properties/Multimon%20PIF%20Properties.pdf.