Changes

[[Image:Backup Restore menu.png|center]]<li>Select '''IMSMA Backup and Restore > Backup'''.</li></ol>

[[Image:fig185Backup.png|center|400px|''IMSMA Backup window'']]

<ol start="5"><li>In the IMSMA Backup window, click the [[Image:DestDir.png]] button beside next to the Destination Directory field.</li>:The Open window displays.</li><li>From the Open window:</li><ol type="a"><li>* Navigate to the directory folder to which you would like to save the backup files.</li><li>* Select a secure folder where there is enough space for the backup. * To store the backup on the same computer as the database is on, is '''not''' a secure place.* Click the '''Open''' button.</li>:The name of the directory folder displays in the Destination Directory field. </olli><li>In the '''Include in addition to IMSMA Database''' sectionof the Backup window, check the checkbox ([[Image:CheckedBoxIcon.png]]) next to each item to back up.</li>: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.</olli>

{| class="wikitable" width="500800"

| width="375pt675pt" | '''Description'''

| GIS Database || Contains all All the GIS data such as map icons symbols and their locations that appear in the map displayMap pane. It is recommended to include this in the backup so the receiver of the backup does not need to rebuild the sandbox. The file is files are located in the ''IMSMA Installation Directory''C:\IMSMAng\client\gis\sandbox\[active map]\map directory '' folder.

| Map Data || Contains all All the background geographical information (for example, rivers) files that appears in builds up the background map of the '''active''' map displaywill be backup. The file is files are located in the ''IMSMA Installation Directory''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 data entry form Data Entry Form templates that were created using the Template Designer and saved on the local computer. The file is located in the ''IMSMA Installation Directory''C:\IMSMAng\client\FormTemplates\MyTemplates '' folder. Published templates are stored in the database.

| Report Template || Contains report iReport templates that were created using the External Reporting Tool (iReport) and saved on the local computer. The templates are located in the ''IMSMA Installation Directory''C:\IMSMAng\iReport\ireport\templates '' folder.

| Translations || Contains the The ITerms_XX.properties, IMessage_XX.properties and IMessage_XXtrans_XX.properties files. The files are located in the ''IMSMA Installation Directory''C:\IMSMAng\client\resources\com\fgm\imsma\lexicon directory'' folder.

</center></li>

<ol start="8"><li>To We '''never''' recommend to exclude the attachments but if you would like to reduce the size of the IMSMA database backup filefolder, you can may select to back up the database without including certain data attached to data entry forms such as audio, video, and other large filesattachments.</li>*If you ''do not'' want to back up the attachment data, check the '''Exclude Data Entry Form Attachment data''' checkbox ([[Image:CheckedBoxIcon.png]]).*If you want to back up the attachment data, leave the '''Exclude Data Entry Form Attachment data''' checkbox unchecked ([[Image:UncheckedBoxIcon.png]]).

:A window displays prompting you for {{Note| It is possible to change the database passwordwith 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 '''OK''' button.</li>:A copy of your data is saved to the specified destination directory in a directory folder named with the current date and time ''Backup_current_date_and_time'' (e.g., Backup_{Backup_2014_10_01_17_45_15). </li>  [[Image:Backup_completed.png|center|500px|''Backup went well'']]<div align="center">''date_timeBackup went well''}). When the backup completes, a message window displays.</div>

<li>Verify the result of the backup.</li> [[Image:The message window closesBackup_result. png|center|500px|''Verify that the backup went well'']]<div align="center">''Is the expected result there?''</div>

==Errors during backup=={{Warning | If you see any error message during backup, it means that you do '''NOT''' have any backup of your database!}} [[Image:Backup_error.png|center|500px|''The backup did '''not''' went well'']]<div align="center">''The backup did '''not''' went well''</div> The most common reasons why the backup did not go well are:* the password was mistyped* there was not enough space in the specified folder* the user did not have permission to write to the specified folder In the details you will see more details on why the backup did not go well. [[Image:Backup_error_detail.png|center|500px|''The backup did '''not''' went well'']]<div align="center">''Expand the error message by clicking on Show Detail''</div> Example of another error message in the Console log: ''ava.lang.StringIndexOutOfBoundsException: String index out of range: -1'' This is an indication that something is not correct with e.g. '''[[IMSMA Client Configuration Tool | IMSMA Client variables]]''' or '''[[Environment Variables | Environment variables]]''' on the computer. {{NavBox How To BackupManage Information}}

[[Category:ELRNAA]]