IBM i Open Source

https://ibmi-oss-docs.readthedocs.io/en/latest/
Admin
This repository provides authoritative documentation for IBM i Open Source Software, covering PASE...
Tokens:54,834
Snippets:811
Trust Score:9.6
Update:4 months ago
Show doc for...
Tokens:
Raw
### NVM Installation Examples

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/nodejs/README.md.txt

Common NVM commands for installing and managing Node.js versions. These are typically run from an SSH terminal.

```bash
nvm install stable
```

```bash
nvm install --lts
```

```bash
nvm use --lts
```

--------------------------------

### Install Certbot Cloudflare DNS Plugin

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/certbot.html

Example command to install the Certbot DNS plugin for Cloudflare.

```bash
/opt/certbot/bin/pip install certbot-dns-cloudflare

```

--------------------------------

### PATH Examples: Best Practice

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/troubleshooting/SETTING_PATH.md.txt

Illustrates the 'Best' example of a PATH variable, prioritizing custom binaries.

```bash
/QOpenSys/pkgs/bin:/QOpenSys/usr/bin:/usr/ccs/bin:/QOpenSys/usr/bin/X11:/usr/sbin:.:/usr/bin
```

--------------------------------

### Start PostgreSQL Server

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/postgresql.md.txt

Starts the PostgreSQL database server. The logfile will record server activity.

```bash
pg_ctl -D /home/postgres -l logfile start
```

--------------------------------

### Run Kafka Visualizer on IBM i

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/kafka/README.md.txt

Start the Kafka visualizer after installation on IBM i. Access the visualizer via localhost:8080 in your browser.

```bash
/opt/kafka-visualizer/bin/kafka-visualizer
```

--------------------------------

### Install Nginx

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/nginx/README.md.txt

Installs Nginx using the yum package manager. This is the initial step before configuration.

```bash
yum install nginx
```

--------------------------------

### Install PostgreSQL Packages

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/postgresql.md.txt

Installs the PostgreSQL server and contrib packages using yum. Ensure you have the necessary IBM i ACS Open Source Package Management setup or SSH access.

```bash
yum install postgresql12-server postgresql12-contrib
```

--------------------------------

### Start Nginx with Base Directory Option

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/nginx/README.html

Starts Nginx, setting the base directory for resolving relative paths in the configuration.

```bash
nginx -p $(pwd) -c $(pwd)/nginx.conf

```

--------------------------------

### Install Certbot

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/certbot.md.txt

Installs the Certbot package within the created virtual environment.

```bash
/opt/certbot/bin/pip install certbot
```

--------------------------------

### Start Zookeeper server

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/kafka/README.md.txt

Starts the Zookeeper server using its default configuration file. This must be running before starting the Kafka server.

```shell
cd kafka_2.13-3.0.1/config
../bin/zookeeper-server-start.sh zookeeper.properties
```

--------------------------------

### Start Nginx Server

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/nginx/README.md.txt

Starts the Nginx server using a specified configuration file. The -c option points to the configuration file location.

```bash
nginx -c /www/nginx/nginx.conf
```

--------------------------------

### Adjust PATH Environment Variable

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/yum/README.md.txt

Add /QOpenSys/pkgs/bin to your PATH environment variable to easily access installed software. This example shows how to set it for the current session and verify.

```sh
PATH=/QOpenSys/pkgs/bin:$PATH
export PATH

bash --version
GNU bash, version 4.4.12(1)-release (powerpc-ibm-os400)
Copyright (C) 2016 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

This is free software; you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
```

--------------------------------

### Install Kafka Visualizer on IBM i via Yum

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/kafka/README.md.txt

Install necessary certificates and the Kafka visualizer RPM package on IBM i using yum.

```bash
yum install ca-certificates-mozilla
yum install https://github.com/ThePrez/kafka-visualizer/releases/download/v1.0.0/kafka-visualizer-1.0.0-0.ibmi7.3.ppc64.rpm
```

--------------------------------

### Execute Program with Fully Qualified Path

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/yum/README.md.txt

Demonstrates how to execute a program by specifying its full path, as installed software resides in /QOpenSys/pkgs. This is useful for verifying installations.

```sh
/QOpenSys/pkgs/bin/bash --version
GNU bash, version 4.4.12(1)-release (powerpc-ibm-os400)
Copyright (C) 2016 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

This is free software; you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
```

--------------------------------

### Start PostgreSQL Server

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/postgresql.html

Starts the PostgreSQL database server using the pg_ctl utility. Specify the data directory and a log file path.

```bash
pg_ctl -D /home/postgres -l logfile start

```

--------------------------------

### Install MariaDB 10.6.x Packages

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/mariadb/MIGRATION-10.6.md.txt

Install the MariaDB 10.6.x server and client packages using yum.

```sh
yum install mariadb-10.6-server mariadb-10.6
```

--------------------------------

### Start Tomcat Server

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/tomcat/DEPLOYMENT.md.txt

Navigate to the Tomcat bin directory and execute the startup script to launch the Tomcat server.

```bash
cd $TOMCAT/bin
./startup.sh
```

--------------------------------

### Create Installation Directories

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/java/tomcat/DEPLOYMENT.html

Creates the specified download and Tomcat installation directories. The `-p` flag ensures that parent directories are created if they do not exist and does not error if the directory already exists.

```bash
mkdir -p $DOWNLOAD
mkdir -p $TOMCAT

```

--------------------------------

### Install Python 3 and useful packages

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/yum/README.md.txt

Installs Python 3, pip, and essential Python packages for database access and toolkit usage.

```shell
yum install python3-pip python3-ibm_db python3-itoolkit
```

--------------------------------

### Install sed Tool

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/yum/README.html

Installs the GNU version of the sed tool from the repository using yum.

```bash
yum install sed-gnu
```

--------------------------------

### Start Kafka server

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/kafka/README.md.txt

Starts the Kafka server using its default configuration file. Ensure Zookeeper is running in a separate session before executing this command.

```shell
JAVA_HOME=/QOpenSys/pkgs/lib/jvm/openjdk-11
export JAVA_HOME
PATH=$JAVA_HOME/bin:$PATH
export PATH
cd kafka_2.13-3.0.1/config
../bin/kafka-server-start.sh server.properties
```

--------------------------------

### Start WildFly in Standalone Mode

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/wildfly/DEPLOYMENT.md.txt

Navigate to the WildFly bin directory and execute the standalone script to start the server. This is used when server addresses have been pre-configured.

```bash
cd $WILDFLY/bin
./standalone.sh
```

--------------------------------

### Install CA Certificates and Switch to HTTPS

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/yum/README.md.txt

Install necessary CA certificates and use sed to update the repository file to use HTTPS. This is recommended for secure connections.

```bash
# Install SSL CA certificates
yum install ca-certificates-mozilla
# Install sed tool from repository
yum install sed-gnu
# Switch the protocol to https
/QOpenSys/pkgs/bin/sed --in-place='_backup' 's/http:/https:/' /QOpenSys/etc/yum/repos.d/ibm.repo
```

--------------------------------

### Install GCC and development tools

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/yum/README.md.txt

Installs the 'Development tools' group, which typically includes GCC and other essential tools for compiling software.

```shell
yum group install "Development tools"
```

--------------------------------

### Install Required Software Packages

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/java/wildfly/DEPLOYMENT.html

Installs essential packages including wget, tar, gzip, and OpenJDK 11 using yum.

```shell
yum install wget tar-gnu gzip nano openjdk-11

```

--------------------------------

### Install SSL CA Certificates

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/yum/README.html

Installs the Mozilla CA certificates package using yum.

```bash
yum install ca-certificates-mozilla
```

--------------------------------

### Install Development Tools for NVM

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/nodejs/README.html

Install the necessary development tools and GCC version required for building Node.js and its modules when using NVM.

```bash
yum group install "Development Tools"
yum install gcc10*

```

--------------------------------

### Start Kafka Connect Standalone with Multiple Worker Configurations

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/kafka/KAFKA_CONNECT_JDBC.md.txt

Command to start Kafka Connect in standalone mode, loading multiple worker configuration files.

```bash
bin/connect-standalone.sh config/connect-standalone.properties config/worker-jtopen.properties config/worker-db2.properties
```

--------------------------------

### Start Nginx with Base Directory

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/nginx/README.md.txt

Starts Nginx using the -p option to set the base directory, allowing relative paths in the configuration. This is useful when running commands from the configuration file's directory.

```bash
nginx -p $(pwd) -c $(pwd)/nginx.conf
```

--------------------------------

### Set Download and Tomcat Installation Directories

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/tomcat/DEPLOYMENT.md.txt

Define environment variables for the download directory and the Tomcat installation directory. These variables simplify subsequent commands by providing convenient shortcuts.

```bash
export DOWNLOAD=/opt/download
export TOMCAT=/opt/tomcat
```

--------------------------------

### Install Latest RPM, YUM, and IBMI-REPOS Packages

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/troubleshooting/README.md.txt

After adjusting RPM configuration, it is recommended to install the latest versions of the rpm, yum, and ibmi-repos packages to ensure compatibility and access to updated repositories.

```bash
/QOpenSys/pkgs/bin/yum install -y rpm yum ibmi-repos
```

--------------------------------

### Install Latest Stable Node.js Version

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/nodejs/README.html

Use this command to install the latest stable release of Node.js via nvm.

```bash
nvm install stable
```

--------------------------------

### Install Node.js on IBM i

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/examples.md.txt

Install Node.js version 10 on your IBM i system using yum package manager.

```bash
yum install nodejs10
```

--------------------------------

### Install Certbot DNS Plugin

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/certbot.md.txt

Use this command to install the appropriate Certbot DNS plugin for your provider. Replace <PLUGIN> with your provider's name.

```bash
/opt/certbot/bin/pip install certbot-dns-<PLUGIN>
```

```bash
/opt/certbot/bin/pip install certbot-dns-cloudflare
```

--------------------------------

### Install Development Tools with yum

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/nodejs/README.md.txt

Install necessary development tools, including GCC, using the yum package manager on IBM i.

```bash
yum group install "Development Tools"
yum install gcc10

```

--------------------------------

### Start WildFly with Specified Server Addresses

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/wildfly/DEPLOYMENT.md.txt

Start WildFly in standalone mode and specify the bind address for the server and management interface using -b and -bmanagement arguments. This is useful when server addresses were not pre-configured.

```bash
cd $WILDFLY/bin
./standalone.sh -b 171.20.0.10 -bmanagement 0.0.0.0
```

--------------------------------

### Install Required Software using Yum

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/wildfly/DEPLOYMENT.md.txt

Install essential software packages including wget, tar, gzip, and a Java Development Kit using the yum package manager.

```bash
yum install wget tar-gnu gzip nano openjdk-11
```

--------------------------------

### Install IBM i Access ODBC on SUSE-based Linux

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/installation.md.txt

Installs the IBM i Access ODBC driver on SUSE-based Linux distributions using zypper.

```shell
sudo zypper refresh
sudo zypper install ibm-iaccess
```

--------------------------------

### Set WildFly and Download Directories

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/wildfly/DEPLOYMENT.md.txt

Define environment variables for the WildFly installation and download directories. These variables simplify path management during the installation process.

```bash
export DOWNLOAD=/opt/download
export WILDFLY=/opt/wildfly
```

--------------------------------

### Install Kafka prerequisites using yum

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/kafka/README.md.txt

Installs necessary software packages for Kafka deployment on IBM i, including wget, Java Development Kit (OpenJDK 11), and essential utilities.

```shell
yum install wget ca-certificates-mozilla gzip tar-gnu openjdk-11 coreutils-gnu sed-gnu grep-gnu
```

--------------------------------

### Install IBM i Access ODBC on IBM i

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/installation.md.txt

Installs the IBM i Access ODBC driver and unixODBC driver manager on IBM i systems using yum.

```bash
yum install ibm-iaccess
```

--------------------------------

### Install Python Package with pip

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/python/README.md.txt

Use this command to install or upgrade a Python package using pip, specifying the Python interpreter. This example installs the 'xlsxwriter' package.

```bash
python3.9 -m pip install --upgrade xlsxwriter
```

--------------------------------

### Upgrade Yum and IBMI-Repos

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/troubleshooting/YUM.md.txt

Ensure you have the latest versions of `yum` and `ibmi-repos` installed. This is a prerequisite for troubleshooting connection issues.

```bash
/QOpenSys/pkgs/bin/yum upgrade yum ibmi-repos
```

--------------------------------

### Connect and Interact with PostgreSQL Locally

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/postgresql.html

Demonstrates connecting to the PostgreSQL server using `psql`, creating a database, connecting to it, creating a table, inserting data, and querying the data. Use this for initial local setup and testing.

```bash
$ psql
Password for user postgres:
postgres=# CREATE DATABASE us_states;
CREATE DATABASE

postgres=# \c us_states;
You are now connected to database "us_states" as user "postgres".

us_states=# CREATE TABLE States(id SERIAL, name varchar(50));
CREATE TABLE

us_states=# INSERT INTO States(name) VALUES('Alabama');
INSERT 0 1

us_states=# SELECT * FROM States;
 id |  name   
----+---------
  1 | Alabama
(1 row)

us_states=# \q

```

--------------------------------

### Configure Yum with HTTP Repository

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/troubleshooting/YUM.md.txt

If `ibmi-repos` cannot be installed, use this command to configure yum to use the HTTP repository as a fallback.

```bash
/QOpenSys/pkgs/bin/yum-config-manager --setopt=ibm.baseurl=http://public.dhe.ibm.com/software/ibmi/products/pase/rpms/repo
```

--------------------------------

### Verify Bash Installation via PATH

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/user_setup/README.md.txt

After configuring the PATH, run this command to verify that the system can locate the bash executable in the specified directory.

```bash
which bash
```

--------------------------------

### Install IBM i Access ODBC on Red Hat-based Linux

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/installation.md.txt

Installs the IBM i Access ODBC driver on Red Hat-based Linux distributions using dnf.

```shell
sudo dnf install --refresh ibm-iaccess
```

--------------------------------

### Set up Python Virtual Environment

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/certbot.md.txt

Creates a virtual environment for Certbot, including system site packages.

```bash
python3.9 -m venv --system-site-packages /opt/certbot
```

--------------------------------

### Create Installation and Download Directories

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/wildfly/DEPLOYMENT.md.txt

Create the directories specified by the DOWNLOAD and WILDFLY environment variables. The '-p' flag ensures that parent directories are created if they don't exist.

```bash
mkdir -p $DOWNLOAD
mkdir -p $WILDFLY
```

--------------------------------

### Verify Bash Version

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/troubleshooting/SETTING_PATH.md.txt

Example of checking the bash version, often used after PATH adjustments.

```bash
$ bash --version
GNU bash, version 4.4.12(1)-release (powerpc-ibm-os400)
Copyright (C) 2016 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

This is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation. Either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
```

--------------------------------

### Get Kafka Connector Status (Db2 JDBC)

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/kafka/KAFKA_CONNECT_JDBC.html

Use curl and jq to retrieve and display the status of a specific Kafka Connect connector. This example targets a connector using the Db2 JDBC driver.

```bash
curl -s "http://localhost:8083/connectors/jdbc_source_db2_01/status" | jq '.'
```

--------------------------------

### Get Kafka Connector Status (Toolbox JDBC)

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/kafka/KAFKA_CONNECT_JDBC.html

Use curl and jq to retrieve and display the status of a specific Kafka Connect connector. This example targets a connector using the Toolbox JDBC driver.

```bash
curl -s "http://localhost:8083/connectors/jdbc_source_jtopen_01/status" | jq '.'
```

--------------------------------

### Upgrade IBMI-Repos Package

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/troubleshooting/YUM.md.txt

After installing `ibmi-repos`, upgrade it again to ensure you are on the latest available version for your release.

```bash
/QOpenSys/pkgs/bin/yum upgrade ibmi-repos
```

--------------------------------

### Change directory for Kafka installation

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/kafka/README.md.txt

Navigates to the specified directory where Kafka will be downloaded and extracted.

```shell
cd /home/myusr/mydir
```

--------------------------------

### Install Python and Dependencies

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/certbot.md.txt

Installs Python 3.9 and the cryptography package using yum.

```bash
yum install python39-pip python39-cryptography
```

--------------------------------

### Create Download and Installation Directories

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/tomcat/DEPLOYMENT.md.txt

Create the directories specified by the DOWNLOAD and TOMCAT environment variables. The -p flag ensures that parent directories are created if they do not exist and does not return an error if the directory already exists.

```bash
mkdir -p $DOWNLOAD
mkdir -p $TOMCAT
```

--------------------------------

### Install Python and Cryptography Packages

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/certbot.html

Installs Python 3.9 and the cryptography library required for Certbot.

```bash
yum install python39-pip python39-cryptography

```

--------------------------------

### Verify Home Directory Creation

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/user_setup/README.md.txt

After creating the home directory, use these commands to navigate into it and print the current working directory, confirming the creation was successful.

```bash
cd $HOME
pwd
```

--------------------------------

### Extract WildFly Installation

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/java/wildfly/DEPLOYMENT.html

Extracts the WildFly archive into the designated installation directory, stripping the top-level directory component.

```shell
cd $DOWNLOAD
tar --strip-components=1 -C $WILDFLY -xzvf wildfly-28.0.0.Final.tar.gz

```

--------------------------------

### Install Service Commander

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/wildfly/DEPLOYMENT.md.txt

Install the service-commander package using yum. This is a prerequisite for managing WildFly with Service Commander.

```bash
yum install service-commander
```

--------------------------------

### Install IBM i Access ODBC on macOS

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/installation.md.txt

Installs the IBM i Access ODBC driver on macOS using Homebrew.

```shell
brew install ibm-iaccess
```

--------------------------------

### Initialize Node.js Project

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/examples.md.txt

Initialize a new Node.js project using npm. This creates a package.json file to manage project dependencies.

```bash
npm init -y
```

--------------------------------

### Create and Set Ownership for PostgreSQL Home Directory

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/postgresql.md.txt

Creates the /home/postgres directory and changes its ownership to the POSTGRES user. This requires *ALLOBJ authority for directory creation under '/'.

```sh
mkdir /home/postgres
chown postgres /home/postgres
```

--------------------------------

### Install packages into a chroot environment

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/yum/README.md.txt

Installs specified packages into a chroot environment using the --installroot option with yum.

```shell
yum --installroot=<path too chroot> install <package list>
```

--------------------------------

### Connect and Interact with PostgreSQL Locally

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/postgresql.md.txt

Use the psql client to connect to the PostgreSQL server, create a database, create a table, insert data, and view the data. This snippet demonstrates basic psql commands for local interaction.

```text
$ psql
Password for user postgres:
postgres=# CREATE DATABASE us_states;
CREATE DATABASE

postgres=# \c us_states;
You are now connected to database "us_states" as user "postgres".

us_states=# CREATE TABLE States(id SERIAL, name varchar(50));
CREATE TABLE

us_states=# INSERT INTO States(name) VALUES('Alabama');
INSERT 0 1

us_states=# SELECT * FROM States;
 id |  name
----+---------
  1 | Alabama
(1 row)

us_states=# \q
```

--------------------------------

### Install Service Commander Package

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/java/wildfly/DEPLOYMENT.html

Installs the 'service-commander' package using yum. This is the first step to enable Service Commander management.

```bash
yum install service-commander

```

--------------------------------

### Set up PATH environment variable

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/kafka/README.md.txt

Configures the system's PATH environment variable to include the OpenJDK binary directory, essential for running Kafka and Zookeeper commands.

```shell
PATH=/QOpenSys/pkgs/bin:$PATH
export PATH
```

--------------------------------

### Install Node.js ODBC Package

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/examples.md.txt

Install the 'odbc' npm package to enable Node.js applications to connect to the ODBC driver manager.

```bash
npm install odbc
```

--------------------------------

### Initialize PostgreSQL Database

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/postgresql.md.txt

Initializes the PostgreSQL database in the /home/postgres directory. Sets UTF-8 encoding and SCRAM-SHA-256 authentication. You will be prompted for a superuser password.

```bash
export PGDATA=/home/postgres

initdb -E UTF-8 -D /home/postgres -W -A scram-sha-256
```

--------------------------------

### Install Latest LTS Node.js Version

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/nodejs/README.html

Use this command to install the latest Long-Term Support (LTS) release of Node.js via nvm.

```bash
nvm install --lts
```

--------------------------------

### Set up macOS Repository for IBM i Access ODBC

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/installation.md.txt

Adds the IBM i Access ODBC driver repository for macOS using Homebrew tap.

```shell
brew tap ibm/iaccess https://public.dhe.ibm.com/software/ibmi/products/odbc/macos/tap/
```

--------------------------------

### Verify SSH Client Installation

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/user_setup/README.md.txt

Run this command in a terminal to check if the 'ssh' command is installed on your system. This is typically pre-installed on Mac/Linux systems.

```bash
ssh --version
```

--------------------------------

### Install unixODBC Driver Manager on macOS

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/installation.md.txt

Installs the unixODBC driver manager on macOS using Homebrew. This is required for the IBM i ODBC driver.

```shell
brew install unixodbc
```

--------------------------------

### Initialize Tomcat Service with Service Commander

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/java/tomcat/DEPLOYMENT.html

Use the scinit command to create a service definition for the Tomcat startup script, allowing management via the 'sc' command.

```bash
cd $TOMCAT/bin
scinit ./startup.sh

```

--------------------------------

### Initialize WildFly Service with Service Commander

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/wildfly/DEPLOYMENT.md.txt

Navigate to the WildFly bin directory and use the 'scinit' command to create a service definition for the standalone.sh script. This allows managing WildFly using the 'sc' command.

```bash
cd $WILDFLY/bin
scinit ./standalone.sh
```

--------------------------------

### Install unixODBC Driver Manager on macOS

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/odbc/installation.html

Installs the unixODBC driver manager on macOS using Homebrew. The IBM i ODBC driver is not compatible with iodbc.

```bash
brew install unixodbc

```

--------------------------------

### Initialize Service Commander for Tomcat Startup

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/tomcat/DEPLOYMENT.md.txt

Use the scinit command to create a service definition for the startup.sh script. This allows managing Tomcat via Service Commander.

```bash
cd $TOMCAT/bin
scinit ./startup.sh
```

--------------------------------

### Navigate to WildFly Bin Directory and Add User

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/wildfly/DEPLOYMENT.md.txt

Navigate to the WildFly bin directory and execute the add-user.sh script to create a new management user.

```bash
cd $WILDFLY/bin
./add-user.sh
```

--------------------------------

### Install IBM i Access ODBC on Debian/Ubuntu-based Linux

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/odbc/installation.md.txt

Installs the IBM i Access ODBC driver on Debian and Ubuntu-based Linux distributions using apt.

```shell
sudo apt update
sudo apt install ibm-iaccess
```

--------------------------------

### Initialize Service Commander with Server Addresses

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/java/wildfly/DEPLOYMENT.html

Creates a service definition for 'standalone.sh' using 'scinit', specifying bind addresses for server and management interfaces. Use this if server addresses were not pre-configured.

```bash
scinit ./standalone.sh -b 171.20.0.10 -bmanagement 0.0.0.0

```

--------------------------------

### Install IBM i Access ODBC Driver on macOS

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/odbc/installation.html

Installs the IBM i Access ODBC driver on macOS using Homebrew after adding the IBM i Access tap.

```bash
brew install ibm-iaccess

```

--------------------------------

### Set up Python Virtual Environment

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/certbot.html

Creates an isolated Python environment for Certbot to avoid conflicts with system-wide packages.

```bash
python3.9 -m venv --system-site-packages /opt/certbot

```

--------------------------------

### Troubleshooting Steps without ibmi-repos

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/troubleshooting/YUM.md.txt

Commands to resolve YUM issues when ibmi-repos is not installed. This involves disabling SSL verification, installing packages, and disabling repositories.

```bash
/QOpenSys/pkgs/bin/yum-config-manager --save --setopt=ibm.sslverify=0
/QOpenSys/pkgs/bin/yum install ca-certificates-mozilla ibmi-repos
/QOpenSys/pkgs/bin/yum-config-manager --disable-repo=ibm
```

--------------------------------

### Disable SSL Verification for ibmi-repos

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/troubleshooting/YUM.md.txt

Temporarily disable SSL verification for specific repositories when installing ca-certificates-mozilla. This is useful when HTTPS is broken and prevents package installation.

```bash
/QOpenSys/pkgs/bin/yum-config-manager --save --setopt=ibmi-base.sslverify=0
/QOpenSys/pkgs/bin/yum-config-manager --save --setopt=ibmi-release.sslverify=0
```

--------------------------------

### Install WildFly from Tarball

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/java/wildfly/DEPLOYMENT.md.txt

Extract the downloaded WildFly tarball into the designated installation directory. The --strip-components=1 option removes the top-level directory from the archive during extraction.

```bash
cd $DOWNLOAD
tar --strip-components=1 -C $WILDFLY -xzvf wildfly-28.0.0.Final.tar.gz
```

--------------------------------

### NVM Build Configuration

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/nodejs/README.md.txt

Configure NVM build options by creating a .nvmrc file with these parameters.

```bash
--dest-cpu=ppc64
--without-snapshot
--shared-openssl
--without-perfctr
```

--------------------------------

### Install Python 3 Machine Learning packages

Source: https://ibmi-oss-docs.readthedocs.io/en/latest/_sources/yum/README.md.txt

Installs common Python 3 libraries for machine learning tasks, including NumPy, Pandas, Scikit-learn, and SciPy.

```shell
yum install python3-numpy python3-pandas python3-scikit-learn python3-scipy
```
Tokens:
Raw