Update 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 Consoles and Higher

Standalone ProfileUnity Consoles that were installed new using 6.8.5 or higher (newer versions) support a simple in-place upgrade process.

Note: MongoDB is not automatically upgraded and must be upgraded after ProfileUnity Console. The MongoDB Upgrade tool can be downloaded from https://cdn.liquidware.com/6.8.7/ProfileUnity.Mongo.Setup_6.8.7r2GA2.exe.


  1. Ensure you have taken a new snapshot or database backup as outlined in the Preparation section above.
  2. 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 upgrade process.
  3. Once the ProfileUnity upgrade has finished, upgrade to MongoDB 7.0 by browsing to the ProfileUnity.Mongo.Setup_X.X.X.exe and double-clicking the MongoDB Upgrade tool to begin the upgrade.

  4. Note: Do not deploy updated Client Settings or Configuration INI files. You will update both INI files later after the Client Tools are upgraded.


ProfileUnity Clusters require an extra step of removing all nodes from the cluster before proceeding with an in-place upgrade.

  1. Ensure you have taken a new snapshot or database backup as outlined in the Preparation section above.
  2. From the Administration > Settings > Clustering section, remove all nodes from your cluster using the Remove Node function. The Remove Node function is identified by the broken chain link button on each of the cluster node rows.
  3. While logged onto the first node, browse to the ProfileUnity-Net_X.X.X.exe and double-click the ProfileUnity installer to begin the upgrade process. The installer will guide you through the upgrade process.
  4. Once the ProfileUnity upgrade has finished, upgrade to MongoDB 7.0 by browsing to the ProfileUnity.Mongo.Setup_X.X.X.exe and double-clicking the MongoDB Upgrade tool to begin the upgrade.
  5. Repeat this process for each of the remaining cluster nodes. Ensure that each node completes both upgrades successfully and that the web UI is responding prior to starting the upgrade of the next node.

  6. Note: Do not deploy updated Client Settings or Configuration INI files. You will update both INI files later after the Client Tools are upgraded.

  7. Note: After all the nodes are on the same upgraded version of MongoDB, you can add all the nodes back to the cluster. On your primary node, from the Administration > Settings > Clustering section, add the nodes back to the cluster using the Add Node link.

Upgrading Options for Versions Prior to 6.8.5

Migrating to a New Installation of ProfileUnity (recommended)

When migrating to a new installation of ProfileUnity 6.8.7, 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 installation. 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. Note: Do not deploy updated Client Settings or Configuration INI files. You will update both INI files later after the Client Tools are upgraded.

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


  6. If you are building a cluster, repeat only step 1 on at least two more nodes.

  7. Note: Clustering requires 3, 5, or 7 nodes.


  8. Add the new nodes to the new 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 MUST be split apart BEFORE upgrading the ProfileUnity Console.
  • MongoDB will not be upgraded, you must upgrade it after upgrading the ProfileUnity Console.
  • 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.
  • Follow the same in-place upgrade steps outlined in Upgrading 6.8.5 Console and Higher above.

  • Note: Do not deploy updated Client Settings or Configuration INI files. You will update both INI files later 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. 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. Open an elevated cmd.exe prompt and execute: sc delete MongoDB.
  7. 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.

  8. Restore your database backup.
  9. Email support@liquidware.com to have your license reset.
  10. Activate your license again.
  11. 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 through 7 on each node.
  12. 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.

  13. Note: Do not deploy updated Client Settings or Configuration INI files. You will update both INI files later after the Client Tools are upgraded.