imported>Jason.nicholls at 16:16, 17 July 2014

2014-07-17T16:16:46Z

← Older revision		Revision as of 16:16, 17 July 2014
Line 1:		Line 1:
	{{Note\|The instructions on this page are for versions 2.1.x of AppBoard. For versions 2.0.x of AppBoard, please see the [[~~Backup_and_Restore_2~~.0.x\|Backup and Restore 2.0.x]] page. For versions 2.2.x of AppBoard, please see the [[appboard/old/backup_and_restore\|Backup and Restore 2.2.x]] page.}}		{{DISPLAYTITLE:Backup & Restore (2.1.x)}}
			[[Category:AppBoard old]]
			{{Note\|The instructions on this page are for versions 2.1.x of AppBoard. For versions 2.0.x of AppBoard, please see the [[appboard/old/backup_and_restore_2.0.x\|Backup and Restore 2.0.x]] page. For versions 2.2.x of AppBoard, please see the [[appboard/old/backup_and_restore\|Backup and Restore 2.2.x]] page.}}

	AppBoard/enPortal provides utilities for backing up and restoring system data and configuration settings. This page details the commands and procedures for managing this aspect of the system.		AppBoard/enPortal provides utilities for backing up and restoring system data and configuration settings. This page details the commands and procedures for managing this aspect of the system.

imported>Jason.nicholls: moved Backup and Restore 2.1.x to appboard/old/backup and restore 2.1.x

2014-07-17T16:16:00Z

moved Backup and Restore 2.1.x to appboard/old/backup and restore 2.1.x

← Older revision	Revision as of 16:16, 17 July 2014
(No difference)

imported>Jason.nicholls at 10:39, 17 July 2014

2014-07-17T10:39:02Z

← Older revision		Revision as of 10:39, 17 July 2014
Line 1:		Line 1:
	{{Note\|The instructions on this page are for versions 2.1.x of AppBoard. For versions 2.0.x of AppBoard, please see the [[Backup_and_Restore_2.0.x\|Backup and Restore 2.0.x]] page. For versions 2.2.x of AppBoard, please see the [[~~Backup_and_Restore~~\|Backup and Restore 2.2.x]] page.}}		{{Note\|The instructions on this page are for versions 2.1.x of AppBoard. For versions 2.0.x of AppBoard, please see the [[Backup_and_Restore_2.0.x\|Backup and Restore 2.0.x]] page. For versions 2.2.x of AppBoard, please see the [[appboard/old/backup_and_restore\|Backup and Restore 2.2.x]] page.}}

	AppBoard/enPortal provides utilities for backing up and restoring system data and configuration settings. This page details the commands and procedures for managing this aspect of the system.		AppBoard/enPortal provides utilities for backing up and restoring system data and configuration settings. This page details the commands and procedures for managing this aspect of the system.

imported>Mike.berman: created page

2012-05-16T20:16:49Z

created page

New page

{{Note|The instructions on this page are for versions 2.1.x of AppBoard. For versions 2.0.x of AppBoard, please see the [[Backup_and_Restore_2.0.x|Backup and Restore 2.0.x]] page. For versions 2.2.x of AppBoard, please see the [[Backup_and_Restore|Backup and Restore 2.2.x]] page.}}

AppBoard/enPortal provides utilities for backing up and restoring system data and configuration settings. This page details the commands and procedures for managing this aspect of the system.

==Backup==

There are several reasons that the AppBoard/enPortal administrator may need to create a backup of the system:

* Migrating a system from development to production, or from one physical location to another
* Upgrading the system to a newer version
* Creating a regular backup to have available in case the system ceases to function properly

In order to perform a backup, it is first helpful to understand the relevant file locations and commands.

===Backup File Locations===

{| class="wikitable" border="1" style="background-color:#eeeeee;"
|+ align="bottom" style="color:#e76700;" |''Backup File Locations''
|-
! Directory
! Description
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/server/content/</tt>
| XML files representing all of the stock (original) enPortal content that was installed into the database to provide the base system definitions and content. Includes stock content for any Product Integration Modules (PIMs) that you have loaded into the system. This directory is created the first time you start the system, by copying the default installation files from <tt>/server/webapps/enportal/WEB-INF/xmlroot/server/content-autoload/</tt>
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/server/content-backup/</tt>
| The /content-backup/ directory is identical to the /content/ directory, except it also includes all of the changes you have made in the system. This directory is created when the XMLExport command is run by an administrator.
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/appboard/adapters/</tt>
| XML files representing all of the stock (original) AppBoard content that was installed into the database to provide the base system definitions and content. This directory is created the first time you start the system, by copying the default installation files from <tt>/server/webapps/enportal/WEB-INF/xmlroot/appboard/adapters-autoload/</tt>
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/appboard/adapters-backup/</tt>
| The /adapters-backup/ directory is identical to the /adapters/ directory, except it also includes all of the changes you have made in the system. This directory is created when the AppBoard Backup command is run by an administrator.
|-
| <tt>/server/webapps/enportal/WEB-INF/archive/archive-<DATE>.jar</tt>
| The backup / archive generated from the Backup page in enPortal or AppBoard.
|}

===How To Create a Backup===

Perform the following steps to create a full backup of AppBoard/enPortal:

# Navigate to '''Advanced'''->'''Backup''' (enPortal) or '''Settings'''->'''Backup/Restore''' (AppBoard Builder).
# Select '''Create'''

After completing the above commands, copy the entire AppBoard/enPortal file system to the backup server.

==Restore==

The restore process enables you to install a new version of AppBoard/enPortal and restore your previous data and configurations.

===Restore File Locations===

{| class="wikitable" border="1" style="background-color:#eeeeee;"
|+ align="bottom" style="color:#e76700;" |''Restore File Locations''
|-
! Directory
! Description
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/server/</tt>
| Files in this directory are invoked whenever the AppBoard/enPortal server is started (by the startup command). Any file in this directory that begins with "load" identifies sets of enPortal XML content to be loaded into the system database, which will be executed unless the file contains a ".disabled" or ".completed" extension. When restoring the system, you can edit these filenames to control what content will get loaded into the database.
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/server/content-backup/</tt>
| This is the full system backup directory, which will be loaded at server startup if the load file <tt>/server/webapps/enportal/WEB-INF/xmlroot/server/load_restore.txt</tt> is not disabled.
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/server/content-autoload/</tt>
| Any XML files in this directory, or any sub-directories, will be loaded into the system database the next time the server is started. The files will then be moved into <tt>/server/webapps/enportal/WEB-INF/xmlroot/server/content/</tt>.
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/appboard/</tt>
| Files in this directory are invoked whenever the AppBoard/enPortal server is started (by the startup command). Any file in this directory that begins with "load" identifies sets of AppBoard XML content to be loaded into the system database, which will be executed unless the file contains a ".disabled" or ".completed" extension. When restoring the system, you can edit these filenames to control what content will get loaded into the database.
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/appboard/adapters-backup/</tt>
| This is the AppBoard data sources and adapters backup directory, which will be loaded at server startup if the load file <tt>/server/webapps/enportal/WEB-INF/xmlroot/appboard/load_restore.txt</tt> is not disabled.
|-
| <tt>/server/webapps/enportal/WEB-INF/xmlroot/appboard/adapters-autoload/</tt>
| Any XML files in this directory, or any sub-directories, will be loaded into the system database the next time the server is started. The files will then be moved into <tt>/server/webapps/enportal/WEB-INF/xmlroot/appboard/adapters/</tt>.
|}

===Restore Commands===

{| class="wikitable" border="1" style="background-color:#eeeeee;"
|+ align="bottom" style="color:#e76700;" |''Restore Commands''
|-
! width=150 | Command
! How To Run
! Result
|-
| DBReset
| Shut down the system, then go to <tt>/server/webapps/enportal/WEB-INF/bin/</tt> and run:<br>
<tt>> portal DBreset</tt>. Enter "y" to reset the load files so the backup content will be loaded upon system startup.
| Clears all configuration data from the system database, so that the backup data can be re-loaded into the system.
|-
| FilesImport
| Go to <tt>/server/webapps/enportal/WEB-INF/bin/</tt> and run:<br>
<tt>> portal filesImport -jar <i>YourJarFileName</i></tt>
| Extracts saved configuration files from a jar file to the proper location in the current system.
|}

===How To Restore AppBoard/enPortal===

# On the previous system, run the backup command to generate the <tt>appboard-archive.jar</tt> file
# Stop AppBoard/enPortal.
# Steps needed for a new installation only:
## Install the new version of AppBoard/enPortal.
## Copy the <tt>appboard-archive.jar</tt> file to the new file system under <tt>/server/webapps/enportal/WEB-INF/bin/appboard-archive.jar</tt>
## In a console, go to <tt>/server/webapps/enportal/WEB-INF/bin/</tt> and run the following command to import the files on to the new installation:
#: <tt>> portal FilesImport -jar appboard-archive.jar</tt>
# Ensure that the file <tt>/server/webapps/enportal/WEB-INF/xmlroot/server/load_restore.txt</tt> does not have the ".disabled" extension.
# Run the DBReset command to clear out the system database (not needed for a new installation).
# Start AppBoard/enPortal

Appboard/old/backup and restore 2.1.x - Revision history

imported>Jason.nicholls at 16:16, 17 July 2014

imported>Jason.nicholls: moved Backup and Restore 2.1.x to appboard/old/backup and restore 2.1.x

imported>Jason.nicholls at 10:39, 17 July 2014

imported>Mike.berman: created page