Backup and Restore FAQ: Difference between revisions

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search
No edit summary
 
(7 intermediate revisions by 3 users not shown)
Line 2: Line 2:


===Questions===
===Questions===
*[[Backup and Restore FAQ#How can I backup my data within the CommitCRM system?|How can I backup my data within the CommitCRM system?]]
*[[Backup and Restore FAQ#How can I backup my data within the RangerMSP system?|How can I backup my data within the RangerMSP system?]]
*[[Backup and Restore FAQ#Can I backup CommitCRM using external tools?|Can I backup CommitCRM using external tools?]]
*[[Backup and Restore FAQ#Can I backup RangerMSP using external tools?|Can I backup RangerMSP using external tools?]]
*[[Backup and Restore FAQ#Is there a way to perform a live backup (Backup your data while the system is in use)]]
*[[Backup and Restore FAQ#Is there a way to perform a live backup (Backup your data while the system is in use)|Is there a way to perform a live backup (Backup your data while the system is in use)]]
*[[Backup and Restore FAQ#Which folders should be backed up?|Which folders should be backed up?]]
*[[Backup and Restore FAQ#Which folders should be backed up?|Which folders should be backed up?]]
*[[Backup and Restore FAQ#How do I restore a backup?|How do I restore a backup?]]
*[[Backup and Restore FAQ#How do I restore a backup?|How do I restore a backup?]]
*[[Backup_and_Restore_FAQ#I.27ve_just_restored_CommitCRM_onto_a_new_computer.2C_and_the_client_gives_me_an_error_when_I_log_in.3B_What_am_I_doing_wrong.3F|I've just restored CommitCRM onto a new computer and the client gives me an error when I log in. What am i doing wrong?]]
*[[Backup_and_Restore_FAQ#I.27ve_just_restored_RangerMSP_onto_a_new_computer.2C_and_the_client_gives_me_an_error_when_I_log_in.3B_What_am_I_doing_wrong.3F|I've just restored RangerMSP onto a new computer and the client gives me an error when I log in. What am i doing wrong?]]


----
----


===How can I backup my data within the CommitCRM system?===
===How can I backup my data within the RangerMSP system?===
When using the CommitCRM system, users can perform a '''partial backup''', which backs up the CommitCRM database only, or a '''full backup''', which saves the entire CommitCRM system.
When using the RangerMSP system, users can perform a '''partial backup''', which backs up the RangerMSP database only, or a '''full backup''', which saves the entire RangerMSP system.


CommitCRM comes with a special utility to back up the CommitCRM databases (providing a partial-backup which saves the the database only). To access this backup utility, go to Tools > Backup menu, and follow the steps. This process will back up the database files that are located in the <server>\Commit\Db and <server>\Commit\DbSys folders.
RangerMSP comes with a special utility to back up the RangerMSP databases (providing a partial-backup which saves the the database only). To access this backup utility, go to Tools > Backup menu, and follow the steps. This process will back up the database files that are located in the <server>\RangerMSP\Db and <server>\RangerMSP\DbSys folders.


<u>Note:</u> This backup creates a zip file in the <server>\Commit\Utils folder that contains CommitCRM-specific files only. It does not back up your linked documents, which should be backed up separately.
<u>Note:</u> This backup creates a zip file in the <server>\RangerMSP\Utils folder that contains RangerMSP-specific files only. It does not back up your linked documents, which should be backed up separately.


We also recommend that users occasionally perform a full backup, which saves the entire CommitCRM server folder and all its subfolders. This type of backup must be done using external tools. A full backup will enable you to restore the files much faster should you need to do so in an emergency situation.
We also recommend that users occasionally perform a full backup, which saves the entire RangerMSP server folder and all its subfolders. This type of backup must be done using external tools. A full backup will enable you to restore the files much faster should you need to do so in an emergency situation.


It is recommended to copy the backup file to another hard disk, computer, or media.
It is recommended to copy the backup file to another hard disk, computer, or media.




===Can I backup CommitCRM using external tools?===
===Can I backup RangerMSP using external tools?===
Yes. It is recommended to back up the entire CommitCRM server folder and all its subfolders on occasion. This will enable you to restore the files much faster should you need to do so. Any backup utility/program should work, such as the standard tape backup, zip, rar, etc.
Yes. It is recommended to back up the entire RangerMSP server folder and all its subfolders on occasion. This will enable you to restore the files much faster should you need to do so. Any backup utility/program should work, such as the standard tape backup, zip, rar, etc.


<u>Note:</u> Make sure that no one is using CommitCRM during a full backup.
<u>Note:</u> Make sure that no one is using RangerMSP during a full backup.


===Is there a way to perform a live backup (Backup your data while the system is in use)===
Yes, RangerMSP comes with a Live Backup option, when using SQL Database for RangerMSP.
When using the Live Backup, there is no need to stop users and services from working while performing a backup. Everyone can continue working as usual while the backup is performed in the background.
Note that the Live Backup requires [http://{{SERVERNAME}}/products/sql-database/ SQL Database].
To perform a live backup administrators should run the \RangerMSP\Utils\CRMBackup.exe with a special parameter which tells the system to perform a live backup.
In order to fully automate Live Backups you should use Windows Task Scheduler procedure and add a recurring Task that runs the backup utility.
For more details and instructions, refer to \RangerMSP\Utils\CRMBackup.ini
'''Important: Live back does not come instead of other backup methods. You still need to backup your RangerMSP system as you have so far.
'''


===Which folders should be backed up?===
===Which folders should be backed up?===
Back up all folders under <server>\Commit. The most important folders are called “Commit\Db” and “Commit\DbSys,” which is where all CommitCRM-specific data is stored. You should also back up all your documents.
Back up all folders under <server>\RangerMSP. The most important folders are called “RangerMSP\Db” and “RangerMSP\DbSys,” which is where all RangerMSP-specific data is stored. You should also back up all your documents.
 


===How do I restore a backup?===
===How do I restore a backup?===
You can restore the CommitCRM system using the partial-backup files (database only) or the full-backup files.
You can restore the RangerMSP system using the partial-backup files (database only) or the full-backup files.




'''To restore the full system using full-backup files:'''<br>To restore from a full backup (i.e. a backup file which includes the CommitCRM installation folder and all <u>sub-folders</u>), [[Transferring_Commit_Installation_from_One_Server_to_Another|please follow these instructions]]. This includes restoring the files and installing any services if they were used.
'''To restore the full system using full-backup files:'''<br>To restore from a full backup (i.e. a backup file which includes the RangerMSP installation folder and all <u>sub-folders</u>), [[Transferring_the_Software_Installation_from_One_Server_to_Another|please follow these instructions]]. This includes restoring the files and installing any services if they were used.


CommitCRM will now be ready for use at the exact point when the backup was done.
RangerMSP will now be ready for use at the exact point when the backup was done.




'''To restore the full system using a partial-backup (database-only) files:'''
'''To restore the full system using a partial-backup (database-only) files:'''
#Download and install a fresh [http://www.commitcrm.com/download.php trial version of CommitCRM]. Make sure to use the exact same version as you have been using until now, otherwise there will be version mismatch when restoring the database.
#Download and install a fresh [http://{{SERVERNAME}}//free-trial/free-trial-download/ trial version of RangerMSP]. Make sure to use the exact same version as you have been using until now, otherwise there will be version mismatch when restoring the database.
#Install it to the original path where CommitCRM was installed on your server originally.
#Install it to the original path where RangerMSP was installed on your server originally.
#Run the CommitCRM application once (use any user as this is a fresh setup)
#Run the RangerMSP application once (use any user as this is a fresh setup)
#Close the CommitCRM session.
#Close the RangerMSP session.
#Rename the <server>\Commit\Db folder to  <server>\Commit\Db-Not-In-Use.
#Rename the <server>\RangerMSP\Db folder to  <server>\RangerMSP\Db-Not-In-Use.
#Rename the <server>\Commit\DbSys folder to  <server>\Commit\DbSys-Not-In-Use.
#Rename the <server>\RangerMSP\DbSys folder to  <server>\RangerMSP\DbSys-Not-In-Use.
#From the backup, copy the \Commit\Db and \Commit\DbSys folders to <server>\Commit\Db and <server>\Commit\DbSys.
#From the backup, copy the \RangerMSP\Db and \RangerMSP\DbSys folders to <server>\RangerMSP\Db and <server>\RangerMSP\DbSys.


CommitCRM will now be ready for use at the exact point when the backup was done.
RangerMSP will now be ready for use at the exact point when the backup was done.




'''To restore from a backup only in order to revert changes in the database:'''<br>Should you need to restore a backup to revert changes, your current CommitCRM installation can still be used. You just need to replace the database files.
'''To restore from a backup only in order to revert changes in the database:'''<br>Should you need to restore a backup to revert changes, your current RangerMSP installation can still be used. You just need to replace the database files.
   
   
To restore a partial backup:
To restore a partial backup:
#Rename the <server>\Commit\Db folder to  Db-Not-In-Use.
#Rename the <server>\RangerMSP\Db folder to  Db-Not-In-Use.
#Rename the <server>\Commit\DbSys folder to  DbSys-Not-In-Use.
#Rename the <server>\RangerMSP\DbSys folder to  DbSys-Not-In-Use.
#From the backup-file, copy the Db and DbSys folders to <server>\Commit\Db  and  <server>\Commit\DbSys.
#From the backup-file, copy the Db and DbSys folders to <server>\RangerMSP\Db  and  <server>\RangerMSP\DbSys.


CommitCRM will now be ready for use at the exact point when the backup was done.  
RangerMSP will now be ready for use at the exact point when the backup was done.  


<br>
<br>
===I've just restored CommitCRM onto a new computer, and the client gives me an error when I log in; What am I doing wrong?===
===I've just restored RangerMSP onto a new computer, and the client gives me an error when I log in; What am I doing wrong?===
  Procedure halted due to data server error.<br>Verify server is operating and this computer has access to the server folder.<br>(C:\Commit\DB)
  Procedure halted due to data server error.<br>Verify server is operating and this computer has access to the server folder.<br>(C:\RangerMSP\DB)
When restoring CommitCRM onto a new computer from a backup archive, the next step is to verify that the path in the error message exists, and has the database files in it and test a single CommitCRM client application from the server that CommitCRM is installed on. If running the client from the server itself produces an error report like the error above, then the issue may very well be caused by not installing the Commit SQL Database.
When restoring RangerMSP onto a new computer from a backup archive, the next step is to verify that the path in the error message exists, and has the database files in it and test a single RangerMSP client application from the server that RangerMSP is installed on. If running the client from the server itself produces an error report like the error above, then the issue may very well be caused by not installing the RangerMSP SQL Database.


If your system is licensed for the Commit SQL Database, then follow the steps in the '''[[Commit_SQL_Database_Installation_Guide|Commit SQL Database installation page]]''', and then continue to the '''[[Commit_SQL_Database_Troubleshooting|this Troubleshooter]]''' to resolve it.<br>
If your system is licensed for the RangerMSP SQL Database, then follow the steps in the '''[[SQL_Database_Installation_Guide|SQL Database installation page]]''', and then continue to the '''[[SQL_Database_Troubleshooting|this Troubleshooter]]''' to resolve it.<br>


<br>
<br>
[[Category:FAQ]]
[[Category:FAQ]]
__NOTOC__
__NOTOC__

Latest revision as of 07:49, 8 July 2020

FAQ > Backup and Restore FAQ

Questions


How can I backup my data within the RangerMSP system?

When using the RangerMSP system, users can perform a partial backup, which backs up the RangerMSP database only, or a full backup, which saves the entire RangerMSP system.

RangerMSP comes with a special utility to back up the RangerMSP databases (providing a partial-backup which saves the the database only). To access this backup utility, go to Tools > Backup menu, and follow the steps. This process will back up the database files that are located in the <server>\RangerMSP\Db and <server>\RangerMSP\DbSys folders.

Note: This backup creates a zip file in the <server>\RangerMSP\Utils folder that contains RangerMSP-specific files only. It does not back up your linked documents, which should be backed up separately.

We also recommend that users occasionally perform a full backup, which saves the entire RangerMSP server folder and all its subfolders. This type of backup must be done using external tools. A full backup will enable you to restore the files much faster should you need to do so in an emergency situation.

It is recommended to copy the backup file to another hard disk, computer, or media.


Can I backup RangerMSP using external tools?

Yes. It is recommended to back up the entire RangerMSP server folder and all its subfolders on occasion. This will enable you to restore the files much faster should you need to do so. Any backup utility/program should work, such as the standard tape backup, zip, rar, etc.

Note: Make sure that no one is using RangerMSP during a full backup.


Is there a way to perform a live backup (Backup your data while the system is in use)

Yes, RangerMSP comes with a Live Backup option, when using SQL Database for RangerMSP.

When using the Live Backup, there is no need to stop users and services from working while performing a backup. Everyone can continue working as usual while the backup is performed in the background.

Note that the Live Backup requires SQL Database.

To perform a live backup administrators should run the \RangerMSP\Utils\CRMBackup.exe with a special parameter which tells the system to perform a live backup.

In order to fully automate Live Backups you should use Windows Task Scheduler procedure and add a recurring Task that runs the backup utility.

For more details and instructions, refer to \RangerMSP\Utils\CRMBackup.ini

Important: Live back does not come instead of other backup methods. You still need to backup your RangerMSP system as you have so far.

Which folders should be backed up?

Back up all folders under <server>\RangerMSP. The most important folders are called “RangerMSP\Db” and “RangerMSP\DbSys,” which is where all RangerMSP-specific data is stored. You should also back up all your documents.

How do I restore a backup?

You can restore the RangerMSP system using the partial-backup files (database only) or the full-backup files.


To restore the full system using full-backup files:
To restore from a full backup (i.e. a backup file which includes the RangerMSP installation folder and all sub-folders), please follow these instructions. This includes restoring the files and installing any services if they were used.

RangerMSP will now be ready for use at the exact point when the backup was done.


To restore the full system using a partial-backup (database-only) files:

  1. Download and install a fresh trial version of RangerMSP. Make sure to use the exact same version as you have been using until now, otherwise there will be version mismatch when restoring the database.
  2. Install it to the original path where RangerMSP was installed on your server originally.
  3. Run the RangerMSP application once (use any user as this is a fresh setup)
  4. Close the RangerMSP session.
  5. Rename the <server>\RangerMSP\Db folder to <server>\RangerMSP\Db-Not-In-Use.
  6. Rename the <server>\RangerMSP\DbSys folder to <server>\RangerMSP\DbSys-Not-In-Use.
  7. From the backup, copy the \RangerMSP\Db and \RangerMSP\DbSys folders to <server>\RangerMSP\Db and <server>\RangerMSP\DbSys.

RangerMSP will now be ready for use at the exact point when the backup was done.


To restore from a backup only in order to revert changes in the database:
Should you need to restore a backup to revert changes, your current RangerMSP installation can still be used. You just need to replace the database files.

To restore a partial backup:

  1. Rename the <server>\RangerMSP\Db folder to Db-Not-In-Use.
  2. Rename the <server>\RangerMSP\DbSys folder to DbSys-Not-In-Use.
  3. From the backup-file, copy the Db and DbSys folders to <server>\RangerMSP\Db and <server>\RangerMSP\DbSys.

RangerMSP will now be ready for use at the exact point when the backup was done.


I've just restored RangerMSP onto a new computer, and the client gives me an error when I log in; What am I doing wrong?

Procedure halted due to data server error.
Verify server is operating and this computer has access to the server folder.
(C:\RangerMSP\DB)

When restoring RangerMSP onto a new computer from a backup archive, the next step is to verify that the path in the error message exists, and has the database files in it and test a single RangerMSP client application from the server that RangerMSP is installed on. If running the client from the server itself produces an error report like the error above, then the issue may very well be caused by not installing the RangerMSP SQL Database.

If your system is licensed for the RangerMSP SQL Database, then follow the steps in the SQL Database installation page, and then continue to the this Troubleshooter to resolve it.