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

 

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

git                                                                        

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

 

You can also type the following from a 5250 command line to see if the git binary file exists

wrklnk '/qopensys/pkgs/bin/git'   

 

 

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

git                                                                        

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      

PATH=/QOpenSys/pkgs/bin:$PATH

 

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

 

 

Links to Installing IBM i Yum Packages

 

The links below will take you to the IBM page which covers setting up the open source packages on IBMi via IBM i Access ACS.

 
Getting started with Open Source Package Management in IBM i ACS

https://www.ibm.com/support/pages/node/706903

 

Getting started with Open Source Package Management in IBM i ACS - PDF Version

View PDF version of: Getting started with Open Source Package Management in IBM i ACS

 

Here is a more complete site for installing open source packages on IBMi.

https://bitbucket.org/ibmi/opensource/src/e9ab9d2e8c1cc1f96b4dd4bd9801d8f8ddf9c8e8/docs/yum/#markdown-header-installing-with-access-client-solutions-acs