Open Source on IBM i Webinar Series Day 2 ERWIN EARLEY ([email protected]), SR. SOLUTIONS CONSULTANT, PERFORCE, NOVEMBER 2019 2 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Day 1 Review • Introduction to Open Source on IBM i • Why is Open Source on IBM i Important • Understanding the PASE environment as the enabler of Open Source on IBM i • Getting Familiar with the PASE environment 2 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 3 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Day 2 Agenda • Setting up OSS EcoSystem on IBM i – ACS version • Exploring Containers on IBM i • Managing Open Source on IBM i • Exploring Open Source Programming Languages ▪ Integration with Db2 and ILE • After-Hours Lab: Containers & Setting up Development Environment • After-Hours Lab: Open Source Programming Languages 3 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com IBM Systems Technical University © 3 4 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Setting up OSS Ecosystem on IBM i – ACS Version 4 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 5 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com The directory structure Before installing the Open Source ecosystem / dev home lib sbin tmp usr var Directory Contents bin Commands dev Device Files etc Configuration files home User Home Directories lib Libraries pkgs Package files / commands sbin Privileged commands tmp Temporary files usr Utilities & Applications var Variable files 5 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 5 6 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Bootstrapping OSS • Bootstrapping is the process of installing utilities and repository definitions to enable the system with the necessary commands for managing open source packages Version 1.1.8 Connect to the or later of system via ACS SSH NOTE: An alternate installation method would be to download the SQL bootstrap script from management Supports in packages of containers separate ftp://public.dhe.ibm.com/software/ibmi/ Bootstrap not products/pase/rpms/bootstrap.sql and currently installed run it against your IBM i 6 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 7 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Repository Definition • One of the tasks that the bootstrap accomplished was setting up a repository definition • The RPM packages reside in a repository that is publicly accessible • The definition of the repository is located in the /QOpenSys/etc/yum/repos.d directory • The repository file for the IBM RPM pile is ibm.repo [ibm] name=ibm baseurl=http://public.dhe.ibm.com/software/ibmi/products/pase/rpms/repo enabled=1 gpgcheck=0 Note: it is possible to use a local repository by downloading the files from the indicated FTP site and then uploading them to a directory on the system. The 'baseurl' would change to indicate 'file' and the path to the directory of RPMs. Additional note: ACS has support for cloning the repository to a local server. 7 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 8 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com The directory structure After installing the Open Source bootstrap / dev home lib QOpenSys sbin tmp usr var bin etc lib pkgs sbin tmp usr var 8 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 8 9 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Install New Software: ACS yum install <package> 9 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 10 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Check for Updates: ACS yum list upgrades 10 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 11 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Perform an Update: ACS yum upgrade <package> yum upgrade 11 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 12 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Security Vulnerability! Uh Oh!!! • https://www.cvedetails.com/cve/CVE-2018-1000007/ 12 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 13 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com What's installed?: ACS yum list <package> yum list '*searchword*' 13 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 14 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com What's available?: ACS yum list available 14 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 15 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Where does all this information come from? 15 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 16 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Where does all this information come from? 16 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 17 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Where are the RPMs (packages) hosted? • Open-Source Software team builds .rpm files, then we put them out on the internet for you: https://public.dhe.ibm.com/software/ibmi/products/pase/rpms/repo 17 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 18 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Not just IBM repositories!! .NET Available on IBM i!!! • Mono has been ported to IBM i!! • Community Effort • Available via third-party RPM repository https://bitbucket.org/ibmi/opensourc e/src/master/docs/yum/3RD_PART Y_REPOS.md 18 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 19 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com https://bitbucket.org/ibmi/opensource/src/master/docs/yum/3RD_PARTY_REPOS.md 19 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 20 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Automating the Process “How can I limit the RPMs available?” • You need to host your own private RPM repository “My systems can’t access the internet!” • You need to host your own private RPM repository on your company’s intranet “I need to distribute to many systems” • Easy to do with Yum – Script or Schedule a Job “That sounds really hard” • Yes it does. But it is actually very easy. Let me show you... 20 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 21 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Managing your RPMs company wide IBM .rpm repo Your IBM i(s) Or Chroots Your private repo Host server 21 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 22 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Managing your RPMs company wide IBM .rpm repo Your IBM i(s) Or Chroots Your private repo Host server ACS 22 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 23 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Distributing updates in 4 easy steps 1) Clone the IBM OSS repo to your Host server 2) Create your own repo 3) Point your IBM i systems to your repo 4) Automate… 23 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 24 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Step 1: Clone IBM i OSS repo (using ACS) 24 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 25 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Step 2: Create your own repo (with ACS) Copy from source repo Create repo Make repo accessible 25 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 26 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Step 3: Point your IBM i systems to your repo Now, onto your IBM i systems… We have to set up our systems to point to our new repository NOTE: I use ssh to connect to my IBM i, and run bash script. Some bash commands may be different than QP2TERM commands! 26 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 27 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Step 3: Point your IBM i systems to your repo This is where the ACS and non-ACS paths meet… On your IBM i, run the following command to point yum to the repo yum-config-manager --add-repo <ip-address-where-hosted>/ibm yum-config-manager --add-repo <ip-address-where-hosted> 27 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 28 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Step 3: Point your IBM i systems to your repo When you run yum repolist, you should see your new, privately hosted repo! 28 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 29 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Step 3: Point your IBM i systems to your repo Summary: We created a .repo file in /QOpenSys/etc/yum/repos.d We can now get our RPMs on our IBM i directly from our own repository 29 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 30 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Automating updates IBM .rpm repo Your IBM i(s) Your private repo Host server 30 | Zend by Perforce © 2019 Perforce Software, Inc. zend.com 31 | COMMON Webinar Series: Open Source on IBM i | November 2019 zend.com Utilities • Various utilities are available for working in PASE including editors, package management tools, and source code control systems • By installing the open source bootstrap (shown earlier) tools such as yum and rpm are available for manage other software packages Function yum command Install a package yum install <package> Remove a package yum remove <package> Search for a package yum search <package> List installed packages yum list installed List available packages yum list available List all packages yum list all 31 | Zend by Perforce © 2019 Perforce Software, Inc.