From version 6.0.1 on the Composite Application Infrastructure in WebSphere Portal supports backup and restore of single application instances. Unfortunately this functionality is not yet visible in the corresponding admin user interfaces. But this BLOG entry describes how you can make the corresponding buttons and panels appear and how you can use them. Just follow these steps:
1. Install PK42170 (optional)
This PK contains various backup/restore related UI enhancements (better warnings + messages, further details in the lists) and should become available for download soon. In the meantime everything also works without it.
2. Enable backup / restore in Portal
To enable the code and the corresponding UI you will have to go to the shared/app directory in your portal's installation. There is a JAR file called ai.xml.impl.service.jar which contains a file called backup.properties in the root directory of the JAR file. Remove this file from the JAR and restart portal. After the restart the backup/restore functionality should be available as shown further below.
3. Enable backup/restore for a composite application
By default backup/restore is disabled for all composite applications in the portal. To enable backup for a given application access the application from the catalog and select "Edit Application Properties" from the page's context menu and choose "Edit" (I know - you have to select edit twice - the UI will be probably improve in WP 6.1). In that panel you can click "Enable backup" now and exit with "OK".
4. Backup your application
In the application catalog you get now two additional buttons - one for backup, one for archive (=backup+delete) of your application.
Click on the backup button and in the following panel on "Create Backup". This will trigger the backup of the application to start and run in the background. You can refresh the list of available backups via the refresh button.
And after the backup is finished you can see it in the list:
5. Restore your application
If you click "Done" you get back to the list of applications and you can find yet another new button for your application to restore it. Click the restore button and you'll get to the "Restore Applications" panel where you can select one of the available backups and use it to restore the application.
After clicking the "Restore Application" button you'll get a messagebox with a warning that the restore will replace you current data:
If you choose that this is ok for you then the restore will be started in the background:
You can refresh to see whether the restore is finished:
and return to the application catalog where you can access your restored application:
In my next BLOG entries about backup and restore I will try to cover what a custom component has to do to get its data added to the backup (and to restore it again) and what happens to data accessed by value vs. data accessed by reference...