Deploying an application is the process of copying, configuring and
enabling a specific application to a specific base URL on Zend Server or on a cluster. Once the deployment process has finished, the application becomes
publicly accessible on the base URL. The server carries out this two step
process by first staging the application, and then activating it after
successful staging.
The flow of the process is as follows:
Video
To better understand the procedures described in this topic, watch
this video:
Before deploying an application, you must have the complete application
package ready.
Deploying an application in a cluster, will deploy the application on all cluster nodes.
Important!
Before deploying, ensure the size of your application package does not exceed the values set for the 'post_max_size' and 'upload_max_filesize' directives in the 'C:\Program Files\Zend\ZendServer\etc\php.ini' (Windows and IBMi) or '<zend>/gui/lighttpd/etc/php-fcgi.ini' (Linux and Mac OS X) files. The default settings for these directives is 512MB.
Note:
The deployment feature is only available for Zend Server running on Apache or nginx Web servers.
To deploy an application:
In the UI, go to Applications | Apps.
In the Action bar, click . The Deploy Application wizard displays.
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.
Click Next. The Application Details dialog displays.
Enter a display name, virtual host and path. The values
for the virtual host and the path will make up your base URL.
The dialog includes the following:
Display Name - The name that Zend Server
will display for this application.
Virtual Host - This field automatically displays the default server that is defined on the Administration | Settings page. If you have not yet defined a default server, the default virtual host
on your server will be used. You can also add a new virtual host by clicking
Add New.
Path - The second part of your
base URL, which can only be a directory. As you type, Zend Server offers path suggestions, and updates the URL below. Specifying a
file will cause the application to deploy with errors.
Leaving this field empty will deploy the application on
the virtual host's root.
When finished, click Next.
Note:
The base URL (or root URL) is the URL where
the application is available after it has been deployed. The base
URL is unique and cannot be shared between two applications, and
each application is required to have a base URL. Using a pseudo
URL is also acceptable.
If you specified a EULA in your application package, the License Agreement dialog displays.
Mark the ‘I have read and agree to the license
agreement’ checkbox and click Next.
The Prerequisites Validation dialog displays.
This dialog displays the parameters you specified as needing
validation in your descriptor XML file. If your system does not qualify, an error message is displayed at the top of the dialog and the prerequisites in question appear in red. Click the link to open Zend Server in another tab in your browser, and then click after amending the specific dependencies. 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 displays.
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 opens.
The Deployment Summary dialog displays the details of the application to be deployed and a summary of the parameters
you have defined for the application. To change anything
on this page, click
and change it on the dialog it appears. Otherwise, click to deploy your application. Your application is deployed and added to the Applications list on the Applications | Apps page.
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.
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.
Tip:
If this process fails, information is available about
the failure in the zdd.log file. In the UI, go to Overview | Logs to view log file.
Location of Your Deployed Application and Relevant Configuration Files