Updating the ProfileUnity Management Console

The update process starts with downloading and installing software updates for the ProfileUnity Management Console from the Console, itself, if it is connected to the internet, or from the Liquidware website. After the upgrade completes, the other related software components are also upgraded. The update process is also a good time to review your license and update it if necessary. We also suggest reviewing the release notes to see if there are recent changes to existing templates. You can also use the Guided Configuration Wizard to find changes: just deploy from one of the new templates and compare it to your existing configuration to find areas in which you might want to make changes.

Preparation

The ProfileUnity Management Console update process is designed to preserve your existing database and configuration settings. However, we recommend that you make a backup copy of your database and the ProfileUnity Management Console before starting the update process in case you encounter any unforeseen interruptions and need to revert back to the original copy.

  1. Open the ProfileUnity Management Console.
  2. Hover over your username in the top right corner of the screen.
  3. In the drop-down menu that appears, click the Administration option.
  4. Scroll down to the Database section.
  5. Click the Backup Databases button to create a backup of the ProfileUnity database. When the process is finished, download the backup for safe keeping.
  6. Shut down and snapshot the ProfileUnity Management Console virtual machine.

Download the Installer from the Console

  1. Open the ProfileUnity Management Console.
  2. Hover over your username in the top right corner of the screen.
  3. In the drop-down menu that appears, click About.
  4. The About ProfileUnity screen appears, displaying the version number you are currently running. If an update is available, a special message box appears. The box displays the version number for the update along with a link to download it. Click the link to start the download.

Download the Installer from the Liquidware Website

  1. Go to the Download screen of the Liquidware website, located at:
    https://www.liquidware.com/download.
  2. Either log in to the Customer Download Portal or fill out and submit the Evaluation Download form.
  3. On the Download page that opens, select and download the ProfileUnity Installer that you need for your environment.

Running the Installer

The ProfileUnity standalone installer upgrades the ProfileUnity Management Console and downloads the updated software for the ProfileUnity FlexApp Packaging Console and the ProfileUnity Client.

Important: The ProfileUnity Management Console requires your user account to have administrative privileges on the local machine for installation.

Upgrading 6.8.5 and 6.8.6 Consoles

ProfileUnity Consoles that were installed new using 6.8.5 or later support a simple in-place upgrade process.

While logged on to the ProfileUnity Console server, browse to ProfileUnity-Net_X.X.X.exe and double-click the ProfileUnity installer to begin the upgrade process. The installer will guide you through the installation process.

If you have a cluster, repeat the process on the remaining cluster nodes. Ensure that each node completes the upgrade successfully and that the web UI is responding prior to starting the upgrade of the next node.

Upgrading Options for Versions Prior to 6.8.5

Migrating to a New Installation of ProfileUnity (recommended)

When migrating to a new install of ProfileUnity 6.8.6 R1, RabbitMQ is no longer installed, MongoDB is the latest version, and MongoDB traffic is encrypted.

  1. While logged on to the new ProfileUnity Console server, browse to ProfileUnity-Net_X.X.X.exe and double-click the ProfileUnity standalone installer to begin the upgrade. The installer will guide you through the installation process.
  2. Restore your database from backup in the Administration > Settings > Database section.
  3. Email support@liquidware.com to have your license reset so that it can be activated against the new console’s activation code.
  4. Do not deploy updated Client Settings or Configuration INI files. This step comes after the Client Tools are upgraded.

    Stop after this step for a standalone console installation, continue if you have a cluster.

  5. If you are building a cluster, you need to repeat step 1 on two more nodes. Clustering requires a 3-node minimum and always needs an odd number of nodes.
  6. Add nodes 2 and 3 to the cluster.

In-place Upgrade Option

Things to consider prior to using this method:

  • To ensure a smooth upgrade, disable IPv6 on all network interfaces on the existing ProfileUnity Console server(s) prior to beginning the upgrade(s).
  • Clusters do not need to be split apart before upgrading.
  • MongoDB will not be upgraded for improved security; however, you can choose either of the following:
    • There is an upgrader that can be run to upgrade MongoDB. If you have a standalone console, run the MongoDB upgrader after the ProfileUnity Console has been upgraded successfully.
    • If you have a cluster, after upgrading the ProfileUnity Console on each node, you will need to remove all the nodes from the cluster in the Administration > Settings > Clustering section. Once all nodes are now standalone, you can run the MongoDB upgrader. After all the standalone nodes are on the same upgraded version of MongoDB, you can add all the nodes back to the cluster.
  • MongoDB database traffic will not be encrypted.
    • If you have a single node, the database traffic does not leave the host.
    • Between cluster nodes, this traffic would not be encrypted.
  • RabbitMQ will not be removed even though RabbitMQ is no longer leveraged by ProfileUnity.
  1. While logged on to the ProfileUnity Console server, browse to ProfileUnity-Net_X.X.X.exe and double-click the ProfileUnity installer to begin the upgrade process. The installer will guide you through the installation process.
  2. If you have a cluster, repeat the process on the remaining cluster nodes. Ensure that each node completes the upgrade successfully and that the web UI is responding prior to starting the upgrade of the next node.
  3. Do not deploy updated Client Settings or Configuration INI files. This step comes after the Client Tools are upgraded.

Rip-and-Replace Upgrade Option

  1. If you have a cluster, you will need to remove all the nodes from the cluster in the Administration > Settings > Clustering section, performed on each node’s web UI. Once all nodes are standalone you may proceed.
  2. While logged on to the ProfileUnity Console server, uninstall the ProfileUnity Management Console.
  3. Uninstall RabbitMQ.
  4. Uninstall Erlang.
  5. Uninstall MongoDB, including removing the MongoDB directory from C:\Program Files.
  6. Browse to ProfileUnity-Net_X.X.X.exe and double-click the ProfileUnity installer to begin the upgrade process. The installer will guide you through the installation process.

    MongoDB will be set up with the latest version and encrypted database traffic.

  7. Restore your database backup.
  8. Email support@liquidware.com to have your license reset.
  9. Activate your license again.
  10. Choose one of the following:
    • If you have a single ProfileUnity node, you have completed all the necessary steps.
    • If you have a cluster, you will need to repeat steps 2-6 on each node.
  11. If you have a cluster, repeat the process on the remaining cluster nodes. Ensure that each node completes the upgrade successfully and that the web UI is responding prior to starting the upgrade of the next node.
  12. Do not deploy updated Client Settings or Configuration INI files. This step comes after the Client Tools are upgraded.