home *** CD-ROM | disk | FTP | other *** search
/ InterCD 2000 January / january_2000.iso / Usenet / Gravity / grav22b6.exe / GRAVITYBACKUP.TXT < prev    next >
Encoding:
Text File  |  1998-02-24  |  5.7 KB  |  145 lines
  1.  
  2. GravityBackup.exe is a utility to save and restore a Gravity
  3. database and registry settings.
  4.  
  5. How to use GravityBackup
  6. ------------------------
  7.  
  8. To back up your Gravity database and registry settings, start
  9. GravityBackup and select the Gravity->Backup menu item.  A
  10. dialog box will prompt you for the backup file's name.  Enter
  11. the name of the file and hit OK.
  12.  
  13. To restore a backup file, start GravityBackup and select the
  14. Gravity->Restore menu item.  A dialog box will ask you for the
  15. name of the backup file.  Enter the file's name and hit OK.
  16.  
  17. Note that in this version of GravityBackup.exe, you should
  18. only restore a Gravity database to the same directory that you
  19. originally backed it up from.  For more information on this,
  20. see the section below titled "Restoring to a different
  21. directory".
  22.  
  23. Using command-line parameters
  24. -----------------------------
  25.  
  26. -b<filename>
  27.  
  28. If the -b command-line parameter is used, GravityBackup will
  29. back up the Gravity database to the specified backup file and
  30. exit.  BackupGravity will overwrite the specified file if it
  31. exists.  BackupGravity returns a status code of 0 for success
  32. and non-0 for error.
  33.  
  34. -r<filename>
  35.  
  36. If the -r command-line parameter is used, GravityBackup will
  37. restore the Gravity database from the specified backup file and
  38. exit.  BackupGravity returns a status code of 0 for success
  39. and non-0 for error.
  40.  
  41. Supported Gravity Versions
  42. --------------------------
  43.  
  44. This is version 1.1 of GravityBackup.  It supports versions 1.1
  45. through 2.1 of Gravity.  Backup files generated by this program
  46. should be restored to the same version of Gravity that they were
  47. generated from.
  48.  
  49. What does GravityBackup save?
  50. -----------------------------
  51.  
  52. A backup file generated by GravityBackup.exe contains the
  53. Gravity database located in the "newsdb" subdirectory of the
  54. main Gravity directory.  It also contains the Gravity settings
  55. contained in the registry under these keys:
  56.  
  57.   HKEY_CURRENT_USER/Software/MicroPlanet/Gravity
  58.   HKEY_CURRENT_USER/Software/MicroPlanet/SSCE
  59.   HKEY_CURRENT_USER/Software/MicroPlanet/Image Gallery
  60.   HKEY_LOCAL_MACHINE/Software/MicroPlanet/Gravity
  61.   HKEY_LOCAL_MACHINE/Software/MicroPlanet/SSCE
  62.  
  63.   HKEY_CURRENT_USER/Software/Anawave/Gravity
  64.   HKEY_CURRENT_USER/Software/Anawave/SSCE
  65.   HKEY_CURRENT_USER/Software/Anawave/Image Gallery
  66.   HKEY_LOCAL_MACHINE/Software/Anawave/Gravity
  67.   HKEY_LOCAL_MACHINE/Software/Anawave/SSCE
  68.  
  69. To support Gravity versions 2.0 and 1.1, gravitybackup.exe backs
  70. up the Anawave registry keys, and it backs up the MicroPlanet
  71. registry keys in order to handle Gravity versions 2.1 and above.
  72.  
  73. User Privileges required under Windows NT
  74. -----------------------------------------
  75.  
  76. Under Windows NT, GravityBackup.exe cannot save/restore the
  77. registry settings unless the current user has the "Back up files
  78. and directories" and "Restore files and directories" user rights.
  79. To make sure you have these rights, you can use the User Manager
  80. administrator utility.
  81.  
  82. Restoring to a different directory
  83. ----------------------------------
  84.  
  85. In this version of GravityBackup.exe, you should only restore a
  86. Gravity database to the same directory that you originally backed
  87. it up from.
  88.  
  89. The program will allow you to restore a backup file that was
  90. created from a Gravity installation at a different location than
  91. your current Gravity installation.  If you do this, the backed-up
  92. database will be restored into your current Gravity database
  93. location, but the Gravity registry settings will be the old
  94. settings (i.e., they will point to the old database directory),
  95. so you will have to fix them using the regedit.exe utility.
  96. These settings are in the following registry values:
  97.  
  98.   HKEY_CURRENT_USER/Software/Anawave/Gravity/Storage/DatabasePath
  99.   HKEY_CURRENT_USER/Software/Anawave/Gravity/Servers/Server1/DatabasePath
  100.   HKEY_CURRENT_USER/Software/Anawave/Gravity/Servers/Server2/DatabasePath
  101.   HKEY_CURRENT_USER/Software/Anawave/Gravity/Servers/Server3/DatabasePath
  102.   etc...
  103.  
  104. You may also need to change some other paths stored under these keys:
  105.  
  106.   HKEY_CURRENT_USER/Software/Anawave/Gravity/Dirs
  107.   HKEY_CURRENT_USER/Software/Anawave/Gravity/Servers/Server1
  108.   HKEY_CURRENT_USER/Software/Anawave/Gravity/Servers/Server2
  109.   HKEY_CURRENT_USER/Software/Anawave/Gravity/Servers/Server3
  110.   etc...
  111.  
  112. Due to the complexity of this procedure, we recommend only
  113. restoring a database that was backed up from a Gravity
  114. installation at the same location as your current Gravity
  115. installation.
  116.  
  117. Disk space warnings
  118. -------------------
  119.  
  120. In some situations, the program reports an incorrect value for
  121. the hard disk space remaining.  For example, this happens on
  122. versions of Windows 95 before OSR2 if the hard disk is larger than
  123. 2GB. However, the program will allow the user to continue with the
  124. backup or restore operation even if it thinks there isn't enough
  125. disk space.
  126.  
  127. Using the "remove existing DB" setting
  128. --------------------------------------
  129.  
  130. In the options dialog, there is a setting to remove the existing
  131. database and registry settings before each restore operation. This
  132. option defaults to "off", but in some situations, it is necessary
  133. to enable it so that the restored database and registry settings
  134. are not combined with the existing ones.
  135.  
  136. When a Gravity database and its registry settings are restored
  137. from a backup file, they are written on top of whatever exists in
  138. the database directory and registry keys.  In some situations, it
  139. is necessary to remove the existing database and registry
  140. information before restoring.  For example, if the existing
  141. registry settings have settings for a news server that doesn't
  142. exist in the restored database, then after the database is restored,
  143. that news server will show up in Gravity, and selecting it will
  144. cause a crash.
  145.