Hello, Guys!

Yesterday I had to install IBM App Connect to a proof of concept and I decided to share my walkthrough on how to do it.

If you have any questions, feel free to ask!

I will consider that you already have APP Connect .tar.gz downloaded.

If you are installing on Docker, just put those instructions on your Dockerfile and set the entrypoint/cmd to the sixth step.

IBM App Connect Installation Guide on Linux/Docker

Step 1: Create Group and User

Before starting the installation, create a specific group and user for IBM App Connect:

sudo groupadd mqbrkrs

Creates a new user group named mqbrkrs.

sudo useradd --uid 1001 --create-home --home-dir /home/broker --shell /bin/bash -G mqbrkrs broker

Creates a new user broker with UID 1001, assigns a home directory /home/broker, sets the default shell to /bin/bash, and adds the user to the mqbrkrs group.

Step 2: Create required directories

sudo mkdir -p /opt/ibm/ace-12

Creates the directory /opt/ibm/ace-12 if it does not already exist.

sudo chown -R broker:mqbrkrs /opt/ibm/ace-12

Changes ownership of /opt/ibm/ace-12 to user broker and group mqbrkrs.

sudo mkdir -p /var/mqsi

Creates the directory /var/mqsi if it does not exist.

sudo chown -R broker:mqbrkrs /var/mqsi

Changes ownership of /var/mqsi to user broker and group mqbrkrs.

Step 3: Move and extract installer

sudo mv /home/cxp/12.0.12.0-ACE-LINUX64-DEVELOPER.tar.gz /opt/ibm/ace-12

Moves the installation file to /opt/ibm/ace-12.

cd /opt/ibm/ace-12

Changes the working directory to /opt/ibm/ace-12.

sudo tar -xvf 12.0.12.0-ACE-LINUX64-DEVELOPER.tar.gz --strip-components 1

Extracts the contents of the tar.gz file into /opt/ibm/ace-12, removing the top-level directory.

Step 4: Configure environment variables 

echo 'export LICENSE=accept' >> /home/broker/.bashrc

Adds the LICENSE=accept variable to automatically accept the license agreement.

echo '. /opt/ibm/ace-12/server/bin/mqsiprofile' >> /home/broker/.bashrc

Sources the mqsiprofile script, setting up the environment for IBM App Connect.

echo 'export ODBCINI=/opt/ibm/ace-12/odbc.ini' >> /home/broker/.bashrc

Sets the ODBCINI environment variable to specify the ODBC configuration file location.

source /home/broker/.bashrc

Reload the .bashrc file.

Step 5: Create Integration Server

mqsicreateworkdir /home/broker/ace-server

Creates a working directory at /home/broker/ace-server for the integration server.

Step 6: Start Integration Server

IntegrationServer --name ACE-SERVER -w /home/broker/ace-server --http-port-number 7800 &

Starts the Integration Server with the name ACE-SERVER, using the work directory /home/broker/ace-server, and sets the HTTP port to 7800.

Feel free to add more params to startup IntegrationServer, this is just an example.

Step 7: Configuring Databases Connections

Edit the odbc.ini file to define the connection parameters for the desired database.

Then, set the database connection credentials:

mqsisetdbparms -w /home/broker/ace-server -n odbc::myodbcidentifier -u user -p MySecretP@assword123

mqsisetdbparms is the responsible of storing secrets on IntegrationServer/Node.

By following these steps, IBM App Connect will be successfully installed on your Linux or container environment!

If I forgot something, feel free to add!

Thanks.

#IBMChampion