You can update a domain from the CDI-PC service page. Updates can include new features, security patches, and EBFs. Updates might be mandatory or optional. Some updates can be applied only if the domain is on a specific version or above. You can choose to initiate an update or to schedule the update to run at an appropriate time.
Domain updates are automated. After you initiate or schedule it, you don't need to perform any manual tasks such as shutting down the domain or downloading and running the installer. The CDI-PC service handles all tasks required to apply the update including shutting down the domain before and starting the domain after the update.
The domain information indicates whether an update is available for the domain. Multiple mandatory and optional updates might be available at a given point. The details include the due date by which a mandatory update must be applied. Before you initiate or schedule an update, ensure that your domain is on at least the minimum required version to apply the update.
Note: Mandatory updates must be applied by the due date. Domains that you don't update by the due date are marked obsolete.
Obsolete indicates that the domain is on an outdated version. You can't run jobs or perform tasks on an obsolete domain. You can update only the immediate previous version (n-1) of an obsolete domain. To update older versions (prior to n-1), contact Informatica Global Customer Support.
You can schedule an update to run at a date and time of your choice. For mandatory updates, the due date is the latest by which the update must be applied. You can't schedule a date beyond it. You can also manually initiate an update job and track the job progress.
Update stages
Updates include multiple stages. Each stage includes specific tasks that need to be completed successfully before the next stage begins. You can view the progress of the update from the Update Tracker. After the update is applied, the domain starts and services return to the state they were in prior to update. You can view the update history of a domain from the View Update Details page.
Note: If you deregister a domain, all update history and update plans of the domain get deleted. If you register the domain again, you can't view previous update history or plans that were created before deregistration.
The following table lists the stages that the update job includes:
Stage
Description
Prepare for update
The Domain Management Service connects to the on-premises domain, downloads installer binaries and packages for the update to the Secure Agent machine, and updates third-party binaries. The Secure Agent then downloads the files to each node in the domain. The installer files are downloaded to the following location on each node: <CDI-PC installation directory>/Informatica/platform/sys/data/downloads/<update version number>/
The installer files get extracted to the following location on each node: <CDI-PC installation directory>/Informatica/platform/sys/data/installer
Begin update
The service process connects to the on-premises domain to start the update. For multi-node domains, the domain is shut down.
Updating
Performs update tasks including domain shutdown for single node domains, backup of domain binaries, update application, and domain startup. The domain binaries are backed up to the following location: <CDI-PC installation directory>/Informatica/platform/sys/data/backup
The backup includes only the domain binaries that are modified during the update.
Clean-up
Deletes temporary files created during each stage of the update.
Finalize
The service process that performs the update is stopped.
Note: Do not edit or delete files in the following location: <CDI-PC installation directory>/Informatica/platform/sys/data
An update requires additional disk space on the node. In the preparation stage, the job verifies that the node has a minimum of 10 GB disk space available. If not available, it generates an error and the update fails.
If the update fails at any stage, check the log messages to find the cause of the failure. You can troubleshoot and then restart the update.