Date: March 10, 2003 Bulletin Number: Subject: Master & DocSTAR Database Restore Procedures Supersedes: 6012

Transcription

1 Date: March 10, 2003 Bulletin Number: 6023 Subject: Master & DocSTAR Database Restore Procedures Supersedes: 6012 The following Service Bulletin should be copied and distributed to all technicians and inserted into your service bulletin binder. Importance: Medium, Informational This Information Applies to: All DocSTAR Series 3 Systems. This includes all v3.0 & v3.1 systems. Summary: There are scenarios in which restoring the DocSTAR database to a system with a different Master database or different version of MSDE or SQL Server may arise. In these situations it is not necessary to restore the entire set of databases, including the MASTER database. Instead, the DocSTAR database alone can be restored to an otherwise fully functional MSDE/SQL Server installation. This bulletin will cover the various methods of restoring the MASTER, MODEL, MSDB, and DocSTAR databases back to either an existing DocSTAR system, an upgraded DocSTAR system, a reloaded DocSTAR system, or a new DocSTAR system. Details: Database Restore Method 1: Restores the MSDB, MODEL, and DOC STAR databases to a running MSDE/SQL Server Instance. Use this method to restore the DOCSTAR database to an existing system if the system is running but the DOCSTAR database is not functioning. 1. From the DocSTAR Administration Program, left-click the Backup/Restore button. From the Backup/Restore window left-click Restore. This will restore the last backup of the MSDB, MODEL, and DOCSTAR databases. Database Restore Method 2: Restores the DOCSTAR database to a blank MSDE/SQL Server instance. Use this method to restore the DOCSTAR database backup file (DOCSTAR.BAK) to a new system or upgrade system. You can also use this method to completely restore a non-functioning MSDE/SQL Server instance or an instance of MSDE/SQL Server that will not restore by method 1. You will have to completely uninstall MSDE/SQL Server, manually delete the C:\MSSQL7 and the \DATA folder where MASTER.MDF is located, if it is not in the C:\MSSQL7\DATA folder. You can use Windows Explorer to search for the location of MASTER.MDF. Please Note: Be sure that you have a valid backup of the DOCSTAR database (DOCSTAR.BAK) before you delete the C:\MSSQL7 folder. Otherwise, it is possible to take an existing DOCSTAR_DATA.MDF file and DOCSTAR_LOG.LDF file to restore the DocSTAR database, see Database Restore Method Once the new/re-installed instance of MSDE/SQL Server and DocSTAR are running (all databases are empty at this time), close all open programs and stop the DOCSTAR Host Service from the Administration Program. Note: Do not stop the MSDE/SQL Server Service. 2. Launch WinSQL.EXE from the C:\DOCSTAR\TECHDISK directory. Login as sa with the appropriate password (either blank or spudspud ). DocSTAR National Service Page 1 of 11 SVCBS6023

2 3. Enter the SQL Statement below to change the database context to MASTER and drop the current (empty) DOC STAR database. Press the green arrow to run the statement. USE MASTER DROP DATABASE DOCSTAR DocSTAR National Service Page 2 of 11 SVCBS6023

3 4. Enter and run the SQL Statement below to restore the DOCSTAR database from the backup media. Note: Modify the statement below to reflect the proper drive letter and most current backup file. RESTORE DATABASE DOCSTAR FROM DISK= E:\BACKUP\DOCSTAR2.BAK DocSTAR National Service Page 3 of 11 SVCBS6023

4 5. Enter and run the SQL statement below to change the database context back to DOCSTAR. USE DOCSTAR DocSTAR National Service Page 4 of 11 SVCBS6023

5 6. Enter and run the SQL statement below to correct the dsuser account. sp_change_users_login Update_one, dsuser, dsuser The following result may be displayed. The number of orphaned users fixed may also be 0 or it may not even display a number and just indicate that the command completed successfully. DocSTAR National Service Page 5 of 11 SVCBS6023

6 7. The DOCSTAR database should now be restored. Please remember to also restore the corresponding MAINIDX folder, SHARED.INI, DOCSTAR.INI, DSHOST.INI, and image files to the appropriate locations (if necessary). Note: If you are restoring to a newer version of DOCSTAR, you will have to re-run the DocSTAR setup program to make necessary adjustments to the database and INI files. Database Restore Method 3: Restores the DOCSTAR database to a blank MSDE/SQL Server instance. Use this method to restore the DOCSTAR database to a new system or upgrade system when there is not a valid backup of the DocSTAR database file (DOCSTAR.BAK) but there is a copy of the original database file (DOC STAR_DATA.MDF) and database log file (DOCSTAR_LOG.LDF). You can also use this method to completely restore a non-functioning MSDE/SQL Server instance or an instance of MSDE/SQL Server that will not restore by method 1 or 2. You will have to completely uninstall MSDE/SQL Server, manually delete the C:\MSSQL7 and the \DATA folder where MASTER.MDF is located, if it is not in the C:\MSSQL7\DATA folder. You can use Windows Explorer to search for the location of MASTER.MDF. Please Note: Be sure that you have a valid DOCSTAR database file (DOCSTAR_DATA.MDF) and a valid matching log file (DOCSTAR_LOG.LDF) before you delete the C:\MSSQL7 folder. 1. Once the new/re-installed instance of MSDE/SQL Server and DocSTAR are running (all databases are empty at this time), close all open programs and stop the DOCSTAR Host Service from the Administration Program. Note: Do not stop the MSDE/SQL Server Service. 2. Launch WinSQL.EXE from the C:\DOCSTAR\TECHDISK directory. Login as sa with the appropriate password (either blank or spudspud ). DocSTAR National Service Page 6 of 11 SVCBS6023

7 3. Enter the SQL Statement below to change the database context to MASTER and drop the current (empty) DOCSTAR database. Press the green arrow to run the statement. USE MASTER DROP DATABASE DOCSTAR DocSTAR National Service Page 7 of 11 SVCBS6023

8 4. Enter and run the SQL Statement below to restore the DOCSTAR_DATA.MDF file. Note: Be sure to place the DOCSTAR_DATA.MDF AND the DOCSTAR_LOG.LDF files in the C:\MSSQL7\DATA directory. USE MASTER CREATE DATABASE DOCSTAR ON PRIMARY (FILENAME= C:\MSSQL7\DATA\DOCSTAR_DATA.MDF ) FOR ATTACH DocSTAR National Service Page 8 of 11 SVCBS6023

9 5. Enter and run the SQL statement below to change the database context back to DOCSTAR. USE DOCSTAR DocSTAR National Service Page 9 of 11 SVCBS6023

10 6. Enter and run the SQL statement below to correct the dsuser account. sp_change_users_login Update_one, dsuser, dsuser The following result may be displayed. The number of orphaned users fixed may also be 0 or it may not even display a number and just indicate that the command completed successfully. DocSTAR National Service Page 10 of 11 SVCBS6023

11 7. The DOCSTAR database should now be restored. Please remember to also restore the corresponding MAINIDX folder, SHARED.INI, DOCSTAR.INI, DSHOST.INI, and image files to the appropriate locations (if necessary). Note: If you are restoring to a newer version of DOCSTAR, you will have to re-run the DocSTAR setup program to make necessary adjustments to the database and INI files. More Information: For additional assistance please contact DocSTAR Technical Support. DocSTAR National Service Page 11 of 11 SVCBS6023