www.zend.com
Disclaimer
The information in this document is subject to change without notice and does
not represent a commitment on the part of Zend Technologies Inc. No part of this
manual may be reproduced or transmitted in any form or by any means,
electronic or mechanical, including photocopying, recording, or information
storage and retrieval systems, for any purpose other than in accordance with the
Zend Core End User License Agreement (EULA).
DN: ZC-IG-200108-2.5.0-008
Table of Contents
Installation................................................................................................4
Zend Core Overview ................................................................................4
System Requirements ..............................................................................4
Zend Product Integration..........................................................................4
Installing Zend Core ...................................................................................5
Unattended Installation ............................................................................5
Unattended Installation - (Linux/Unix/Mac only)........................................5
Attended Installation ...............................................................................8
Attended Installation - Linux/Unix/Mac ....................................................8
Attended Installation - Windows ........................................................... 19
Upgrading ............................................................................................ 30
Getting Started........................................................................................ 31
Zend Updater .......................................................................................... 33
Appendix A - Support Tool Information ....................................................... 40
iii
Installation
System Requirements
To be sure you have the most current details regarding Zend Core's compatibility
with platforms, PHP versions, and Zend's other products, refer to the information
available at: http://www.zend.com/en/products/core/system-requirements.
This information is regularly updated.
4
Installing Zend Core
Unattended Installation
Unattended installations allow for quick and easy installation of Zend Core with
minimal user intervention, eliminating the need for interactive dialogs. Using this
method you can quickly and easily deploy Zend Core on several servers.
The Unattended installation method automatically runs the installation with pre-
defined default settings configured in a file called core.ini.
1. Download the required Zend Core package from the Zend Core download
site (http://www.zend.com/en/products/core/downloads).
2. Copy the Zend Core installation package to the server.
3. Unpack by running the command:
tar -zxvf ZendCore-2.5.0-<for_operating_system>.tar.gz
• IBM DB2 Express-C database - (Not available for Mac). IBM DB2
9.1.2 is IBM's leading edge hybrid data server capable of supporting
both relational and pureXML storage. New features increase
performance and scalability for both XML and relational data. See
http://www-306.ibm.com/software/data/db2/express for more
information.
5
Zend Core Installation Guide
• IBM DB2 Client (Not available for Mac) - The IBM Runtime Client
Light. This improves connectivity with DB2 Universal Database
servers.
Note:
The IBM DB2 Client is dependent on the libstdc++.so.5 library. If you do not
have this library, download and install the 'compat-libstdc++-33-3.2.3-61'
package before attempting to install the IBM DB2 Client.
6
Installing Zend Core
9. Zend Core will be automatically installed with the settings defined in the
core.ini file.
If you used the 'install -n' command, a dialog will appear indicating your
installation's progress.
Note:
If your machine's time and date is not updated, a scrolling error message will
appear for a few seconds before the installation continues. This does not affect
the installation process.
The location of your Zend Core Administration Web GUI (by default located
at http://localhost:80/ZendCore).
Note:
The default Web Administration GUI password is 'password'. This can be changed
using the Zend Updater.
12. See the 'Getting Started' section for information on getting started with
Zend Core.
13. Your Zend Network User ID and Password can be configured using the
Zend Updater. See the Zend Updater section for more information.
7
Zend Core Installation Guide
Attended Installation
Attended Installation - Linux/Unix/Mac
Make sure that you have root privileges before running the installer.
Carry out the following steps to install Zend Core on Linux/Unix/Mac:
1. Download the required Zend Core package from the Zend Core download
site (http://www.zend.com/en/products/core/downloads).
2. Copy the installation package to your server.
3. Unpack by running the following command:
tar -zxvf ZendCore-2.5.0-<for_operating_system>.tar.gz
Note:
The following screenshots are applicable only if a GUI-based installation is run.
8
Installing Zend Core
10. Click Yes to Accept the terms of the agreement and continue with the
installation.
Click No if you do not accept the terms. The installation process will be
aborted.
9
Zend Core Installation Guide
11. Define the directory where the Zend Core files will be installed.
Note:
The default location for installing Zend Core is /usr/local/Zend/Core. If you
choose another path, make sure that you can write to /usr/local. This is because
the installer creates a symlink from /usr/local/Zend/Core to the install path you
use.
13. Enter a password for the Zend Core Administration Web GUI and Press OK.
10
Installing Zend Core
14. Select which components you would like to install / configure during the
Zend Core installation process. The options are:
Configure Zend Network - You will be prompted to enter your Zend
Network User ID and Password later. Only select this option if you are
registered to one of the Zend Core Support Programs. This can be done at
http://www.zend.com/en/products/core/support.
Install Oracle Client - Oracle Instant Client Libraries. These are necessary
for connecting to your Oracle Database via the oci8 and pdo_oci extensions.
(Not available for Mac). See http://www.php.net/manual/en/function.oci-
connect.php for information on using the oci_connect function to connect to
your Oracle database.
Install DB2 Express-C - (Not available for Mac). DB2 9.1.2 is IBM's
leading edge hybrid data server capable of supporting both relational and
pureXML storage. New features increase performance and scalability for
both XML and relational data. DB2 Express-C is a no-charge edition of DB2.
See http://www-306.ibm.com/software/data/db2/express for more
information.
Install IBM DB2 Client - (Not available for Mac). The IBM Runtime Client
Light. This improves connectivity with DB2 Universal Database servers.
The IBM Runtime Client Light is dependent on the libstdc++.so.5 library. If
you do not have this library, download and install the 'compat-libstdc++-
33-3.2.3-61' package before attempting to install the IBM DB2 Client.
11
Zend Core Installation Guide
Note:
You can install any of these components later using the Zend Updater.
Users that are subscribed to one of the Zend Network Support Programs
benefit from access to Zend Core's regular Updates and Security Fixes.
Note:
You will need to be subscribed to the Zend Network in order to get a User
ID and Password. You can subscribe at:
http://www.zend.com/en/products/core/support
17. Enter your Zend Network User ID and password and Click OK to continue.
18. If you want to install additional components and use a proxy server to
download files from outside of your local network, enter its URL in the
format: "host":"port".
Note:
The configured proxy server must not be one that requires authentication.
12
Installing Zend Core
20. If you entered your Zend Network ID and Password, the Zend Updater can
be set to automatically check for and install Updates daily.
21. Specify the time at which the Updater should check for daily Updates, in
the format HH:MM.
22. Click OK to continue.
Install the Zend Core bundled Apache - Install and configure the
Apache bundled with the Zend Core installation package.
Note:
Apache versions 2.0 onwards must be compiled in prefork mode.
13
Zend Core Installation Guide
24. If you want to use an existing Apache, select one of the existing detected
Apache installations (if available), or select to specify your web server's
location and enter the location of your apachectl script.
The following message will then appear (the message will vary slightly
according to your settings):
14
Installing Zend Core
15
Zend Core Installation Guide
32. Select an installation method for the PHP on the Web Server. The fastest
PHP installation method is Apache Module, however for some less common
versions Fast CGI can be used.
33. Click OK.
34. If you did not choose to install the DB2 Express-C Database at the
beginning of the installation, you are now ready to install the program.
35. If you chose to install the DB2 Express-C Database at the beginning of the
installation, a series of dialogs will appear asking you to enter DB2
information.
36. Enter the following information in the dialogs and click OK.
Following the entering of this information you will be ready to install the
program:
DB2_PROD_NAME instance user name.
16
Installing Zend Core
Note:
If your machine's time and date is not updated, a scrolling error message will
appear for a few seconds before the installation continues. Your installation will
be able to complete successfully.
39. Once all components have been downloaded and installed, you will be
prompted to select one of the following actions:
Display the installation log file - Displays the installation log file. You will
be able to select to end the installation after viewing the log file.
Note:
The installation log file is located in the directory from which the installation file
was run.
Open the Zend Updater - Opens the Zend Updater for further configuration
options. See the 'Zend Updater' section, below, for more information on
the options available through the Zend Updater.
17
Zend Core Installation Guide
40. Once installation has completed, a dialog will be displayed detailing your
installation information:
The location of your Zend Core Administration Web GUI (by default located
at http://localhost:80/ZendCore)
42. See the 'Getting Started' section for information on using Zend Core.
18
Installing Zend Core
1. Download the required Zend Core installation file from the Zend Core
download site (http://www.zend.com/en/products/core/downloads).
2. Copy the installation package to your server.
3. Double-click the .exe installation file to start the installation.
The installation wizard will open.
4. Follow the instructions until completing the installation.
5. Select Next to install Zend Core or Cancel to abort the installation process.
19
Zend Core Installation Guide
20
Installing Zend Core
The Custom setup option will add a dialog allowing you to select which
components will be installed. You will be able to alter your database
selection from the previous screen.
10. Define where the Zend Core files will be installed. The default location is
C:\Program Files\Zend\Core.
Click 'Change' to select a different location.
11. Select Next to continue.
12. If you chose the Custom installation option, you can choose which
additional components will be installed.
21
Zend Core Installation Guide
22
Installing Zend Core
DB2 Express-C - (Not available for Mac). DB2 9.1.2 is IBM's leading edge
hybrid data server capable of supporting both relational and pureXML
storage. New features increase performance and scalability for both XML
and relational data. DB2 Express-C is a no-charge edition of DB2.
See http://www-306.ibm.com/software/data/db2/express for more
information.
IBM DB Drivers (IBM DB2 Client) - (Not available for Mac). The IBM
Runtime Client Light. This improves connectivity with DB2 Universal
Database servers.
Note:
You can install any of these components after the installation process
using the Zend Updater.
Note:
Apache versions 2.0 onwards must be compiled in prefork mode.
23
Zend Core Installation Guide
18. If you select to specify Apache's location, the screen below will appear:
19. Click Browse and select the location of your existing Apache's root folder.
20. Click Next.
21. If you chose to Install the Bundled Apache, the screen below will appear:
22. Select the port number to be used by Apache. The default port is 80.
Ensure that this port is not already in use.
24
Installing Zend Core
23. Select the file extensions to associate with PHP and click Next.
24. Enter and confirm the password which will be used to access Zend Core's
Administration Web GUI.
25. Click Next to continue.
25
Zend Core Installation Guide
26. Users that are subscribed to one of the Zend Network Support Programs
benefit from access to Zend Core's regular Updates and Security Fixes.
Select whether to enter your Zend Network information and click Next to
continue.
If you are not yet subscribed to the Zend Network, this information can
subsequently be entered using the Zend Updater at any time.
Note:
You will need to be subscribed to the Zend Network in order to get a User
ID and Password. You can subscribe at:
http://www.zend.com/en/products/core/support.
27. If you chose to enter your information, enter your Zend Network User
Name and Password in the following 2 screens and click Next to continue:
26
Installing Zend Core
29. If you have direct internet access and do not need a proxy server, select
No and click Next.
If you use a proxy server to download files from outside of your local
network, select Yes and click Next to be taken to the proxy server
configuration screen.
Note:
The configured proxy server must not be one that requires authentication.
30. Enter your proxy server and port in the following screen and click Next:
27
Zend Core Installation Guide
32. Click Install to download any selected components and to install Zend Core
and all its components.
Click Back to change any of your settings.
33. A dialog will appear with a progress bar indicating the status of the
installation.
28
Installing Zend Core
39. Note the location of your Zend Core Web Administration GUI and any
additional components.
40. Click OK.
29
Zend Core Installation Guide
Upgrading
To install a newer version of Zend Core on top of an older version, start the
installation process by running the installation file. The Zend Core installation
script will identify whether a previously installed version is present. If so, a
prompt will appear asking if you want to override current settings or retain them.
30
Getting Started
Getting Started
Logging In
Once the installation process has completed, you will be ready to login to your
Zend Core Administration Web GUI.
Note:
Since the Zend Core GUI is a Web-based interface, it can be accessed from any
machine running a standard Web browser. If you wish to access it from the web-
hosting machine, make sure you have a browser which meets the system
requirements described on the Zend Core Website:
http://www.zend.com/en/products/core/system-requirements.
and click the arrows . (If you installed Zend Core using the
unattended installation method, the default password will be
"password".)
3. Your Zend Core Administration Web GUI will open.
Refer to the Zend Core User Guide for more on using Zend Core.
31
Zend Core Installation Guide
Your Zend Core login password can be changed from the Zend Updater in case it
is misplaced or needs to be changed.
The next time you login to the system, the new password will be activated.
32
Zend Updater
Zend Updater
The Zend Updater allows you to configure all aspects of your Zend Core system,
and lets you download and install Updates and additional components.
The Zend Updater allows you to carry out the following actions:
Uninstall Zend Core - Removes Zend Core and all its components from
your system. Only available in Linux/Unix/Mac.
Support Tool - Allows access to the Support Tool which gathers system
information in order to improve Zend Core Support.
33
Zend Core Installation Guide
Allows you to change your password for accessing the Zend Core Administration
Web GUI.
You must restart your web server after changing your password.
See 'Changing your GUI Password' under the 'Getting Started' topic for more
information.
The 'Update Zend Core' option provides you with easy access to Updates, Zend
Update Package Installation, Rollback management capabilities, component
deletion and Zend Network configuration.
Note:
You must be registered for a Zend Support Subscription (Silver, Gold or
Platinum) in order to have access to Updates.
For more on Zend Support Subscriptions, and to register, see the Zend Core
Support page at http://www.zend.com/en/products/core/support.
See 'Updating Online' in the 'Updating Zend Core' Chapter of the Zend Core
User Guide for more on installing Updates through the Zend Updater.
34
Zend Updater
Note:
You must be registered for a Zend Support Subscription (Silver, Gold or
Platinum) in order to have access to Updates.
For more on Zend Support Subscriptions, and to register, see the Zend Core
Support page at http://www.zend.com/en/products/core/support.
See 'Updating Offlline' in the 'Updating Zend Core' chapter of the Zend Core
User Guide for more on installing Updates through the Zend Updater.
Note:
The configured proxy server must not be one that requires authentication.
You must enter a Zend Support Network User ID and Password in order to
be able to find and install Updates using the Zend Updater.
Note:
For more on Zend Support subscriptions, and to register, see the Zend Core
Support page at http://www.zend.com/en/products/core/support.
35
Zend Core Installation Guide
Completely removes Zend Core and all its components from your system.
Only available under Linux/Unix/Mac Operating Systems.
To uninstall Zend Core on Windows, use the 'Add or Remove Programs' option in
your Control Panel.
Support Tool
The Zend Support Tool is a tool for gathering information about your system
configuration and setup. This tool allows the Zend Support Team to solve
problems in a more comprehensive and efficient way.
To create a file containing the above system information which can be sent to the
Zend Support Team, specify the destination directory where the file will be
created and click OK.
After the file is created it can be sent to Zend Support if the need for support
arises.
See Appendix A - Support Tool Information for a complete list of the information
collected by the Support Tool.
Note:
For more on Zend Support programs, and to register to the Zend Network, see
the Zend Core Support page at http://www.zend.com/en/products/core/support.
36
Zend Updater
Under Unix/Linux/Mac Operating Systems, you can choose the Web Server to be
used with Zend Core by selecting an installed Apache package.
Note:
Apache versions 2.0 onwards must be compiled in prefork mode.
37
Zend Core Installation Guide
2. Click OK to continue.
Your Apache settings will be detected and displayed.
38
Zend Updater
Allows you to install components which were not installed during the initial Zend
Core installation.
Note:
To install additional components 'offline', please contact the Zend Support team.
Install IBM RTCL / IBM DB2 Client - The IBM Runtime Client Light.
This improves connectivity with DB2 Universal Database servers.
Note:
Under Linux/Unix Operating Systems, the IBM Runtime Client Light is
dependent on the libstdc++.so.5 library. If you do not have this library,
download and install the 'compat-libstdc++-33-3.2.3-61' package before
attempting to install the IBM DB2 Client. (Not available for Mac).
39
Zend Core Installation Guide
Windows
conf.ini
FILES
fs.txt
java.version
netstat.out
phpinfo-cli.txt
phpinfo-server.txt
tasklist.out
ver.out
zend.ini
Linux/Unix/Mac
Apache_1.settings
Apache_error_1.log
Apache_httpd_1.conf
apachectl
conf.ini
FILES
java.version
40
Appendix A - Support Tool Information
lsb-release
ls-zR.out
netstat.out
nm_httpd.out
nm_php.out
objdump_httpd.out
objdump_php.out
phpinfo-cli.txt
redhat-release
tmpdir.perms
zend.ini
41