Updating an Application

Updating an application allows you to upload a new application package for an existing application and base URL. You can also change the values of the application’s parameters during this process. Updating an application is useful, for example, when you have a version update for your application.

The flow of the process is as follows:


Updating your application in a cluster will update all the nodes in the cluster.

Hot Update Mode

When using "Hot Update" mode (the default in new installations of Zend Server), your web server will only need to be restarted if the application was formerly deployed or updated in "Cold Update" mode. Read more on "hot" and "cold" deployment update modes in the deployment settings reference page.

Important:

When updating your application, the server uses the same application details (e.g., Base URL) as previously defined. Changing these details can only be done by deploying it as a new application.

Before updating your application, you must update your application package to reflect the changes.

Instructions on how to complete a procedure

To update an application:

  1. In the UI, go to Applications | Manage Apps.
  2. From the Applications list, select, or hover over, the application you wish to update and click .
    The Update Application wizard is displayed.

  1. Drag and drop your application package (.zpk) in the Deployment Package drop-box.

    -OR-

    Click Choose Files to browse and select your application package.

    After the progress bar reaches 100%, a success notification displays.

  1. Click Next.
    The Readme dialog is displayed.

  1. If you specified a EULA in your application package, the License Agreement dialog is displayed.

  1. Mark the ‘I have read and agree to the license agreement’ checkbox and click Next.
    The Prerequisites Validation dialog is displayed.

  1. This dialog displays the parameters you specified as needing validation in your descriptor XML file. If all the parameters have been validated click Next.

Note:

If one or more of your parameters has failed to validate, open  your UI in another browser or tab, alter the configurations that need to be changed for the validation to succeed, and refresh the wizard.  

The User Parameters dialog is displayed.

  1. The parameters and values that appear in this dialog are the parameters, and their default values, which you defined in your descriptor XML file, such as usernames and passwords.
    Change any values that are different than the default, and click Next.
    The Deployment Summary dialog is displayed.

  1. The Deployment Summary dialog displays a summary of the parameters you have defined for your application. To change anything on this page, click Previous and change it on the dialog it appears. Otherwise, click Update to deploy your application.
    Your application is updated.
  2. In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart server and apply changes.
    For information on restarting in Zend Server, see Server Restart.

  1. To open your application click on your application in the Application page to expand the display, and click the Base URL link.

Important:

If your Base URL link includes '<default-server>', it must be replaced with your machine's IP address to open the link.

Note:

If the updated application includes monitoring and caching rule files, the existing application rules are overridden. If it does not, the existing application rules are retained. To clean existing rules, the new application should include empty monitoring and caching rule files.

Tip:

If this process fails, information is available about the failure in the zdd.log file. In the UI, go to Monitoring | Logs to view log file.