Upgrading from Community Surveys to HCL Leap Surveys
If your Connections deployment includes Communities Surveys (FEB 8.7), follow these instructions to upgrade to HCL Leap. This process involves uninstalling Community Surveys then installing HCL Leap.
Before you begin
If you have an existing Leap deployment, back it up using the instructions found in Upgrading Leap production environment.
Upgrade considerations and recommendations
For a new HCL Leap database:
-
It is strongly recommended that you back up the Community Surveys (FEB 8.7) database (usually named FEBDB). If possible, have a test environment with the database, so you can still access the surveys.
-
Export Community Surveys or Response data that you would like to migrate to Leap 9.3 for Connections 8.0 CR3. This must be done individually for each survey, either in each community or using the FEB Application Manager.
-
Once Connections 8.0 CR3 with Leap 9.3 is deployed, the Communities Surveys and/or Response data for each survey must be individually imported into Leap 9.3.
-
Each individual survey must be fixed up before it can be added to a Leap Form widget.
-
Each community with a Community Survey or Featured Survey widget needs to be updated to remove the old widgets and replace them with the new Leap Form and Results widgets.
For an existing Community Surveys database:
-
All Community Surveys applications will be available.
-
Any deployed or running applications must be stopped, since they must be fixed up before used with the new widgets. For instructions, refer to Updating and stopping a deployment in the HCL Leap documentation.
-
Each individual survey needs to be fixed up before it can be added to a Leap Form widget.
-
Each community with a Community Survey or Featured Survey widget needs to be updated to remove the old widgets and replace them with the new Leap Form or Results widgets.
Upgrading to Leap surveys
Perform the following procedure to replace Community Surveys with Leap for your Connections 8.0 CR3 deployment.
-
Uninstall Community Surveys:
-
Shut down the Connections server but leave the node running. In the Installation Manager (IIM), click Uninstall and select CommunitySurveys.
-
Enter your WebSphere Application Server credentials, then click Validate. If successful, there will be no message and the "Next" button will be enabled.
-
Verify that "CommunitySurveys" is selected as the package to be uninstalled, then click Uninstall.
-
Confirm that the Community Surveys application is removed. In the Enterprise Applications list, "Community Surveys" should no longer be present.
-
Check if there are any remaining FEB Mail sessions or JDBC providers or data sessions. If there are, remove them.
-
-
Manually delete the following:
-
Delete the file
ibm.nitro.integrations.connections.packaging.client-8.7.0.52.jar
fromprovision/webresources
. -
Delete the folders
/HCL/Forms/extensions
.
-
-
Sync the node and start the cluster to ensure that everything works as expected:
-
Confirm that the Survey and Featured Survey widgets were removed from both the community's Highlights page and the "Add Apps" palette.
-
Check that the widgets in the community are blank.
-
Confirm that there are no errors or references to FEB in the SystemOut.log.
-
-
Upgrade to Connections 8.0 CR3, if you have yet to do so.
-
Install Leap 9.3. For further information, refer to Installing in the HCL Leap documentation.
If you will be creating a new HCL Leap database, then you need to drop the previous database and create a new one.
-
Start the cluster and complete the Leap setup for the hostname and application dependencies.
-
Confirm that HCL Leap 9.3 is ready for use.
-
-
In the Connections Engagement Center, log in as the xccadmin to set up typeahead and the widget titles (https://<hostname>/xcc/admin):
Note: This step is also required for a fresh installation of Leap 9.3.
-
To enable typeahead, click Custom Properties and add the following key-value pairs:
-
Key: febUrl
Value: https://<servername>
Replace this febUrl value with that of your system.
-
Key: febContextRoot
Value: apps
-
-
To fix the title display for the Leap widgets, go to Language Files, then, while clicking ReInIt button, press Ctrl + Shift (or Cmd + Shift on Mac) to purge all language files.
-
-
Test the deployment by creating a Leap Survey application and adding it to a Leap Form or Results widget.
Post-upgrade tasks
-
If you created a new FEBDB, import the surveys and response data that you wish to retain and use in Leap 9.3 for Connections 8.0 CR3. For more information, refer to Migrating Community Surveys and response data to Leap Surveys.
-
If you kept an existing FEBDB, stop any deployed or running applications since they are incompatible. For instructions, refer to Updating and stopping a deployment in the HCL Leap documentation.
Parent topic: Installing HCL Leap Surveys