Abstract: These utilities have been developed to help automate the ADSM Server support function at Cornell. I hope you will find them to be of some use. There is currently not very good documentation on how to install and use these utilities. I am hoping to correct this situation soon. If you are at all familiar with the Rexx language, you should be able to use most of these utilities after looking at the execs to see how they work. Each utility generally has documentation at the beginning of it, followed by some parameters that you may want to set. Contents: The rest of this document contains: Utilities - list of utilities described Sample Output - sample output from each utility Author Info - Where you can reach me Legal Information - Terms & Conditions of use Utilities: daily.actlog.filter - strip "noise" out of ADSM activity log; email to you daily.backup - notify ADSM users if they don't get backed up daily.tape - check for tape related problems daily.usage.summary - summarize ADSM usage for day (or month) Rexx functions used by above utilities: adsmadm - issue ADSM admin commands. You must set id & pswd. cronrexx - calls rexx exec from cron daily.actlog - driver to call daily.actlog.filter daily.actlog.get - called by daily.actlog edate - date manipulation function Sample Output: daily.backup (e-mail to user): --- start of sample --- Output from ADSM Backup Monitor: System 'IR.AES3.EZBACKUP' has NOT been backed up by the ADSM Backup Server within the last 1 day. You are listed as the administrator for this system, and our records indicate that you would like to receive this notification whenever this system is not backed up regularly. If you want to change the notification policy for this system, please send E-mail to adsm-maint@nodename1.cornell.edu. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - System Name: PEACH.EZBACKUP (Mac) Notification: Always notify. The only volume for this system has NOT been backed up within the last 1 day: Volume name Last Backup Done Days Ago ----------------------------------------- ------------------- -------- Hard Drive 10/06/1995 01:33:54 3.7 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --- end of sample --- Sample Output: daily.backup (e-mail to server administrator): --- start of sample --- Output from ADSM Backup Monitor: Summary Information: Nodes backed up and not notified: 139 Nodes backed up and notified: 25 Nodes not backed up recently: 15 Nodes not wanting notification: 2 Nodes locked: 0 Nodes never contacted server: 6 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = Short version of mail sent to John Doe (4-1234): 4 of the following computer systems have been successfully backed up recently, and 5 of the following computer systems have NOT been backed up recently, by the ADSM Backup Server. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - System Name: CC.ARAP.EZBACKUP (Mac) Notification: Always notify. The only volume for this system has NOT been backed up within the last 1 day: Volume name Last Backup Done Days Ago ----------------------------------------- ------------------- -------- ARAP-RP hd 05/10/1995 00:16:18 152.4 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - (etc...) --- end of sample --- Sample Output: daily.tape (e-mail to server administrator) --- start of sample --- Output from ADSM maintenance script: "daily.tape". WARNING: The following 8MM Tape Volumes are in ERROR STATE: (AB0082) WARNING: The following 8MM Tape Volumes have been mounted > 300 times: AB0024 - 349 mounts AB0026 - 302 mounts AB0035 - 301 mounts WARNING: The following 8mm Tape Volumes have > 0 Read Errors: AB0058 - 1 Read Error(s) WARNING: Only 5 good volumes are left in Storage Pool BKP.TAP. (AB0028, AB0069, AB0079, AB0085, AB0087) The target for this Storage Pool is 6 good volumes. There are 29 other volumes in this Storage Pool. (AB0003, AB0008, AB0012, AB0024, AB0026, AB0029, AB0031, AB0033) (AB0034, AB0035, AB0036, AB0039, AB0040, AB0046, AB0047, AB0057) (AB0058, AB0059, AB0061, AB0062, AB0064, AB0065, AB0067, AB0068) (AB0073, AB0080, AB0081, AB0082, AB0084) (these are full, r/o, failing or old). --- end of sample --- Sample Output: daily.usage.summary (e-mail to server administrator) --- start of sample --- ADSM Activity Report for 10/07/1995 Activity # Sess # Obj # Bytes Time MediaW CommW IdleW Xfer Rate ------------ ------ ------ ------- ---------- ------ ------ ------ ------------ Backup 160 25475 1.3GB 77:57:58 0.099% 30.2% 25.6% 6.24 KB/s Restore 0 0 0 B 0:00:00 Archive 262 267 79.4MB 0:13:25 22.7% 30.4% 15.5% 159.75 KB/s Retrieve 5 44 8.2MB 0:33:18 41.2% 5.7% 19.7% 10.48 KB/s Other 18 0 63000 B 0:48:41 0% 0% 31.9% 0.03 KB/s Total 445 25786 1.6GB 79:33:22 0.4% 29.7% 25.6% 7.74 KB/s Notes: - Time = total wall-clock time - MediaW = % of wall-clock time spent waiting for Media - CommW = % of wall-clock time spent waiting for Network - IdleW = % of wall-clock time spent idle (waiting for user) - Xfer Rate = Transfer Rate (Bytes / (Time * (1 - (MediaW + IdleW)))) # Bytes % Tot Top 10 nodes for 10/07/1995: ------- ------ ---------------------------------------- 223.2MB 13.6% ORANGE 195.6MB 11.9% BANANA.CISER.CORNELL.EDU 131.0MB 8.0% PLUM.CISER.CORNELL.EDU 120.4MB 7.3% CHERRY.CFE.CORNELL.EDU 100.7MB 6.1% GRAPE 82.5MB 5.0% PEAR 38.2MB 2.3% APPLE.CFE.CORNELL.EDU 35.1MB 2.1% PEACH.OS2.EZBACKUP 34.7MB 2.1% RASPBERRY 27.4MB 1.7% QUINCE.SERVER4.EZBACKUP 10.7MB Average, for 153 nodes. --- end of sample --- Author Information: My time is limited, but I welcome feedback and will try to answer your questions as my time permits. I can be reached at: Paul Zarnowski 315 CCC Cornell University Ithaca, NY 14853-2601 e-mail: psz1@cornell.edu FAX: 607-255-6523 Legal Information: Although copyrighted, this software is being licensed to you for your use free of charge. However, ownership of and interest in this software shall remain with the author. Use and distribution of this software is governed by the following terms. This software is owned by the author and contains valuable and proprietary information of the author. If you violate any part of this agreement, your right to use this software terminates automatically. In the event of termination of this agreement, you must destroy all copies of this software and derivatives of this software in your possession and cease distributing the same. This software is being licensed to you as provided by the terms of this agreement. You may: 1. Use this software on as many computers as you want at any given time. 2. Make as many backup copies of this software as you want. 3. Alter the software in any manner you see fit FOR YOUR OWN PERSONAL USE. Such altered versions should not be distributed. The creation of such derivatives shall not diminish the author's title to this software. 4. Terminate this agreement at any time by destroying all copies of this software and derivatives of this software and cease distributing the same. You may not: 1. Create any derivative works from this software for distribution. 2. Re-distribute this software for commercial (for-profit) purposes. Contact the author at the address within this document if you wish to distribute this software for commercial usage, or if you have any questions about its redistribution. Disclaimer of warranty: In using this software, you understand and agree that this software is provided "as is" without warranty of any kind. The entire risk as to the results of and performance of using this software lies entirely with you, the user. The author does not make any warranties, either expressed or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to this software. In no event shall the author be liable for any consequential, incidental, or special damages whatsoever arising out of the use or inability to use this software.