IBM i now has a robust open source environment that allows us to build and run many packages that used to be limited to Linux systems. These instructions will guide you through setting up the environment and important tools on your IBM i.

What releases and PTFs are required

Your system must be running IBM i 7.2 or higher. There are no hardware-specific requirements. Older releases are not supported.

Install these prerequisites on your own computer

On the computer from which you administer your IBM i, you will need these programs:

  1. The latest version of IBM i Access Client Solutions (ACS). You can download the latest version from IBM.
    • ACS requires Java. We recommend getting Java from AdoptOpenJDK, which has no restrictions on commercial use.
  2. An SSH client. See the page on how to use SSH.

Set up IBM i open source environment

1. Installing Yum from ACS

(Skip ahead to #2 if you already have Yum installed.)

Note that the package management in ACS will require SSH to be running on your IBM i. See the page on how to use SSH.

From the main window of ACS, select Open Source Package Management from the Tools menu.

ACS package management menu (Linux)

ACS package management menu (Linux)

A window will pop up for authentication information or connecting to your IBM i over SSH. Either a password or SSH key (in OpenSSH format; you must convert PuTTY format keys with PuTTYgen. See the page on SSH for how to convert.) can be used; if you aren’t using an SSH key, uncheck the box. It will also ask if you’re using a chroot; if you don’t know, you aren’t and can ignore it.

ACS package management login

ACS package management login

If this is your first time connecting to the system, the system will prompt if this is the correct fingerprint for the host. The SSH guide explains in detail, but essentially if the fingerprint changes after this initial confirmation, it will warn you.

ACS package management trust on first use prompt

ACS package management trust on first use prompt

If Yum isn’t installed already, it will ask if you want to install it. This is the reason why we’re here, so we’ll say yes.

ACS package management install prompt

ACS package management install prompt

When it’s finished (you should see the “Bootstrap Complete” message), you can close any windows reporting progress, and the main window will show the installed packages.

ACS package management installed packages

ACS package management installed packages

2. Update Yum packages

Go to the “Updates Available” tab and install any updates available. The bootstrap process may not install the very latest versions of software, so click “Update” to update any packages that the bootstrap process installed.

ACS package management updates available

ACS package management updates available

A window will pop open with Yum. Answer yes or no to this screen, and Yum will output its progress.

ACS package management yum window

ACS package management yum window

For more information on updating, please see the procedure for updating packages. It covers both using ACS and running the yum command manually.

3. Install important packages

Several important packages may still need to be installed, if they weren’t in the bootstrap package you used. The packages are listed below. You may install them from ACS or use the commands below to install them manually in an SSH terminal (or equivalent).

Install yum-utils (simplifies administering repositories through the command line):

yum install yum-utils

Install curl (required for RPM to fetch package signing keys)

yum install curl

Install ca-certificates-mozilla (required for TLS connections)

yum install ca-certificates-mozilla

4. Setting up PATH on the PASE command line

(Optional) It is highly recommended to set your path to avoid having to type the full paths of commands.