Short: 0.18 - Backup/Restore/Install for PalmPilot Author: Marcin Orlowski Uploader: Marcin Orlowski Version: 0.18 Type: comm/misc Date: Sat Feb 13 14:31:41 1999 Requires: util/libs/PalmLink.lha Www: http://amiga.com.pl/ If you own an Amiga and 3Com's Palm Pilot Personal, Palm Pilot Professional, Palm III organizer, IBM's WorkPad or derivatives, this software is for you!. INTRODUCTION -------------------- During the development of our PalmSuite for Amiga software, the PalmLink library was released. As we needed to find out if that library gives us any gain compared to our connection stack, we quickly adapted some tools we got here, to use PalmLink library. The PalmBackup is the result of that. FUNCTIONALITY -------------------- This is not intended to be neither a demo version of PalmSuite nor the evaluation release of any part of it. It's just the quick PalmLink tester ;-) PalmBackup features: · backup of organiser databases · restore · multi user support · internal cache system (once you list your unit, PalmBackup will keep the list of the remote files). · advanced manager for installing, removing, purging etc QUICK TOUR ----------- How to start using PalmBackup: · download PalmBackup and PalmLink · unpack to any directory (no need of further installation) · launch it · enter the user editor (via menu, or by clicking 'faces' on toolbar) · add yourself to the user list. NOTE: if your unit is already personalised, you MUST enter the same name your unit belongs to, otherwise you won't be able to backup/restore anything! NOTE2: if your unit is not personalised yet, pick up the name you want it to be personalised to, because PalmBackup will set up the owner while next Backup/Restore operation! · select yourself as 'default profile'. · accept changes and leave the user editor · select "Project/Select user" and pick up your name · enter "Settings/Backup" · click "Scan" to fetch list of available databases · when done, build the list of files you care about. We suggest to add all "Generic" databases (those which got "Backup on HotSync" flag set), and make sure "ToDoDB", "AddressDB", "DateBookDB" and "MemoDB" are on the backup list (if not, add them by hand). · accept changes you've made by clicking "OK". Now you are ready to backup your databases. To backup selected files: · put your unit in the craddle · press "Backup" icon -> you'll see the list of files to bacup · press "Backup all" · press "HotSync" button when requested · wait till backup is finished NOTE: every database will be purged after backup (usual behaviour) To restore *whole* backup (restoration of single files is possible, but not in easy way, see below. Sorry): · select the backup you want · click "Restore" button to see the list of files you are going to restore · press "Restore all" · press "HotSync" button when requested · wait till restore is completed To install any software/files: · select "Project/Manager" menu item · using the left panel browse to the directory you got the files to install (yes, we know that panel sucks, but as I said, it's quick hack - PalmSuite offers 'normal' panels and more features - consider ordering!) · select the file(s) you want to install · press "Install" · press "HotSync" button when requested · wait till transfer is completed NOTE: the cache is not updated when you play in Manager, so you won't see your newly installed file unless you reScan the list ("Scan" button)! NOTE2: if you want to restore single file from your backup, browse to your user directory (in "PalmPilotData"), enter "Day" then "Time" subdirs, select database you want to be restored and "Install" it as described above. To fetch (backup) single file(s): · select them on the right panel list · select destination directory in the left panel · press "Fetch" · press "HotSync" button when requested · wait till finished To delete any software/files: · select them on the right panel list · press "Delete" · confirm (or not) the operation MOTE: this cannot be undone unless you got your victims backuped! · press "HotSync" button when requested · wait till finished To purge (remove records marked as deleted) any database: · select them on the right panel list · press "Purge" (there's NO confirmation requester!) MOTE: these purged records cannot be restored unless you've got your victims backuped! But that's usually not a problem ;-) · press "HotSync" button when requested · wait till finished CONFIGURATION -------------------- By default PalmBackup uses serial.device unit 0 at 57600 baud. If you want it to use something different (your own MFC, HC etc I/O cards), there're 3 environmental variables you should set: palmbackup_device - name of the device you want to use (e.g. "duart.device") palmbackup_unit - unit of the device (e.g. "1") palmbackup_maxbaud - maximum allowed speed of the connection (e.g. try "115200" for I/O cards ;-). More than "57600" makes no sense for serial.device. These variables are read every time the connection is going to be establised, so you don't need to relaunch PalmBackup if you change any of these variables. BUGS -------------------- It works quite stable, but you may encounter some strange behaviour if you play with user editor too heavily. This will of course be fixed in PalmSuite. Sometimes cache is getting purged on exit. REQUIREMENTS -------------------- · AmigaOS 2.x or better · PalmPilot organiser (or derivatives) · MUI 3.8 or better · PalmLink.library CONTACT -------------------- W.F.M.H. ul. Radomska 38 71-002 Szczecin Poland e-mail: carlos@amiga.com.pl www: http://amiga.com.pl/ COPYRIGHTS -------------------- PalmBackup is written by Marcin Orlowski and is copyrighted by Marcin Orlowski and W.F.M.H. You may copy and distribute verbatim copies of the programs' executable code and documentation as you receive it, in any medium, provided that you conspicuously and appropriately publish only the original, unmodified programs, with all copyright notices and disclaimers of warranty intact and including all the accompanying documentation, example files and anything else that came with the original. You may not copy and/or distribute these programs without the accompanying documentation and other additional files that came with the original. You may not copy and/or distribute modified versions of these programs as well as you are not allowed to modify both binaries and documentation files You may not disassemble, decompile, re-source or otherwise reverse engineer the programs. If you wish to incorporate parts of the programs into other programs, write to the author to ask for written permission. You agree to cease distributing the programs and data involved if requested to do so by the author. NO WARRANTY -------------------- There is no warranty for the programs, to the extent permitted by applicable law. Except when otherwise stated in writing the copyright holder and/or other parties provide the programs "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the programs is with you. Should the programs prove defective, you assume the cost of all necessary servicing, repair or correction. In no event unless required by applicable law or agreed to in writing will any copyright holder, or any other party who may redistribute the programs as permitted above, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the programs (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the programs to operate with any other programs), even if such holder or other party has been advised of the possibility of such damages. DISCLAIMER --------------- No warranty, either express or implied, is made with respect to the fitness or merchantability of PalmBackup The author, reserves the right to not develop any future versions of PalmBackup, nor to attempt at correcting any problems if any are discovered in PalmBackup (order PalmSuite!) The author neither assumes nor accepts any responsibility for the use or misuse of these programs. He also will not be held liable for damages or any compensation due to loss of profit or any other damages arising out of the use, or inability to use these programs. The author will not be liable for any damage arising from the failure of these programs to perform as described, or any destruction of other programs or data residing on a system attempting to run the programs. While I know of no damaging errors, the user of these programs uses it at his or her own risk. ___ ___ ___ ________ ___ ___ ___ ___ ___ / \/ \/ \ / \ / \/ \/ \ / \/ \ / / / / / / / / / / / / / / / / / / _____/ / / / / / / / / / / / / \ / / / / / / / / / / / / / / / / / / / / / / / _____/ / / / / / / / / / / / / / / / / / / / / \___/\___/\___/ / / \___/\___/\___/ \___/\___/ / / \___/ W.F.M.H. on-line http://amiga.com.pl/ http://wfmh.org.pl/ ============================= Archive contents ============================= Original Packed Ratio Date Time Name -------- ------- ----- --------- -------- ------------- 1188 540 54.5% 29-Jan-99 12:46:10 PalmBackup.info 2642 1414 46.4% 13-Jan-99 14:18:54 +TB_Backup.iff 1032 605 41.3% 03-Feb-99 21:43:30 +TB_Info.iff 1086 726 33.1% 03-Feb-99 21:42:34 +TB_Manager.iff 1038 497 52.1% 30-Jan-99 22:14:38 +TB_Profile.iff 2648 1406 46.9% 13-Jan-99 14:19:22 +TB_Restore.iff 1030 669 35.0% 23-Jan-99 20:51:58 +TB_Users.iff 10236 5027 50.8% 18-Jun-97 09:03:52 +File.mcc 6612 3512 46.8% 03-Nov-98 00:33:48 +NDirlist.mcc 30964 15533 49.8% 18-Jun-97 11:48:16 +NewDirlist.mcc 22056 9378 57.4% 18-Jun-97 12:23:46 +NewDirlist.mcp 74172 33236 55.1% 13-Feb-99 14:31:16 +PalmBackup 3733 1771 52.5% 29-Jan-99 12:46:10 +PalmBackup.info 10255 3995 61.0% 13-Feb-99 14:31:42 +PalmBackup.readme 2797 1426 49.0% 29-Jan-99 12:46:10 +PalmBackup.readme.info 16820 8847 47.4% 10-Sep-98 01:38:48 +palmlink.library -------- ------- ----- --------- -------- 188309 88582 52.9% 15-Feb-99 06:07:42 16 files