Table 2-1 Preparing for Data Migration
Task |
Details |
---|---|
Make sure that the Retain server is connected to the Internet |
|
Ensure SMTP Is Working in Retain |
|
Get the 3.5.1.1 software |
|
Decide where to run the Migration Tool |
|
Ensure Adequate Disk Space |
|
Ensure Adequate RAM |
|
If you use MySQL |
Retain 2.6.2 specified MySQL 5.1 as the supported version. Although it is assumed that you have migrated your system to a later version in the interim, be aware that Retain 3.5.1.1 requires MySQL 5.5 or later. |
Back up the Database and the Retain Server |
The database migration should run smoothly. However, best practice always dictates backing up systems before making major changes.
|
Make sure the database index is prepared |
|
Check for database fragmentation and rebuild if needed |
NOTE:MySQL fragmentation issues are fixed during the Retain upgrade. If you use MySQL, you can skip to
|
Disable Transaction Logging |
Because Transaction Logs consume a lot of disk space, leaving logging enabled during migration could cause the system to run out of space.
|
Disable Jobs |
Micro Focus recommends disabling archive jobs during the migration. Continuing to run Jobs during the migration process has been known to cause database racing conditions, which cause the migration tool to stop. Although the tool can be restarted when this happens, it is best to avoid potential issues with an interrupted migration. |
Table 2-2 Migrating the Database (SLES)
Dialog/Section |
Details |
---|---|
|
|
Choose (1-4): |
|
Run Migration Program? |
|
Run Migration [y/n]?: |
|
Run Migration [y/n]?: |
|
Press ENTER |
|
Use GUI instead of Console [y]: |
|
Please verify all settings before choosing to proceed with the migration. |
|
|
|
GWAVA Retain Migration |
|
After the first pass completes |
|
When 0 items were migrated on the last pass |
|
Re-enable Transaction Logging and Retain Jobs |
|
Table 2-3 Upgrade Retain to 3.5.1.1 (SLES
Dialog/Section |
Details |
---|---|
Retain Server Terminal Prompt |
|
Choose (1-4): |
|
Choose (1-2): |
|
Install Retain Server (y/n)? |
You are prompted for the components that apply to this server.
|
Choose (1-3): |
|
System prompt |
|
Start Retain 3.5.1.1 for the First Time |
|
Retain Database Schema |
A message displays stating that the 3.x database schema enhancements require that the database be updated.
|
Table 2-4 Preparing for Data Migration
Task |
Details |
---|---|
Ensure an Internet Connection on the Retain server |
|
Ensure SMTP Is Working in Retain |
|
Get the 3.5.1.1 software |
|
Decide where to run the Migration Tool |
|
Ensure Adequate Disk Space |
|
Ensure Adequate RAM |
|
Back up the SQL Database and the Retain Server |
The database migration should run smoothly. However, best practice always dictates backing up systems before making major changes.
|
Make sure the database index is prepared |
|
Check for database fragmentation and rebuild if needed |
NOTE:MySQL fragmentation issues are fixed during the Retain upgrade. If you use MySQL, you can skip to
|
Disable Transaction Logging |
Because Transaction Logs consume a lot of disk space, leaving logging enabled during migration could cause the system to run out of space.
|
Disable Jobs |
Micro Focus recommends disabling archive jobs during the migration. Continuing to run Jobs during the migration process has been known to cause database racing conditions, which cause the migration tool to stop. Although the tool can be restarted when this happens, it is best to avoid potential issues with an interrupted migration. |
Table 2-5 Migrating the Database (Windows)
Dialog/Section |
Details |
---|---|
|
|
Run Migration Installation Program? |
|
Run Migration [y/n]?: |
|
Run Migration [y/n]?: |
|
Press ENTER |
|
Use GUI instead of Console [y]: |
|
Please verify all settings before choosing to proceed with the migration. |
|
|
|
GWAVA Retain Migration |
|
Pass Completed dialog |
|
GWAVA Retain Migration |
|
Re-enable Transaction Logging and Retain Jobs |
|
Table 2-6 Upgrade Retain to 3.5.1.1 (Windows)
Dialog/Section |
Details |
---|---|
Retain Server Desktop |
|
Setup - Retain |
|
Upgrading from a Previous Version? |
|
Confirmation |
|
License Agreement |
|
Select Destination Location |
|
GWAVA Retain Migration |
|
Overwrite or Upgrade |
|
Java Installation |
|
Tomcat Installation |
|
Choose a Web Server |
|
AJP Port |
|
Ready to Install |
|
Information |
|
General Information |
|
Enable Tomcat and Apache |
|
Start Retain 3.5.1.1 for the First Time |
|
Retain Database Schema |
A message displays stating that the 3.x database schema enhancements require that the database be updated.
|