Setup Name Overview

Zend Server allows you to configure a unique Setup Name for your installation, whether it is a single server or a complete cluster. This will help with easy identification and orientation of a particular Zend Server installation among several installations, which also appears in the email notifications coming from the Zend Server (Notification and Audit centers - depending on Mail settings being properly configured).

Configuration

To configure the Setup Name, hover the mouse cursor over the Setup Name text, and click on the highlighted pencil icon to the right of the name. You will be directed to the Administration -> Settings page, which holds configuration for name and icon color under the "General" tab, among other directives.

Appearances in Zend Server

Let's review how the Setup Name looks in Zend Server. We are using "Demo Server" text with Orange colored icon.

Under UI Pages

The Setup Name appears in the top bar with an identifier icon, which reflects a single server or a cluster node:

Setup Name on Top Bar

Found in Email Notifications

The Setup Name also appears in Email notifications:

Setup Name within Email Notifications

Automated Configuration

To configure Zend Server Setup Name and Icon color using Web APIs (for example in automated environments setup, or configuration management system using Zend Server CLI Tools), use the directives "zend_gui.environmentName" and "zend_gui.environmentColor" with configurationStoreDirectives Web API Call.

Zend Server SDK (zs-client) examples

/usr/local/zend/bin/zs-client.sh configurationStoreDirectives \
--directives="zend_gui.environmentName=Demo_Server&zend_gui.environmentColor=#ff8040" \
--target=myTarget

The above example assumes you have already setup a --target in zs-client, using addTarget command. If you are not using a predefined targets, the longer form would be something like:

/usr/local/zend/bin/zs-client.sh configurationStoreDirectives \
--directives="zend_gui.environmentName=Demo_Server&zend_gui.environmentColor=#ff8040" \
--zsurl=http://ZEND_SERVER_HOSTNAME:10081 \
--zskey=ADMIN_WEB_API_KEY \
--zssecret=ADMIN_WEB_API_HASH
To use HTTPS calls for Web APIs, change the above zsurl to https://ZEND_SERVER_HOSTNAME:10082