8 Upgrade Tasks

Connect Installation Directory = /opt/connect.install/kc

Starting with Connect 10r5, there is a new mechanism for installing patches. Instead of manually copying new files to each node in a deployment, you can deploy patches from the Deployment Editor in the UI. Follow these steps to upgrade a Connect instance:

  1. Navigate to the active deployment in the deployment editor. Go to the Machines sub-tab.images/download/attachments/12720650/deployment_upgrade_overview.PNG

  2. In the Machines sub-tab, ensure that all machines are running. Then click Enable Flush. This command will checkpoint the system by forcing any storage log files on the nodes to be copied to the database.images/download/attachments/12720650/deployment_upgrade_flush.PNG

  3. Refresh this page until the flushing status changes to completed (this can take a while). Once flushing is complete you can go ahead and stop all the nodes and shutdown the UI.

  4. Navigate to your Connect Installation Directory (usually on the Connect UI node)

  5. Delete the last backup kc folder (kc.backup) and rename the current kc folder to kc.backup

  6. Unpack the patch distribution into the Connect Installation Folder

  7. Restore the following files from kc.backup to /kc/import/brickstlicense.jar /kc/install.properties, /kc/cyrpto.properties, /kc/database.properties.

  8. Run /kc/install/updatedb and kc/install/seeddb to upgrade the database schema.

  9. Deploy the new brickst.war file in WAS/

  10. Start the new Connect UI.

  11. Navigate to your active deployment in the deployment editor.

  12. Run the Install Icon on each node (little arrow pointing to right in right most column). The Install command will copy the new Connect files to the deployed nodes and update the configuration files on each node.images/download/attachments/12720650/deployment_upgrade_install.png

  13. Continue to refresh this page until the install has completed. The Connect version should display the new Connect version when completed.

  14. Once all nodes have been completed, click on the "Commands" drop down menu and select "Update Deployment"images/download/attachments/12720650/deployment_upgrade_update.PNG

  15. Follow the commands on the screen except for running prepare.bat/sh since this step is only required for a NEW deployment. images/download/attachments/12720650/deployment_upgrade_update_instructs.PNG

  16. You can now start each one of the nodes. Once the nodes have started, click Disable Flush. The system should now be fully operational.images/download/attachments/12720650/deployment_upgrade_overview.PNG

If you have multiple active deployments, you will need to perform step 2 and steps 8-10 for each active deployment.