### 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 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 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 with your provider's name. ```bash /opt/certbot/bin/pip install certbot-dns- ``` ```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 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= install ``` -------------------------------- ### 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 ```