03-03-00 Configuring Zend Core for i5!OS

TOC Previous Next

Configuring Zend Core for i5/OS

This section addresses configuring the Zend Core for i5/OS environment.

Administration tools

Various tools are included with Zend Core and i5/OS that you can use to configure and administer your PHP environment.

Zend Core Setup Tool

Included in the ZENDCORE library, the Setup Tool is used to start, update, and troubleshoot the environment.

Access the Setup Tool by running the following command on the i5/OS command line:
GO ZENDCORE/ZCMENU

Figure 3-8 shows the Setup Tool.

Figure 3-8 The Zend Core for IBM i5/OS Setup Tool

The main menu of the Setup Tool contains the following options:

1. Set Zend Core Web Administration Console password
Use this option to set or change the password you use to access the browser-based Zend Core console.

2. Update via Zend Network menu
Use this option to check for updates to the product. This process requires a Zend Network user ID and password (which you created when you registered with Zend to download the product) to access the Zend Network. You can also provide this user ID and password under this option.
The Update via Zend Network menu also enables you to roll back updates.

3. Run Support Tool
The support tool gathers diagnostic data and bundles it into a GZ file. (The location of the file is displayed in a message when you run the tool.) You can then send the file to Zend Support to assist them with problem determination.

5. Service Management menu
The Service Management menu contains options for starting and stopping the Zend subsystem; starting, restarting, and stopping the Apache HTTP Server instances; and starting and stopping the i5_COMD service (which is used by the i5 Toolkit for Zend Core).

90. Signoff
This option signs off your 5250 session.

Zend Core browser-based console

Zend Core includes a PHP application that can be used to edit the PHP configuration. Changes are written to the product php.ini file. It is recommended that you use the console to configure Zend Core: Hand-editing the php.ini file can be error-prone and result in configuration problems.

To open the Zend Core console, open the following URL in a Web browser, replacing <system_name> with the host name or IP address of your i5 machine:
http://<system_name>:89/ZendCore

Note: Depending on your system's TCP/IP configuration, the console might not load if you use the fully qualified host name (host and domain) of the system in the URL. If this occurs, use the short host name in the URL.

Log in to the console with the password you specified during the installation process. Use the Zend Core Setup Tool to reset or change the password.

At the top of the page is the menu you use to navigate through the console, as shown in Figure 3-9. The top row contains tabs for the main console areas. Most items in the top row, when clicked, display a submenu in the second row that accesses pages in that particular console area.

Figure 3-9 The Zend Core console navigation menu

Refer to the product documentation for a detailed list of all console features. Briefly, here is an overview of each tab and the activities that can be performed on those pages:

Control Center
The Control Center area contains information about the product, including the system, loaded PHP modules, installed and available product updates, and how to get support. Of particular interest is the benchmark tool, which you can use to simulate hits to a particular URL and measure response performance.

Configuration
The Configuration tab enables you to change the product configuration, including core PHP modules, PHP extensions, Zend products, server directives, and the Zend Studio Server (which integrates server-side functions with the Zend Studio development tool).

Documentation
The Documentation tab provides access to the integrated product documentation for PHP, Zend Core, and PEAR. There is also a function for searching the documentation.

Many console pages contain controls for saving changes to the configuration and restarting the server. If changes you have made do not appear to take effect after you have clicked the link to restart the server, use the Zend Core Setup Tool to restart the servers or the Zend subsystem.

Click the Logout link to exit the Zend Core console.

IBM Web Administration for i5/OS

To manage your IBM HTTP Server for i5/OS instance, use the IBM Web Administration for i5/OS tool. It is a browser-based tool provided with the IBM HTTP Server for i5/OS product. The administrative application is served from the *ADMIN instance of IBM HTTP Server.

To access the tool, first start the *ADMIN instance. You can use System i Navigator or the following i5/OS command:
STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

After the *ADMIN instance is running, use a Web browser to open the following URL, where <server_name> is the host name or IP address of your i5 system:
http://<server_name>:2001/HTTPAdmin

When prompted, enter a user profile name with *IOSYSCFG authority and its associated password.

Note: If your browser uses a pop-up blocker, disable it before using the IBM Web Administration for i5/OS tool or configure it to access pop-up windows for the site. Some functions of the tool do not work correctly if pop-ups are blocked.

Figure 3-10 displays the main page of the Web Administration tool.

Figure 3-10 IBM Web Administration for i5/OS

Tabs at the top of the interface relate to various activities. Selecting certain tabs makes a row of subtabs appear below the main tabs. If you click Manage > HTTP Servers and select ZENDCORE from the Server list (as shown in Figure 3-11), you can display and change your IBM HTTP Server for i5/OS server instance.

Figure 3-11 Managing the ZENDCORE Apache server instance

You can use the Web Administration tool to create other HTTP server instances.

Tip: Because the ZENDCORE instance forwards all content to the i5/OS PASE Apache HTTP Server, we recommend that you create another server instance for your static content (HTML pages, images, and others). Use the ZENDCORE instance only for PHP files.

Additionally, you can configure the ZENDCORE instance to use secure sockets layer (SSL) or authentication.

For more information about configuring IBM HTTP Server, see IBM HTTP Server (powered by Apache): An Integrated Solution for IBM eServer iSeries Servers (SG24-6716-02).

Zend Core Configuration Samples

The following configuration pages are intended to demonstrate commonly requested Apache configurations for ZENDCORE.

03-03-01 Basic Authentication Example

TOC Previous Next