Changes

{{noteNote | If you are running IMSMA in Because the geodatabase is built on a networked environmentper client basis, it is also recommended to launch the following procedures should be performed client on the IMSMA serverto fully update the geodatabase prior to backing it up. }}

1. <ol><li>Before beginning the backup process, verify that the IMSMA {{IMSMANG}} server and all IMSMA clients have been shut downstopped. </li>2. <li>If the IMSMA Control Centre icon is not already displayed in the lower, right corner of your Window’s desktop, double-click the IMSMA Tray Launcher icon on your computer’s desktop. </li>3. <li>Right-click the IMSMA Control Centre icon that is displayed in the lower, right corner of your Window’s desktop.</li>4. Select the IMSMA [[Image:Backup and Restore optionmenu.png|center]]5. <li>Select the Start '''Backup option.The IMSMA Backup window displays. Figure 185. IMSMA Backup window6. Click the button beside the Destination Directory field.The Open window displays.7. From the Open window:a. Navigate to the directory to which you would like to save the backup files. b. Click the Open button'''.The name of the directory displays in the Destination Directory field. 8. In the Include in addition to IMSMA Database section, check the checkbox ( ) next to each item to back up.If you do not check any items, only the IMSMA database will be backed up. See Table 53 on page 247 for a description of the type of information that is backed up with each file.Table 53. Backup File Descriptions</li>

[[Image:Backup.png|center|400px|''IMSMA Backup Filewindow'']]<div align="center"> Description''IMSMA Backup window''GIS Database Contains all the GIS data such as map icons and their locations that appear in the map display. The file is located in the IMSMA_HOME\client\gis\sandbox\[active map]\map directory folder. </div>

Map Data Contains all <li>In the background geographical information (IMSMA Backup window, click the [[Image:DestDir.png]] button next to the Destination Directory field. The Open window displays.</li><li>From the Open window:* Navigate to the folder to which you would like to save the backup files.* Select a secure folder where there is enough space for examplethe backup. * To store the backup on the same computer as the database is on, rivers) that appears is '''not''' a secure place.* Click the ''Open'' button. The name of the folder displays in the map displayDestination Directory field. The file is located </li><li>In the ''Include in addition to IMSMA Database'' section of the Backup window, check the IMSMA_HOME\server\gis\maps\checkbox ([active map[Image:CheckedBoxIcon.png] folder]) next to each item to back up. If you do not check any items, only the IMSMA database and the attachments will be backed up. See the following table for a description of the type of information that is backed up with each file.</li>

<center>{| class="wikitable" width="800"|-| align="center" colspan="2" | '''Backup File Descriptions'''|-| width="125pt" | '''Backup File'''| width="675pt" | '''Description'''|-| GIS Database || All the GIS data such as map symbols and their locations that appear in the Map pane. It is recommended to include this in the backup so the receiver of the backup does not need to rebuild the sandbox. The files are located in the ''C:\IMSMAng\client\gis\sandbox\[active map]\map'' folder. |-| Map Data || All the files that builds up the background map of the '''active''' map display will be backup. The files are located in the ''C:\IMSMAng\server\gis\maps\[active map]'' folder. If there is sub-theme assignments also ''C:\IMSMAng\client\conf\UserPrefs.prop''s will be included.|-| Form Template Contains unpublished field report || Data Entry Form templates that were created using saved in the Form Designer and ''C:\IMSMAng\client\FormTemplates\MyTemplates'' folder. Published templates are stored in the database.|-| Report Template || iReport templates that were saved on in the local computer''C:\IMSMAng\iReport\ireport\templates'' folder. |-| Translations || The file is ITerms_XX.properties, IMessage_XX.properties and trans_XX.properties files. The files are located in the IMSMA_HOME''C:\IMSMAng\client\FormTemplatesresources\com\fgm\imsma\MyTemplates lexicon'' folder.|}</center></li>

Report Template Contains unpublished report templates that were created using <li>We '''never''' recommend to exclude the External Reporting Tool (iReport) and saved on attachments but if you would like to reduce the size of the backup folder, you may select to back up the database without including attachments.</li><li>Click the '''Backup''' button.</li>{{Note| It is possible to change the database password with SQL software.}}<li>Enter the database password.</li><br />[[Image:Imsma pwd.png|center|300px|''Enter the password'']]<div align="center">''Enter the password''</div><li>Click the local computer'''OK''' button. The file A copy of your data is located saved to the specified destination directory in the IMSMA_HOME\iReport\IMSMA Reports a foldernamed with ''Backup_current_date_and_time'' (e.g. Backup_2014_10_01_17_45_15).</li>

9[[Image:Backup_result. To reduce png|center|500px|''Verify that the size of backup went well'']]<div align="center">''Is the IMSMA database expected result there?''</div></ol> ==Errors during backup=={{Warning | If you see any error message during backup file, it means that you can select to back up the do '''NOT''' have any backup of your database without including certain data attached to field reports such as audio, video, and other large files!}} [[Image:Backup_error.png|center|500px|''The backup did '''not''' went well'']]<div align="center">• If you do ''The backup did '''not want to back up the attachment data, check the Exclude Field Report Attachment data checkbox ( ).''' went well''</div>• If you want to back up the attachment data, leave the Exclude Field Report Attachment data checkbox unchecked ( ).10. Click The most common reasons why the Backup button.backup did not go well are:A window displays prompting you for * the database password.was mistyped11. Enter * there was not enough space in the database password.specified folder12. Click * the OK button. A copy of your data is saved user did not have permission to write to the specified destination directory in a directory named with folder In the current date and time. When details you will see more details on why the backup completes, a message window displaysdid not go well.13[[Image:Backup_error_detail. Click png|center|500px|''The backup did '''not''' went well'']]<div align="center">''Expand the OK button. error message by clicking on Show Detail''</div> The Example of another error message window closesin the Console log: ''ava. lang.StringIndexOutOfBoundsException: String index out of range: -1''14This is an indication that something is not correct with e. Close g. '''[[IMSMA Client Configuration Tool | IMSMA Client variables]]''' or '''[[Environment Variables | Environment variables]]''' on the IMSMA Backup / Restore windowcomputer. {{NavBox Manage Information}} [[Category:NAA]]