Professional Documents
Culture Documents
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 for Oracle End User License Agreement (EULA).
Oracle, JD Edwards, and PeopleSoft are registered trademarks of Oracle and/or
its affiliates. Other names may be trademarks of their respective owners.
DN: ZCO-IG-210108-2.5.0-008
Table of Contents
Installation................................................................................................4
Zend Core Overview ................................................................................4
System Requirements ..............................................................................4
Zend Product Integration..........................................................................4
Installing Zend Core for Oracle.....................................................................5
Unattended Installation ............................................................................5
Unattended Installation - Linux/Unix/Solaris .............................................5
Unattended Installation - Windows ..........................................................8
Attended Installation ...............................................................................9
Attended Installation - Linux/Unix/Solaris ................................................9
Attended Installation - Windows ........................................................... 19
Upgrading ............................................................................................ 30
Getting Started........................................................................................ 31
Zend Updater .......................................................................................... 33
Appendix A - Support Tool Information ....................................................... 40
Appendix B - Windows Unattended Installation Text ...................................... 42
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 for Oracle
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 commands:
Solaris:
gunzip ZendCore-2.5.0-<for_operating_system>.tar.gz
-then-
tar xvf ZendCore-2.5.0-<for_operating_system>.tar
Linux/Unix:
tar -zxvf ZendCore-2.5.0-<for_operating_system>.tar.gz
5
Zend Core for Oracle Installation Guide
8. If you run the installation with the default settings provided in the core.ini
file, the following settings will apply:
The following components WILL be installed:
10. 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.
6
Installing Zend Core for Oracle
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.
13. See the 'Getting Started' section for information on getting started with
Zend Core.
14. 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 for Oracle Installation Guide
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 Zend Core installation file to the server.
3. Create a file called answers.ini by copy-pasting the text in Appendix B -
Windows Unattended Installation Text (see end of Installation Guide).
4. Edit the installation parameters according to your requirements.
If your run the file with the settings defined in the default answers. ini file,
the following will be applied by default:
The following components WILL be installed by default:
Note:
The MySQL Database cannot be installed using the unattended installation
process. To install it, run a manual attended installation (see below), or use
the Zend Updater to install the extra components after the initial Zend Core
installation.
8
Installing Zend Core for Oracle
6. Zend Core will be automatically installed with the settings defined in the
answers.ini file.
Dialogs will appear indicating your installation's progress.
7. See the 'Getting Started' section for information on getting started with
Zend Core
Attended Installation
Attended Installation - Linux/Unix/Solaris
Make sure that you have root privileges before running the installer.
Carry out the following steps to install Zend Core for Oracle:
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 commands:
Solaris:
gunzip ZendCore-2.5.0-<for_operating_system>.tar.gz
-then-
tar xvf ZendCore-2.5.0-<for_operating_system>.tar
Linux/Unix:
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.
9
Zend Core for Oracle Installation Guide
10. Once you have read the license agreement, click Next.
10
Installing Zend Core for Oracle
11. 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.
12. 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.
14. Enter a password for the Zend Core Administration Web GUI and Press OK.
11
Zend Core for Oracle Installation Guide
15. 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.
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.
12
Installing Zend Core for Oracle
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
18. Enter your Zend Network User ID and password and Click OK to continue.
19. 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.
13
Zend Core for Oracle Installation Guide
21. If you entered your Zend Network ID and Password, the Zend Updater can
be set to automatically check for and install Updates daily.
22. Specify the time at which the Updater should check for daily Updates, in
the format HH:MM.
23. 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.
14
Installing Zend Core for Oracle
25. 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):
15
Zend Core for Oracle Installation Guide
33. 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.
16
Installing Zend Core for Oracle
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.
37. 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 for Oracle Installation Guide
38. 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)
40. See the 'Getting Started' section for information on using Zend Core for
Oracle.
18
Installing Zend Core for Oracle
Carry out the following steps to install Zend Core for Oracle:
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 file 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 for Oracle Installation Guide
20
Installing Zend Core for Oracle
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 for Oracle.
Click 'Change' to select a different location.
11. Select Next to continue.
21
Zend Core for Oracle Installation Guide
12. If you chose the Custom installation option, you can choose which
additional components will be installed.
Zend Core - The Zend Core Administration GUI allows you to easily view
and configure your PHP environment.
Note:
You can install any of these components after the installation process
using the Zend Updater.
22
Installing Zend Core for Oracle
Note:
Apache versions 2.0 onwards must be compiled in prefork mode.
23
Zend Core for Oracle 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 for Oracle
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 for Oracle 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 for Oracle
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 for Oracle 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 for Oracle
39. Note the location of your Zend Core Web Administration GUI and any
additional components.
40. Click OK.
29
Zend Core for Oracle 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 for Oracle User Guide for more on using Zend Core.
31
Zend Core for Oracle 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
Support Tool - Allows access to the Support Tool which gathers system
information in order to improve Zend Core Support.
33
Zend Core for Oracle 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 for
Oracle User Guide for more on installing Updates through the Zend Updater.
34
Zend Updater
Zend Update Packages are files containing a set of the latest Updates
available from the Zend Update page, located at
http://www.zend.com/en/products/core/updates.
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 for
Oracle 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 for Oracle Installation Guide
Completely removes Zend Core and all its components from your system.
Only available under Linux/Unix 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 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 for Oracle 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 Oracle IC- Oracle Instant Client Libraries. These are necessary for
connecting to your Oracle Database via the oci8 and pdo_oci extensions.
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.
39
Zend Core for Oracle 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
Apache_1.settings
Apache_error_1.log
Apache_httpd_1.conf
apachectl
conf.ini
FILES
java.version
40
Appendix A - Support Tool Information
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
Appendix B - Windows Unattended
Installation Text
[general]
destination="C:\Program Files\Zend\Core for Oracle"
; Description:
; The 'destination' parameter defines Zend Core's root directory location for installation.
with-gui=1
; Description:
; The 'with-gui' parameter defines whether Zend Core's Web Administration GUI will be installed.
; Possible values:
; '0' - The Web Administration GUI will not be installed.
; '1' - The Web Administration GUI will be installed.
with-framework=1
; Description:
; The 'with-framework' parameter defines whether Zend Framework will be installed.
; Possible values:
; '0' - Zend Framework will not be installed.
; '1' - Zend Framework will be installed.
with-phpmyadmin=0
; Description:
; The 'with-phpmyadmin' parameter defines whether phpMyAdmin will be installed.
; Possible values:
; '0' - phpMyAdmin will not be installed.
; '1' - phpMyAdmin will be installed.
with-oic=1
; Description:
; The 'with-oic' parameter defines whether the Oracle Instant Client will be installed.
; Possible values:
; '0' - Oracle Instant Client will not be installed.
; '1' - Oracle Instant Client will be installed.
webserver=bundled
; Description:
; The 'webserver' parameter defines which Web Server will be used with Zend Core.
; Possible values:
; 'bundled' - The bundled Apache will be installed.
; 'apache' = The user's existing Apache server will be used.
; 'iis' = The user's existing IIS server will be used.
bundled-apache-port=80
; Description:
; If the 'bundled' option was selected in the 'webserver' parameter (above), the 'bundled-apache-port'
parameter defines the port used by the bundled Apache.
; Please note: The port number must be between 1025 and 65535.
apache-conffile=0
; Description:
; If the 'apache' option was selected in the 'webserver' parameter (above), the 'apache-conffile' parameter
defines the path to Apache's configuration file.
; Possible values:
; '0' - Use this value if the 'apache' option was NOT selected in the 'webserver' parameter (above).
; '<full_path_to_configuration_file>' - Defines the path to Apache's configuration file.
iis_website=0
; Description:
; If the 'iis' option was selected in the 'webserver' parameter (above), the 'iis_website' parameter defines
the IIS Web Server URL.
; Possible values:
; '0' - Use this value if the 'iis' option was NOT selected in the 'webserver' parameter (above).
; '<web_server's_url>' - Defines the IIS Webserver URL.
enable-extension-php=1
enable-extension-inc=1
enable-extension-php3=1
enable-extension-phtml=1
; Description:
; The 'enable-extension' parameters define the file extensions that will be associated with Zend Core.
; Possible values:
; '0' - The extension will not be associated with Zend Core.
; '1' - The extension will be associated with Zend Core.
; Please note: At least one type of file extension must be enabled.
gui-password=password
; Description:
; The 'GuiPassword' parameter defines the password for access to Zend Core's Web Adminstration GUI.
; Please note: The password should be between 4-16 characters, including the following:
; The alphanumeric characters 'a' through 'z', 'A' through 'Z' and '0' through '9' and the special characters
(-) dash, (_) underscore and (.) period
proxy=0
; Description:
; The 'proxy' parameter defines a proxy server and port used when downloading additional components.
; Only use this parameter if you require a proxy server for connecting to the internet.
; Possible values:
; '0' - A proxy server will not be used.
; '<proxy.server.port> - A proxy server will be used to download components. Enter your proxy server and port,
e.g. proxy.test.com:8080.
; zend-network-username=<username>
; Description:
; The 'zend-network-username' parameter defines the configured Zend Network User Name.
; Using your Zend Network credentials, users that are subscribed to one of the Zend Network Support Programs
can benefit from access to Zend Core's regular Updates and Security Fixes.
; You can subscribe at: http://www.zend.com/en/products/core/support
; Your Zend Network Username can be configured after installation using the Zend Updater.
; zend-network-password=<password>
; Description:
; The 'zend-network-password' parameter defines the configured Zend Network Password.
; Using your Zend Network credentials, users that are subscribed to one of the Zend Network Support Programs
can benefit from access to Zend Core's regular Updates and Security Fixes.
; You can subscribe at: http://www.zend.com/en/products/core/support
; Your Zend Network password can be configured after installation using the Zend Updater.
43