Roadmap: Migrating a stand-alone server environment | HCL Digital Experience

Roadmaps provide a high-level overview of complex tasks such as migrating a stand-alone server environment to a new version of HCL Digital Experience.

Who should use this roadmap?

Use this roadmap if you are:

Migrating a stand-alone server environment from Version 7.0.0.x to Version 8.5.
Migrating a stand-alone server environment from Version 8.0.0.x to Version 8.5.

Note: If you are migrating from HCL Digital Experience Version 8.0.0.1 on WebSphere® Application Server Version 8.5.5.2 to HCL PortalVersion 8.5, you must follow a different migration process. For more information, see Migrating from Portal 8.0.0.1 on WebSphere Application Server 8.5.5.2.

You must apply the latest cumulative fix and one of the two most recent fix packs to your source environment, and the latest cumulative fix and the most recent fix pack to your target environment before you can migrate to HCL Portal Version 8.5. For more information, see Supported migration paths.

Planning for migration

Gather information and create a plan for migration.

Check the requirements and considerations for migration:

Documentation resources: Planning for migration
- Backup and recovery of data files and databases is an essential operation for any business system, particularly for data and applications that are running in production environments. Create and follow a plan for backing up and recovering data on all tiers of your HCL Portal deployment. For more information, see Backup and recovery.
- Remove unsupported or deprecated features before you start migration. For more information, see Deprecated features.
- If you need to migrate multiple environments, such as a production environment or development environment, you can use staging to production techniques. For more information, see Migrate multiple tier environments.

Plan a local migration if your source and target environments are on the same system, and plan for a remote migration if your source and target environments are on separate systems. For more information about local and remote migrations, see Local versus remote.

Preparing your source environment

Prepare the source portal that you want to use for migration.

Documentation resources: Preparing your source environment
- To keep the earlier portal environment in production and reduce the amount of downtime during migration copy the earlier portal server JCR and Release domains. For more information, see Using copies of source database domains to minimize downtime.

Setting up your target environment

Attention: Before you run the migration, install interim fix PI50840.

Set up your target environment for migrating to Version 8.5.

Documentation resource: Setting up your target environment
- The portal migration attempts to install custom applications in the target environment, but it does not automatically copy the files that are required for those applications. If the files are not copied over, it is possible that the applications will fail to install or not work properly. For more information about copying these files, see Copying files for third party and custom applications.
- To effectively set up your target environment, install the Portal and WebSphere® binary files on all target systems. For more information, see Installing Portal and WebSphere binary files.

Migrating to HCL PortalVersion 8.5

Start the Configuration Wizard to migrate data, applications, databases, property files, security settings, and more.

Migration for the z/OS® platform cannot be completed using the Configuration Wizard.

To get the latest updates for the wizard, apply the most recent cumulative fix. For more information about applying the latest fix pack, see the Combined Cumulative Fix strategy in this documentation.
Note: Skip this step, if you have the most recent fix pack applied.
Access the Configuration Wizard using your target environment and system host name. Go to: http://your_server:10200/hcl/wizard.
Note: If working with HCL Digital Experience 8.5 or 9 software level prior to CF18, the wizard address will be: http://your_server:10200/ibm/wizard. After installing CF18, the configuration wizard will automatically be adjusted to http://your_server:10200/hcl/wizard.
Log in to the Configuration Wizard with the administrative ID for the configuration wizard profile, cw_profile.
Select Migrate to a New Version > Migrate a Stand-alone Server.
Provide information about your environment.
Save your wizard selections.
Choose one of the following options:
- Click Download Configuration Scripts to run the steps remotely.
- Click Start Configuration to run the steps locally. This option starts to run the automated steps until a manual step is encountered.

Migration is partially complete after you do the tasks in the configuration wizard. You must return to the product documentation to complete the final steps of the migration process.

Next steps

Migration is not complete until you review the Next steps section in the product documentation. Complete the post-migration activities and enabling new functionality tasks that are applicable to your environment. Do not complete any of the enabling new functionality tasks until all post-migration activities tasks are finished.

Documentation resources: Next steps
- More tasks must be completed depending on how you customized the source portal environment and which components you used. For example, if you use a virtual portal, then complete the virtual portal post-migration activities. For more information, see Post-migration activities.
- New functionality that was not available in the earlier portal version requires extra attention after migration is complete. For more information, see Enabling new functionality.

After you complete the tasks in the Next steps section of the product documentation, migration is complete.