Troubleshooting: Upgrade node profiles for a cluster environment | HCL Digital Experience

Learn how to recover from a failure while upgrading the node profiles for an HCL Digital Experience cluster environment.

Each potential step in the upgrade node profiles option is included. Since the steps vary, depending on your selections, the steps are not numbered. Find the step that failed to learn more about correcting and recovering from the failure.

Manual Step: Update the ports for the deployment manager and nodes

About this task:

Since this is a manual step, any error that occurs is outside the context of the wizard.
Table 1. Appropriate actions for step: Update the ports for the deployment manager and nodesIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again You can run this step again if it fails.
Skip the step If this step was successful, you can skip it if you run the configuration process again.
Clean up step None required

Upgrade the ConfigEngine

About this task:
Table 2. Appropriate actions for step: Upgrade the ConfigEngineIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again If this step fails, you can run this step again after you clean up the issue.
Skip the step If this step was successful, you can skip it if you run the configuration process again.

If you re-create your profile for any reason, you must run this step again.
Clean up step If this step fails, review the parameters and values that you entered in the Configuration Wizard, specifically the new host name, passwords, port numbers, and the Portal server path.

If the parameter and values that you entered are correct, and the step fails again, use the wp-collector tool to gather the files that are needed to contact support for help. See Data collection and symptom analysis | HCL Digital Experience for information about using the wp-collector tool.

Update database settings

About this task:
Table 3. Appropriate actions for step: Update database settingsIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again Not applicable
Skip the step If this step was successful, you can skip it if you run the configuration process again.

If you re-create your profile for any reason, you must run this step again.
Clean up step None required

Validate the database settings

About this task:
Table 4. Appropriate actions for step: Validate the database settingsIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again If this step fails, you can run this step again after you clean up the issue.
Skip the step If this step was successful, you can skip it if you run the configuration process again.

If you re-create your profile for any reason, you must run this step again.
Clean up step Check your properties files to make sure that you have all of your parameters and values set correctly before you run the step again.

Connect to new databases

About this task:
Table 5. Appropriate actions for step: Connect to new databasesIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again If this step fails, you can run the step again.
Skip the step If this step was successful, you can skip it if you run the configuration process again.

If you re-create your profile for any reason, you must run this step again.
Clean up step None required

Manual Step: Review database schema changes

About this task:

Since this is a manual step, any error that occurs is outside the context of the wizard.
Table 6. Appropriate actions for step: Review database schema changesIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again If this step fails, you can run this step again.
Skip the step This step is optional. You can skip this step if you do not want to review the database schema changes.
Clean up step None required

Upgrade the base portal database component

About this task:
Table 7. Appropriate actions for step: Upgrade the base portal database componentIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again If this step fails, you can run this step again after you clean up the issue.
Skip the step Do not skip this step, if you are running the configuration again.
Clean up step If this step fails, delete the database, create a new copy, and run the step again.

Manual Step: Remove check pending statuses from table spaces

About this task:

Since this is a manual step, any error that occurs is outside the context of the wizard.
Table 8. Appropriate actions for step: Remove check pending statuses from table spacesIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again If this step fails, clean up the issue and start back with the Upgrade the base portal database components step, and then run this step again.
Skip the step Do not skip this step, if you are running the configuration again.
Clean up step If this step fails, delete the database, create a new copy, and run the Upgrade the portal database component step again before you rerun this step again.

Upgrade the remaining portal databases

About this task:
Table 9. Appropriate actions for step: Upgrade the remaining portal databasesIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again If this step fails, clean up the issue and start back with the Upgrade the base portal database components.
Skip the step Do not skip this step, if you are running the configuration again. You must complete the Upgrade the base portal database components and Remove check pending statuses from table spaces steps before you run this step again.
Clean up step If this step fails, delete the database, create a new copy, and rerun the Upgrade the portal database component and Remove check pending statuses from table spaces steps before you run this step again.

Upgrade the portal profile

About this task:
Table 10. Appropriate actions for step: Upgrade the portal profileIf you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again If this step fails, you must contact support.
Note: Contact support before you start the Portal server.
Skip the step Do not skip this step, if you are running the configuration again.
Clean up step Contact support.
When you run this step, the sub task that is named action-deploy-portlets-applyMIGStatic-wp.oob.full runs and completes successfully. However, the following error messages are shown. You can ignore these error messages:
  • EJPXA0161W: The web module ContactList could not be activated. Please see previous messages for reasons and possible corrective actions.
  • EJPPH0048W: The synchronization mode of all nodes in the portal cluster is not consistently set. The portlet application PA_ContactList will not be started in the Application Server. Manual synchronization is assumed for all nodes. Manually start the application after all nodes were synchronized.
  • EJPXA0067E: The following configuration data is needed to create a content-node resource: content-parentref.

Apply the latest Combined Cumulative Fix updates to your system

About this task:
Table 11. Appropriate actions for step: Apply the latest Combined Cumulative Fix updates to your system. If you must run a configuration again, the table helps you determine what actions are appropriate.
Actions Notes®
Run the step again If this step fails, you can run this step again after you clean up the issue.
Skip the step If this step was successful, you can skip it if you run the configuration process again.
Clean up step If this step fails, contact support and report the error message to get assistance on how to fix this issue before you run the step again.