Editing Backup Help File

Jump to navigation Jump to search

Warning: The database has been locked for maintenance, so you will not be able to save your edits right now. You may wish to copy and paste your text into a text file and save it for later.

The system administrator who locked it offered this explanation: restoring Database, Access will be restored shortly

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 9: Line 9:
 
*Highly configurable.
 
*Highly configurable.
 
*Only copies new and updated files.
 
*Only copies new and updated files.
*Produces detailed and summary logs so you can know just what it did.
+
*Produces detailed and summary logs.
 
*Once set up runs an update with a couple of clicks.
 
*Once set up runs an update with a couple of clicks.
 
*Recurse down a directory structure ( how far is configurable ).
 
*Recurse down a directory structure ( how far is configurable ).
 
*Can select files with "file filters"  For example only *.png and *.gif files.
 
*Can select files with "file filters"  For example only *.png and *.gif files.
 
*GUI shows activity.
 
*GUI shows activity.
*Can pause and resume.
+
*Can pause.
 
*Can set to throttle the backup so it does not degrade computer performance.
 
*Can set to throttle the backup so it does not degrade computer performance.
 
*Directory structure, file names, file format preserved in backup.
 
*Directory structure, file names, file format preserved in backup.
Line 51: Line 51:
  
 
= How To:... =  
 
= How To:... =  
== Goal ==
 
This is how I use the program, you could use it differently:
 
 
Put a short Python script in a directory.  When this is double clicked start the GUI for the backup program set up to backup the directory to another directory either on the current disk or another disk.
 
 
 
 
== General ==
 
== General ==
 
*Setup for backup of a directory.  See section below.
 
*Setup for backup of a directory.  See section below.
  
 
*Edit the parameter file:  Use your development environment for Python or a text editor to edit parameters.py.  See also: The section below, [[Configuration Files For Python]].  Normally I have a button on the GUI for this, but this function does not seem so useful for this application  
 
*Edit the parameter file:  Use your development environment for Python or a text editor to edit parameters.py.  See also: The section below, [[Configuration Files For Python]].  Normally I have a button on the GUI for this, but this function does not seem so useful for this application  
 +
*View the log:  Use the application button ( after configuring for your editor ) or any text editor on the file smart_plug.py_log. This is the default file name, it can be changed in parameters.py.
  
<!-----------
 
this cannot bee seen
 
 
 
*View the log:  Use the application button ( after configuring for your editor ) or any text editor on the file smart_plug.py_log. This is the default file name, it can be changed in parameters.py.
 
------------->
 
 
*Install: see section above.
 
*Install: see section above.
  
Line 73: Line 62:
  
 
*Quick Restart of the application:  Not in this app, just shutdown and restart.
 
*Quick Restart of the application:  Not in this app, just shutdown and restart.
 
 
*Use your preferred text editor. In the parameter file, see below.
 
*Use your preferred text editor. In the parameter file, see below.
 
*Using the GUI see: [[Backup GUI]]
 
 
== Setup for Backup ==
 
There are several different way to use the program, varying in part on how much you setup in parameters.py and how you structure your backups.  I generally set it up with a small program in the directory that I wish to backup, then to run the backup I go to that directory ( with a file manager ) and double click the file.  This is what I will describe here.  There are a lot of small variations you can make to how you run it and locate the files, you can probably figure many of these out yourself.
 
 
=== Manually Configure the Backup ===
 
 
*Copy the file _sample_backup.py from your download of the program and drop it in the source directory.  Lets say the name of this is  ....../my_important_files.
 
*Set up a backup location somewhere on your computer or network.  It should be named  ......./my_important_files.  You need to set up this directory manually because the backup program checks this name to make sure you do not backup to the wrong location by mistake.  Of course once this is setup it is done for good for that directory and backup configuration.
 
*The application comes with some sample files to be backed up and a backup location for them.
 
*For the rest of the setup read the file _sample_backup.py ( or your copy of it ) and then run it.
 
*Look at the display in the GUI for the setting the program is using, and if Ok then run the backup. See: [[Backup GUI]] for more info on the GUI
 
*After it has run take a look at the log files ( you can do this from the GUI once you configure parameters.py for your text editor of choice.
 
*_sample_backup.py will run pretty much the same no matter where it is located on you disk, except you may find the python log file left in the directory with _sample_backup.py
 
 
=== Minimally Configure the Backup ===
 
 
*Edit parameters.py to default:
 
**default_name = {default name for the backup}     
 
**log_detail_fn = {file name for the detailed log}
 
**log_summary_fn = {file name for the summary log} 
 
*Now look at the file _sample_backup_2.py for more documentation, pretty much all you have to set is the source and destination.
 
*Program runs like _sample_backup.py, see above.
 
 
=== No Configruation of Backup ===
 
In this mode the the location of the backup.py file determines the source directory and parameters.py computes a destination.  In my setup many files come from my D: drive and go to a network location rooted at I:\Data.  So I use a method in the backup.py file to compute the destination......
 
 
Code in _sample_backup_3.py and the shipped parameters.py as  parameters.set_source_here() look at these files.
 
  
 
=  How to Use the Parameter File =  
 
=  How to Use the Parameter File =  
Line 120: Line 79:
 
= The GUI =
 
= The GUI =
  
see: [[Backup GUI Images]]
+
see: [[SmartPlug GUI Images]]
  
 
= Debugging =  
 
= Debugging =  
Line 128: Line 87:
 
* Watch the GUI
 
* Watch the GUI
 
* Check the Python console.
 
* Check the Python console.
* Look at the python log file ( use the GUI button <Edit Log> ( specify your editor in parameters.py first ) or use your editor on the default name of the log file ...\backup\backup.py_log.
+
* Look at the python log file ( use the GUI button <Edit Log> ( specify your editor in parameters.py first ) or use your editor on the default name of the log file ...\smart_plug\smart_plug.py_log.
  
 
Most issues will probably be missing libraries, parameters.py issues, or just bugs in my code (email me ).
 
Most issues will probably be missing libraries, parameters.py issues, or just bugs in my code (email me ).
 
If you are dropping you backup scripts around your disks and double clicking them you may need to tweak your path so python.exe or pythonw.exe is on your path.
 
  
 
<!-----------
 
<!-----------
Line 148: Line 105:
  
  
[[category:Python Backup]] [[category:Python]] [[category:Python Projects]]
+
[[category:Python Backup]] [[category:Python]]

Please note that all contributions to OpenCircuits may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see OpenCircuits:Copyrights for details). Do not submit copyrighted work without permission!

Cancel Editing help (opens in new window)