Upgrading Clara

You can upgrade your Clara installation from V1.0.0.2 or above to V1.0.0.5 or above.

 

  1. To upgrade Clara to V1.0.0.5, follow the procedure at this link Installing and Configuring Clara up to V1.0.0.5  from step 1 to step 8. For step 8, follow the branch "If you are reinstalling Clara and the persistent Clara volume is still available".

To upgrade Clara to V1.0.0.6, run the following procedure:

    1. Extract the content of V1.0.0.6 tar.gz file.

    2. Export the Keycloak database of your previous installation by running the command:

      ./clara.sh --export-db

    1. Follow the procedure at this link Installing and Configuring Clara V1.0.0.6  from step 2 to step 8.

Note:

When you run the command ./clara.sh --load-project <prj> to activate and configure Clara, the installation script will add FAQs for the new version to the existing Clara's Kowledge Base, overwriting FAQs with the same ID. Existing FAQs with unique ID will be maintained.  

  1. To migrate Clara's data and user's credentials from your previous installation, run the following command:

    1. If you are upgrading from V1.0.0.2 or V1.0.0.3:

      2. cd /opt/hcl/clara

      -/clara.sh --migrate-data --import-db (this command automatically runs also the --migrate-cred command)

    2. If you are upgrading from V1.0.0.4 or V1.0.0.5:

      3. cd /opt/hcl/clara

      -/clara.sh --migrate-cred --import-db

Integrating Clara Knowledge Base

Before upgrading Clara, if you have modified the Knowledge Base of your previous installation by adding custom FAQs, you might need to export and edit them:

 

  1. From Clara Administration Console (https://<Clara_machine_IP>/botAdministrator/index.html), export the FAQs into an Excel file by clicking the Export button.

  2. Delete all the FAQs except your custom ones and save the file.

 

After the upgrade, to import an Excel file (for example ACME-KB.csv file) containing your custom FAQs, run the command:

./clara.sh --kb /opt/hcl/ACME-KB.csv