Preparing for installing Zend Server on IBM i

This section covers topics you need to perform before installing Zend Server on IBM i.

Set up Open Source Package Management

We recommend customers use the IBM Open Source Package Management utility to install Zend Server. This is a feature of ACS (IBM i Access Client Solutions). If this utility is already set up, you can skip to the next section. If not, you need do this setup once.

To get started with Open Source Package Management in ACS, please follow the instructions at this link:

This installs yum and several other Open Source utilities.

Set up your home directory

If your HOME directory is not already set up, you need to do this setup once. If it is already set up, you can skip to the next section.

In this example, we assume your HOME directory has never been set up. We also assume you want to use yum and other utilities installed with IBM Open Source Package Management.

Note Please perform these steps with a *SECOFR class user profile. The installation process requires a *SECOFR class user profile to execute.

A home directory is probably already defined for the User Profile, but the directory itself may not exist. To learn the directory name, sign in to a PASE terminal. You can do this by logging into a 5250 session with a *SECOFR class user profile, and then issuing this command:

call qp2term

This brings you into the PASE terminal. Use the following command to discover your home directory name (note that '$HOME' must be ALL CAPS):

echo $HOME

The home directory output should look like this (USERNAME will be your actual user profile):

> echo $HOME /home/USERNAME $

If you need to run a previous command again, you can use F9 for command history, just like on a regular 5250 command line.

Please replace ‘USERNAME’ with your actual User Profile name in all of the following commands:

In the PASE terminal, check to see if your home directory exists:

ls -al $HOME

If the home directory doesn’t exist, you will see a message similar to this:

> ls -al $HOME ls: 0653-341 The file /home/USERNAME does not exist. $

If the home directory doesn’t exist, use the mkdir command to create it:

mkdir $HOME

Check again to verify it exists:

> ls -al $HOME total 32 drwxrwsrwx 2 username 0 8192 Sep 22 11:07 . drwxrwsrwx 4 qsys 0 8192 Sep 22 11:07 .. $

Set up your PATH and .profile

PASE needs to know where to find yum and other open source commands. To avoid having to adjust your PATH environment variable every time you log in to PASE, create a file named .profile in your HOME directory. If you already have .profile in your HOME directory, please check its contents against the PATH settings in this section.

If the .profile file does not exist in your HOME, or you just created your HOME directory, you can use the echo command with a redirect to create the .profile file and add the appropriate PATH environment variable. This way you can use yum and other commands installed with Open Source Package Management without always having to type in the environment PATH after entering the PASE terminal.

You can copy and paste the following command into your PASE terminal:

echo "PATH=/QOpenSys/pkgs/bin:\$PATH\nexport PATH" > $HOME/.profile

Use the cat command to display the contents of your new .profile file and the ls command to see it in the HOME directory:

> cat $HOME/.profile PATH=/QOpenSys/pkgs/bin:$PATH export PATH $ > ls -al $HOME total 48 drwxrwsrwx 2 username 0 8192 Sep 22 11:09 . drwxrwsrwx 4 qsys 0 8192 Sep 22 11:07 .. -rw-rw-rw- 1 username 0 42 Sep 22 11:09 .profile $

Verify your PATH and .profile

Before exiting the terminal, check to see if the yum command is found by entering the following command:

> yum /QOpenSys/usr/bin/-sh: yum: not found. $

This is expected. The yum command is not found because the PATH has not been set in the current terminal to find it. (This may not be true if yum has already been added to the default path for PASE.)

End your PASE terminal/session by using F3 to exit.

Return to the PASE terminal. From the 5250 command line:

call qp2term

Use this command to verify the path now includes /QOpenSys/pkgs/bin:

> echo $PATH /QOpenSys/pkgs/bin:/QOpenSys/usr/bin:/usr/ccs/bin:/QOpenSys/usr/bin/X11:/usr/sbin:.:/usr/bin

Now yum (and other utilities installed with Open Source Package Management) should be found (depending on the version installed, your output will differ somewhat):

> yum version Installed: 7.3/ppc 88:5eb7293211feb319892a5b0493be225bb8ced7c4 Group-Installed: yum 4:0c4b1b4f02cddd0a8cc88ffd4e7aa3919f8cda3a