Zend Server full installation on IBM i

This section is for the first yum install of the Zend Server RPM, or for a clean install when a prior version installed with yum has been removed. To update a version that has been installed with yum, which is any version 2020 or higher, see the Updating Zend Server section. Versions prior to 2020 are Licensed Programs and are not affected by yum, so they do not need to be considered when deciding if the install is full or an update.

Before you begin

Make sure you perform the following tasks:

• Set up Open Source Package Management

• Check for updates to installed Open Source Packages

• Set up your home directory

• Set up your PATH and .profile

• Verify your PATH and .profile

Set up Open Source Package Management

Use the IBM Open Source Package Management utility to install Zend Server on IBM i platforms. This utility is part of ACS (IBM i Access Client Solutions). If this utility is already set up, you can skip to the next section. If not, perform the following setup once.

To get started with Open Source Package Management in ACS, follow the instructions on the IBM Support page:

http://www-01.ibm.com/support/docview.wss?uid=nas8N1022619

This process installs yum and several other Open Source utilities.

Check for updates to installed Open Source Packages

Check the list of currently installed Open Source Packages whether there are new updates available for the ibmi-base packages.

1. Open the IBM i Access Client Solutions Main User interface and select the option for Open Source Package Management from the left-hand Management group.

   

2. Connect to SSH with your IBM i user name and password and press OK.

   

   The list of currently installed Open Source Packages is displayed.
   

3. Click the Updates available tab.

4. Select all of the ibmi-base packages and then click the Upgrade button at the bottom of the window.

   

5. Accept the download size by press the Y key.

   

6. Wait for the process to run until the upgrades are finished and the window indicates ‘Complete!’ followed by the $ prompt, then close the window.

   

   You are returned to the Updates available tab on the Open Source Package Management window.

In some cases, there may be additional IBM i updates available after a set of upgrades is complete. Continue to upgrade all available packages until there are no IBM i updates listed anymore.

The installation of Zend Server upgrades all necessary IBM i packages as well. However, upgrading them first within OSPM speeds up your Zend Server installation.

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.

A home directory is probably already defined for the User Profile, but the directory itself may not exist.

To check if the directory already exists:

1. To learn the directory name, sign in to a PASE terminal by logging into a 5250 session with a *SECOFR class user profile, and then issuing the following command:

   Copy

   call qp2term

   This brings you into the PASE terminal.

2. Use the following command to discover your home directory name (note that '$HOME' must be ALL CAPS):

   Copy

   echo $HOME

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

   Copy

   > 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.

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

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

   Copy

   ls -al $HOME

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

   Copy

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

To create the home directory:

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

   Copy

   mkdir $HOME

2. Check again to verify the home directory exists:

   Copy

   > 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    

Install Zend Server on IBM i

The repository installer needs four utilities that may not be included in the initial set of open source packages. Enter the following command to make sure they are installed:

yum install wget tar-gnu gzip db2util

If you have had OSPM installed before installing Zend Server, check for Available Updates to the IBM i Open Source Packages now. This ensures you have the most up-to-date versions of all IBM i OSPM packages. For more information about the update utility, see Preparing for installing Zend Server on IBM i.

The repository installer configures the repository connection and proceeds to install Zend Server. Run the following command (you must be logged in with a *SECOFR class user profile). You can copy from here (both lines at once) and paste into your PASE terminal:

wget https://downloads.zend.com/zendserver/2021.4.3/ZendServer-2021.4.3-RepositoryInstaller.tar.gz -O - |
tar --no-same-owner -xzf - -C /tmp && /tmp/ZendServer-RepositoryInstaller/install_zs.sh --automatic

This command downloads the repository installer and runs the install script install_zs.sh with the --automatic option. The script configures the repository and once finished, proceeds to install Zend Server.

While the installation is running, do not enter additional commands or exit the screen. Allow the process to run until a dollar sign (or hashtag for QSECOFR) appears. This indicates the process has completed.

When the installation is completed, proceed to bootstrap/launch Zend Server.

Launching Zend Server

Once the process completes, you need to launch Zend Server. The default link is 'http://your-ip-or-dns-name:10101'. Please replace 'your-ip-or-dns-name' with the actual address of your IBM i.

Initial launching details are described at Launching Zend Server.