See DesignDoc for an overview of how to write a design document.
Our design documents are now kept in a shared Google Drive folder. To protect against their loss we're making regular backups everything in the "HTCondor Design Documents" folder. Other documents are not backed up (although you can easily adapt these instructions to do so, and see "Google Takeout" below).
Current backup master: Alan De Smet
- You need access to the HTCondor Design Documents. If you have not done so before, follow the directions on GoogleDriveWisdom .
- You need a CS department login, and access to at least one Linux computer in the department. Getting this is outside of the scope of this document.
Making a backup
Once per week(ish):
Log in per
Click the checkbox to the left of the folder "HTCondor Design Documents".
Some buttons should have appeared above the list of files and folders. Click the "More" at the top, not the one on the left side. A menu should appear; click "Download...". A dialog box labelled "Convert and Download" should appear.
Next to "Change all formats to:" click "MS Office". Click "Download".
Wait to be notified your download is ready. The dialogue box will probably say "Zipping Complete".
Your download should automatically start; if it doesn't click the link "click here to download".
If you are using Safari:
Google sent you a zip file, but your browser may have automatically opened up the zip, leaving you with a new folder named "HTCondor Design Documents." If this is true, you'll need to create a new zip file of that folder.
Ensure that the file is named something like
HTCondor_Design_Documents-2013-09-21.zip, with the current date in the last part in
year-month-dayorder. If it's not already in that pattern, rename it.
Put the download into our backup directory,
/p/condor/gittrac-backups/design-documents. Don't worry about other zip files already in the directory; we're keeping all of them for now.
I'm using my own Mac OS X computer:
Use a tool like
. You'll want to connect to a CS department Linux computer using "SFTP". Log in with your CS department user name and password. Navigate to
/p/condor/gittrac-backups/design-documentsand copy the zip file there.
I'm on a CSL supported Linux computer:
Copy the file into
I'm not on a CSL supported Linux computer, but I have AFS:
Copy the file into
- I'm using my own Mac OS X computer: Use a tool like Cyberduck . You'll want to connect to a CS department Linux computer using "SFTP". Log in with your CS department user name and password. Navigate to
- In a different folder , unzip the archive and open at least one of the files to ensure it looks plausibly correct. You can delete the unzipped files afterward; we're just keeping the zip archive as a backup.
Summary: we're not using it, ignore references to it. If you care what it is any why we're ignoring it:
Google Takeout allows bulk export of all of your Google Drive files, as well as many other things in Google's cloud storage. This is a good way to back up your own files. Unfortunately it captures everything, so is a poor fit for backing up the design documents because it will include unrelated documents in Drive. It also doesn't work with multiple logins, which can be nuisance (you'll need to log out of all Google accounts except your UW Google Apps account).
Documentation on using Google Takeout with your UW Google Apps account can be found at http://researchdata.wisc.edu/tools/tools-google-takeout/
- backup-1-checkbox.png 35852 bytes added by adesmet on 2013-Sep-16 18:26:22 UTC.
Screenshot 1: Checkbox to select.
- backup-2-menu.png 77152 bytes added by adesmet on 2013-Sep-16 18:26:37 UTC.
Screenshot 2: Menus to use.
- backup-3-download.png 71784 bytes added by adesmet on 2013-Sep-16 18:27:05 UTC.
Screenshot 3: Start zip creation.
- backup-4-download.png 54430 bytes added by adesmet on 2013-Sep-16 18:27:20 UTC.
Screenshot 4: Download.