The DPX environment consists of several elements, each requiring periodical updates:
DPX Master Server
Core (the underlayer and the desktop interface)
Microservices (the web interface with its unique functionalities)
Infrastructure (the operating system of the machine where DPX is installed)
DPX Clients and DPX Proxies
DPX agents installed on virtual or physical machines
Storages
Third-party software of virtual or physical storages used for storing DPX backups. This software is updated using dedicated third-party tools (not covered in this section – please refer to the particular solution’s documentation).
Note. The recommended update scenario consists of two steps:
Updating the DPX Master Server using Command Line Update.
Updating DPX Clients and Proxies using the Autoupdate Method.
It is also possible to update each Client and Proxy individually by downloading dedicated .jar files, however this scenario is not recommended.
If in doubt, contact the Catalogic Software Data Protection Technical Support team.
Important. To update your DPX environment to the 4.10 version, you need to have any version of DPX 4.9 installed. Updating from previous versions requires installing certain versions in between, e.g. for version 4.8.0, you first need to update DPX Master Server to 4.8.1, then update all Clients and Proxies to 4.8.1. Only then you can proceed with updating the entire environment to any version of 4.9 (4.9.2 is recommended). From then, proceed with updating the environment to the latest 4.10 version as described herein.
Updating Catalogic DPX requires the following steps:
Note. This step updates the DPX Master Server’s Core, Microservices and Infrastructure. It does not update individual DPX Clients or Proxies.
In this method, the user copies update files to the designated directory of the DPX Master Server and invokes the software update from the shell. Follow the instructions in Command Line Update.
Warning! This step updates the DPX Clients and Proxies. If you skip Step 1, it will also update the DPX Master Server’s Core but not the Microservices or Infrastructure. This may lead to unexpected results.
Note. Autoupdate is currently only supported through the desktop interface.
This step can be performed in either of two manners: as online autoupdate or offline autoupdate.
With the Online Autoupdate method, the DPX Master Server automatically downloads the latest update package files and sends them to the Clients for automatic update. This method requires Internet access for the DPX Master Server. Follow the instructions in Online Update Method.
The Offline Autoupdate method does not require Internet access for the DPX Master Server. Instead, manually copy the update package files to the designated directory (or “repository”) on the DPX Master Server – typically by using an SCP client on your workstation. Then install and update the package files. Follow the instructions in Offline Update Method.
Note. This method updates the DPX Master Server’s Core, Microservices and Infrastructure. It does not update individual DPX Clients.
This update method is performed by using an ISO image along with the accompanying update script. Both files can be downloaded from the Catalogic MySupport website after logging in with your user credentials.
Important. Before running the DPX update script, take a full VM snapshot of the Catalogic DPX Master Server virtual appliance.
Typically, both files will follow the same naming convention, i.e. dpx-master.core-<core_version_no>.svc-<microservices_version_no>.infra-<insfrastructure_version_no> followed by _update.sh or -update.iso. In the examples below, for the sake of clarity, they have been renamed to 4-10_update.sh and 4-10-update.iso accordingly.
The procedure described below assumes the 4-10_update.sh and the 4-10-update.iso files are available from within the DPX Master Server machine, in the same location.
Log in to your DPX Master Server via SSH. The login is dpxadmin and the default password is dpxadmin. If you logged into the same Master Server in the past, you may have been forced to change the password. In such case, provide the current password, not the default one.
Use sudo su to gain root user permissions.
Change permissions to the 4-10_update.sh file:
Call the 4-10_update.sh script, specifying the 4-10-update.iso image file as argument:
The following prompt will appear:
If you have no jobs running and wish to proceed with the update process, type Yes.
The update procedure will start. This process may take a long while to complete. Some progress steps will be printed in the terminal.
Upon completion, the installer will ask if you want to reboot your master server.
Select Y to reboot the master server now or N to do it later.
This ends the updating procedure. Wait for your updated DPX Master Server to reboot, then you can resume using it.
If your DPX Master Server has Internet access, you can update it by taking the steps described below.
Launch the desktop interface (see Connect to DPX Window).
Click Help > Autoupdate DPX in the menu bar or press [Ctrl + E] to open the Autoupdate dialog.
In the Autoupdate dialog, select Check the online service for updates (default). Use this option if the Catalogic DPX Master Server has access to the Internet, and you want to install the latest update packages on the system with fewer steps.
Enter the Catalogic Software Online User ID and Password in the Authentication section. If you enter an invalid User ID or Password, you will get an information message dialog saying MySupport Authentication failed in the next step.
Attention! Always use your own customer service account of Catalogic Software. Do not reuse other credentials, such as those of your distributors, resellers, etc. Credentials, which may be cached, need to be consistent for future software updates.
Additionally, you can configure the advanced options for automatic update checking with notification emails every week, after checking the Disabled. Click to Enable field:
Administrator E-Mail Address Enter an email address for the recipient who receives the update notification message.
SMTP Host Name The host name of the SMTP server for the email notification.
SMTP Port The port number of the SMTP server for the email notification. A typical port for SMTP servers is 25.
Day of the Week Select a day of the week to receive the weekly notification email: Sunday, Monday, and so on.
Hour of the Day Specify the time of the day, based on the system clock of the Catalogic DPX Master Server.
Tip. The time zone (TZ) depends on the system clock of the DPX Master Server. Typically, you can check the system time zone using the timedatectl command for the Linux shell or the Get-TimeZone command for Microsoft PowerShell.
Software Site URL Enter a valid URL for updating the DPX Master Server. Use the following default string unless otherwise instructed by the Catalogic Software specialists:
Click OK. You can see the progress bar and the number of available update packages. As the node scanning process continues through the following steps, progress is indicated with a message at the bottom of the Autoupdate dialog. Any nodes in the Enterprise that the software update system fails to successfully check because of connectivity issues are reported. This step could take a while as it performs a sequential scan of the backup Enterprise.
The Catalogic DPX Master Server automatically tests if it can update all nodes in its Enterprise. If the test succeeds, you will see another Autoupdate dialog.
Tip. If the update test fails, the Node Scanning Failure dialog will be displayed with a list of all nodes of the DPX Master Server that cannot be updated. In the dialog, see a test result for each failed item. Click Quit to cancel the update, and fix these issues.
In the Autoupdate dialog, you can see a list of all available software update packages and a list of applicable nodes, including the DPX Master Server, with checkboxes. By default, all nodes are selected to update. You can clear any checkboxes to skip updating the systems. Click Update Now and follow the instructions in the dialog. The top pane lists software update packages found for the Enterprise. The name of the update is listed as well as the level of the update. The bottom pane lists nodes to be updated with the various software update packages selected in the top pane. By default, all packages and nodes are selected for update, indicated by check marks. Select All Updates and Select All Nodes are also initially selected. For initial deployment, accept these defaults.
Note. The reboot behavior of the updated nodes is shown in the Reboot column on the right side of the bottom pane. When reboot is set to Yes, the node automatically reboots after all updates are applied. If you do not want the automatic node reboot, select No, but ensure you manually reboot the node before you attempt a backup.
Click the Update Now button at the bottom of the dialog box. You will receive several informational messages:
Click Continue or OK.
The next window will display the progress of the software package updates. On the node selected for update, the software update package is placed in the \updates\packages directory in the installation directory.
Important. Clicking Abort at the left of the progress bar cancels installations that have not yet been performed but does not roll back those installations that have already occurred.
Do not click Abort to stop updating the selected nodes unless absolutely necessary or instructed by Catalogic specialists.
After the Abort button changes to Done, click it.
Follow the instructions in the dialog. You will be prompted to reboot some nodes, including the DPX Master Server.
Important. After the autoupdate process, all updated client nodes require reboot before any backup or restore operations are performed.
If your DPX Master Server has limited Internet access, you have to store the update package files in the repository directory in it and invoke the autoupdate. Take the following steps so that the autoupdate can load and install the update package files from the repository directory.
Note. Autoupdate is currently supported only through the desktop interface.
From your web browser, sign in to the .
Go to the product page for Catalogic DPX 4.10. See the section and the table DPX Core Updates. Download the Java archive (JAR) file for the Master Server and for all operating system types within your enterprise where DPX Clients are installed. This information can be found in the Nodes Info.
Tip. You will apply the update files to every node in your backup Enterprise.
On your DPX Master Server, locate the repository directory:
<product directory>/updates/packages/
For Catalogic DPX for Microsoft Windows, replace the slashes (/) with backslashes (\).
Copy the JAR file to the repository directory in the system to update.
Attention! Do not rename the .JAR file.
Launch the desktop interface (see ).
Click Help > Autoupdate DPX in the menu bar or press [Ctrl + E] to open the Autoupdate dialog.
In the Autoupdate dialog, select Check for updates using already downloaded patches. Use this option if your DPX Master Server has limited access to the Internet, and you want to manually download and copy the update package files in the repository directory.
Click OK without entering the User ID or password, and follow the instructions so that you can install the software update packages in the repository directory. There is a known issue (in DPX 4.8 only) that the password field does nothing (DPXN-5104).
Attention! Always use your own customer service account of Catalogic Software. Do not reuse other credentials, such as those of your distributors, resellers, etc. Credentials, which may be cached, need to be consistent for future software updates.
Additionally, you can configure the advanced options for automatic update checking with notification emails every week, after checking the Disabled. Click to Enable field:
Administrator E-Mail Address Enter an email address for the recipient who receives the update notification message.
SMTP Host Name The host name of the SMTP server for the email notification.
SMTP Port The port number of the SMTP server for the email notification. A typical port for SMTP servers is 25.
Day of the Week Select a day of the week to receive the weekly notification email: Sunday, Monday, and so on.
Hour of the Day Specify the time of the day, based on the system clock of the Catalogic DPX Master Server.
Tip. The time zone (TZ) depends on the system clock of the DPX Master Server. Typically, you can check the system time zone by using the timedatectl command for the Linux shell or the Get-TimeZone command for Microsoft PowerShell.
Software Site URL Enter a valid URL for updating the Catalogic DPX Master Server. Use the following default string unless otherwise instructed by the Catalogic Software specialists:
Click OK. You can see the progress bar and the number of available update packages. As the node scanning process continues through the following steps, progress is indicated with a message at the bottom of the Authentication dialog. Any nodes in the Enterprise that the software update system fails to successfully check because of connectivity issues are reported. This step could take a while as it performs a sequential scan of the backup Enterprise. The Catalogic DPX Master Server automatically tests if it can update itself and all nodes in its Enterprises. If the test succeeds, you will see the Update dialog.
Tip. If the update test fails, the Node Scanning Failure dialog will be displayed with a list of all nodes of the DPX Master Server that cannot be updated. In the dialog, see a test result for each failed item. Click Quit to cancel the update, and fix these issues.
In the Update dialog, you can see a list of all available software update packages and a list of applicable nodes, including the Catalogic DPX Master Server, with checkboxes. By default, all nodes are selected to update. You can clear any checkboxes to skip updating the systems. Click Update Now and follow the instructions in the dialog. The top pane lists those software update packages found for the Enterprise. The name of the update is listed as well as the level of the update. The bottom pane lists nodes updated with the various software update packages selected in the top pane. Initially, all packages and nodes are selected for update, indicated by check marks. Select All Updates and Select All Nodes are also initially selected. For initial deployment, accept these defaults. Note the reboot settings in the Reboot column on the right side of the bottom pane. When reboot is set to Yes, the node automatically reboots after all updates are applied. If you do not want the automatic node reboot, select No, but ensure you manually reboot the node before you attempt a backup.
Click the Update Now button at the bottom of the dialog box. You may receive several informational messages.
Click Continue or OK.
The next window will display the progress of the software package updates. On the node selected for update, the software update package is placed in the \updates\packages directory in the installation directory. Clicking Abort, at the left of the progress bar, cancels installations that have not yet been performed but does not roll back those installations that have already occurred.
After the Abort button changes to Done, click it.
Important. While updating the selected nodes, do not click Abort to stop updating the selected nodes unless absolutely necessary or instructed by the Catalogic specialists.
Follow the instructions in the dialog. You will be prompted to reboot some nodes, including the DPX Master Server.
Note. The autoupdate applies to all nodes in the DPX Master Server’s Enterprises. The update and system restart operations for the DPX Master Server take place at the end, after updating all other nodes.
