Creating a New Maintenance Organization from a Backup File

This help file applies to an out-of-date version of MainBoss.
The most recent version of MainBoss is MainBoss 4.2.4.
For the latest version of this help file can be found here.

< Previous section  |  Table of Contents  |  Index  |  Next section >

You should backup your maintenance organization database on a regular basis. For an explanation of how to do this, see Backups or the Installation and Administration Guide.

To create a new database using data from a backup file, you can use Create New Organization from a Backup in the Maintenance Organization window (see Your Maintenance Organization List).

Important Notes about Restoring Databases: There are two operations for restoring databases from backup:

• Restore Organization overwrites an existing database. First you select the database to be overwritten (by clicking on the entry for that database in your Maintenance Organization list), then you click on Restore Organization to specify the backup file you want to use.
  
  Typically, you would use Restore Organization if you made some sort of large-scale error that you wanted to undo (e.g. mistakenly generating and committing a large number of planned maintenance work orders).
• Create New Organization from a Backup creates a new database using data from a backup file.
  
  Typically, you would use Create New Organization from a Backup if your original database has been deleted or corrupted. You could also use this operation if you wanted to create a test database using data obtained from your production database.

In both cases, MainBoss performs the operation by submitting requests to SQL Server. You must therefore have SQL Server Administrator privileges to perform either operation.

Restore operations are run by SQL Server itself on the computer where SQL Server is running. Because SQL Server does the work, the backup file that will be used must be accessible to the login name under which SQL Server runs. Furthermore, the name of the backup file should be relative to the computer where SQL Server is running. Unless the file name explicitly begins with \\computer or a drive name (e.g. C:\), the file name will be assumed to be relative to SQL Server's home directory. (This is true even if the file name begins with a \.)

For example, suppose SQL Server is running on Computer X and you submit a restore request while working on Computer Y. MainBoss will ask you to specify the name of the backup file containing the database you want to restore. Suppose you give the name

C:\MyBackups\Monday.bak

You may think this refers to a file on Computer Y's C: drive. However, the restore operation is performed by SQL Server on Computer X; therefore, SQL Server will try to find the file on Computer X's C: drive, not Computer Y. If the directory C:\MyBackups doesn't exist on Computer X (or if SQL Server's login name doesn't have permissions to read that folder), you'll get an error message and the restore operation won't work.

For this reason, we recommend that you only submit restore requests while logged in to the computer where SQL Server is running. You should also be aware of what permissions SQL Server has and what files will actually be accessible to SQL Server's login name.

Command Format: When you click Create New Organization from a Backup, MainBoss displays a window that contains the following:

Database Server: The network location of the SQL Server through which you will access the database. For more information, see the Installation and Administration Guide.

If you click the accompanying "..." button, MainBoss displays a list of database servers that are known to your Windows system. There may be additional servers that you can use but that Windows doesn't currently know about. For more, see The Database Server List.

Database Name: The name you want SQL Server to give to the new database. This name must be different from the names of any other databases on the server. For example, you can't name every database "MainBoss". If you want to see what MainBoss databases already exist, click the "..." button at the end of the "Database Name" line. (For more, see The Database Name List.)

Organization Name: A name that you personally will use for this database. It is not necessarily the name of the database itself (although it can be). Since this is just a label for your own convenience, it can contain blanks and other characters that aren't allowed in actual database names.

Make browsers smaller by not showing details for selected record by default: If you checkmark this box, MainBoss will automatically hide the details panel when displaying tables in this database. For more, see Hiding the Details for a Selected Record. Note that you can still ask MainBoss to display the details panel for a particular table by pressing the button for displaying details.

Default MainBoss mode: The default mode in which this database should be opened. If you do not specify a mode explicitly, the database will be opened in the given mode. For more on modes, see Your Maintenance Organization List.

Restore Data: Fill in the field with the name of a SQL Server backup file containing a backup of a MainBoss database.

This field has an associated "..." button. If you are logged in to the same computer where SQL Server is running, clicking "..." opens a standard "file open" dialog to let you find the backup file you want.

If you are logged in to any other computer, the "..." button does nothing and you must type in the backup file's name by hand. The name should start with \\computer or a drive name (e.g. c:\), or else it should be relative to the SQL Server's default folder on the computer where SQL Server is running. (See above for more details on specifying the file name.)

OK: MainBoss submits a request to SQL Server asking to create the database you specified by restoring data from the backup file. You must have appropriate permissions to create this database.

Cancel: Closes the window without restoring.

Note: Instead of using Create New Organization from a Backup, you may prefer to use the standard restoration facilities within SQL Server Management Studio or Management Studio Express. For more information, see the Installation and Administration Guide.

The Backup File List: When you create a new organization from a backup file, the new organization will have the same list of backup files (in Administration | Backups) as the original database. This can lead to serious confusion if you're still using the original database.

For example, suppose you intend to use Create New Organization from a Backup to create a test database using data from a backup of your production database. This is a valid (and sometimes useful) thing to do, but it means that your new test database will have the same list of backup files as your existing production database. If you try to use Administration | Backups to backup the test database, you may well overwrite one of your production backups. For this reason, when you create a test database, we strongly recommend that you edit the names in Administration | Backups to refer to new backup files that will not be the same as your production backups.

< Previous section  |  Table of Contents  |  Index  |  Next section >