Backing Up and Restoring the Database

Transcription

1 Backing Up and Restoring the Database Any database that contains regularly updated information should be regularly backed up. A SAM backup saves a record of the entire database at a given moment. These system backups should ideally be saved onto portable media and stored off-site. NOTE: It is good practice to use third-party backup software to back up the entire SAM Server hard drive. Using third-party backup software requires stopping the ScholasticMySQL and ScholasticJBoss services for the duration of the backup. Backing Up Only a user with administrator permissions may back up the database. Use the backup utility in SAM to schedule when to perform the backup. As it is not possible to successfully back up the program while anyone is using SAM or any Scholastic program, schedule the backup for after-school hours. To back up the database: 1. Sign in to SAM as an administrator. 2. Double-click My District at the top of the SmartBar or click the Roster tab at the district level to access the My District Profile screen. 3. Click the Backup link in the Advanced Settings menu in the lower right corner of the screen to open the Backup Wizard in a separate browser window. SAM v1.9 Data Movement Manual Updated Backing Up and Restoring the Database 69

2 4. Use the pull-down menus to select the time and date to perform the backup. Use the radio buttons to schedule the backup, or to change the currently scheduled backup. Click Next to open a confirmation screen. SAM v1.9 Data Movement Manual Updated Backing Up and Restoring the Database 70

3 5. Click Back to change the schedule, or click Export to finish the scheduling. A notification will appear in the Message Center on the SAM Home Page when the backup is finished. Close the window to return to SAM, then access the backup *.zip file by clicking the Show Me link in the Message Center. By default, backups are saved to the following location: ScholasticEE\SAM_Server\jboss\server\lycea\deploy\sam-download.war SAM v1.9 Data Movement Manual Updated Backing Up and Restoring the Database 71

4 Restoring a Database Users with SAM Server v1.1 or v1.2, may restore a previously saved database using the SAM Database Restore Utility. WARNING: Restoring a database overwrites the current database. This function should only be performed by the School or District Technical Coordinator and only if the current database is lost or corrupted. Restore the SAM database using the Enterprise Edition Database Restore Utility. Download the utility from the Scholastic Education Product Support Web site. NOTE: The database backup file must have been generated in SAM Enterprise Edition 1.1 or later, and the backup may only be restored to a server running the same version of SAM. For example a SAM Enterprise Edition 1.1 database cannot be restored to a SAM Enterprise Edition 1.2 installation. To Restore a Database: 1. With the Database Restore Utility *.zip file extracted, copy the Utility called restoreeedatabase.jar to the util folder under the SAM Enterprise Edition installation directory (e.g., /ScholasticEE/SAM_Server/util). 2. If the backup was created in SAM, extract the *.zip file. In the *.zip file there is a *.sql file. Save this file to a convenient location (the same util folder where the Utility is, for instance). 3. Make a backup of the current SAM Enterprise Edition database if it may be needed later; running this Database Restore Utility permanently replaces all existing data. 4. Stop the ScholasticJBoss service before running the Database Restore Utility. Below are steps for Windows and Macintosh Operating Systems: Windows OS Open a Windows command prompt. Enter the following command: net stop ScholasticJBoss Macintosh OS Open a Terminal Window and enter the following command: sudo /sbin/systemstarter stop ScholasticJBoss SAM v1.9 Data Movement Manual Updated Backing Up and Restoring the Database 72

5 5. Run the Database Restore Utility. To run the Utility in Windows : Open a Windows command prompt. Change directories to the SAM Enterprise Edition installation directory (e.g., C:\ScholasticEE\SAM_Server). Enter the following command: java\bin\java jar util\restoreeedatabase.jar [database file path] NOTE: [database file path] is the full path to the database backup.sql file that is being restored. A warning message appears. To continue, type y and press enter. To run the Utility in Macintosh OS: Open a Terminal Window. Change directories to the SAM Enterprise Edition installation directory (e.g., /ScholasticEE/SAM_Server). Enter the following command: java jar util/restoreeedatabase.jar [database file path] NOTE: [database file path] is the full path to the database backup.sql file that is being restored. A warning message appears. To continue, type y and press enter. 6. The database is now being restored. This may take several minutes if the file is large. Once the restore is completed, restart the ScholasticJBoss service. Below are steps for Windows and Macintosh systems. Windows OS Open a Windows command prompt and enterthe following command: net start ScholasticJBoss Macintosh OS Open a Terminal Window and enter the following command: sudo /sbin/systemstarter start ScholasticJBoss SAM v1.9 Data Movement Manual Updated Backing Up and Restoring the Database 73

6 Customer Support For questions or other support needs, visit the Scholastic Education Product Support Web site at: At the site users will find program documentation, manuals, and guides, as well as Frequently Asked Questions and live chat support for users with active Product Maintenance and Support Plans. For specific questions regarding the Scholastic program suite, contact customer service to speak to a representative for each program powered by SAM at: for general questions and orders (current version through 1.7) (version 1.6 or earlier) For specific questions about using SAM with your Scholastic programs, click Help in the Quick Links along the top of any screen in SAM. SAM v1.9 Data Movement Manual Updated Customer Support 74