IBM i System Requirements

<< Click to Display Table of Contents >>

Navigation:  Introduction >

IBM i System Requirements

In order to use iForGit, there are a few system requirements


1.) Your IBM i OS level must be at least V7R2. Preferably V7R3 or newer.  


2.) Since iForGit relies on git for version control, You must have the IBM ACS Yum open source packages installed for the following components at minimum:


git (Git source control)


wget   (wget is an HTTP downloader)


rpm   (rpm is not used by iForgit currently, but should be present.)


make   (make may be needed for any continuous integration you use.)


You can check if these are already installed by logging into an SSH/putty shell or using the STRQSH command from the IBM i.


Simply log in and type the appropriate command and press Enter. If you see command line messages that are not errors, then the PASE commands are installed.


Example after doing STRQSH, typing git and pressing Enter. Git is present in this user search path !!


usage: git [--version] [--help] [-C <path>] [-c name=value]                

          [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]  

          [-p | --paginate | --no-pager] [--no-replace-objects] [--bare]  

          [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]    

          <command> [<args>]                                              


These are common Git commands used in various situations:                  


start a working area (see also: git help tutorial)                          

  clone      Clone a repository into a new directory                      

  init       Create an empty Git repository or reinitialize an existing one



Example after doing STRQSH, typing git and pressing Enter. Git is NOT present in this user search path !!


qsh: 001-0019 Error found searching for command gitu. No such path or directory.                                                                          



Setting Up Search Paths to Git

If git is loaded but not in your user search path, you can simply run the GITPATH before running any iForGit or QShell commands. This adds /QOpenSys/pkgs/bin to the PATH environment variable for the current IBM i job. GITPATH would be run each time the user logs in or a .profile file should be set in the users home directory. .profile would normally be created here: /home/userid/.profile with code page/CCSID 819 or 1252.


After running GITPATH or creating a .profile file you can try STRQSH again or an SSH/putty session to see if git is now available when you type the git command.


Example .profile file contents for each user in their user home directory:

# Make sure QOpenSys Yum packages are available for user      



If you have issues with the IBM i ACS Packages being loaded you can reach out to your network team to set up the open source packages or we can be contracted to assist with set up.