INSTALL WSL

Ref: https://learn.microsoft.com/en-us/windows/wsl/install

Open power shell as admin and run:

wsl --install

This will install Ubuntu by default. Once command is successfully executed, reboot your system. After
the reboot the system will ask you to create a user for Ubuntu.

You should be able to access Ubuntu terminal from windows terminal.

Click on start and type terminal. Click on the arrow button on top and select Ubuntu.

DOCKER INSTALL

Ref: https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository

Note: Docker offers a convenience script to install docker. I haven’t tried it, but you can check if you
want to do the installation using the script.

Check your version of Ubuntu, in the terminal run

Note : Run the below commands outside of basspro vpn

lsb_release -a

If you have installed Ubuntu recently, you’d be having codename Jammy. I am running an older
version focal.

In the Ubuntu terminal run the below commands in order:

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo mkdir -m 0755 -p /etc/apt/keyrings

### IF UBUNTU VERSION IS FOCAL STARTS

curl -4fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o
/etc/apt/keyrings/docker.gpg
### IF UBUNTU VERSION FOCAL ENDS

### IF UBUNTU VERSION JAMMY STARTS

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key --keyring
/etc/apt/trusted.gpg.d/docker-apt-key.gpg add
### IF UBUNTU VERSION JAMMY ENDS

## Check keys are installed or not

sudo apt-key fingerprint

You should be able to see docker keys if the curl commands above were successful.

sudo apt-add-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $

(lsb_release -cs) stable"

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

sudo service docker start

docker version
Both client and server version details should be available.

If you get permission denied error that means your user is not added in the docker group. You can
check the same by running:

groups

If you’re not seeing the docker group run the below command to add your user to docker group

sudo usermod -aG docker $USER

After running this command restart the terminal.

Run the group command again to see if docker group is present. If it is you should be able to run
docker commands without sudo going forward.

Check by running:

docker run hello-world

INSTALL DOCKER COMPOSE

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-

compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

docker-compose --version

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

sudo chmod +x /usr/bin/docker-compose

Install DTK

In Ubuntu, create a directory named oms in your home directory

cd ~
mkdir oms

Download the DTK zip from box folder and unzip it. Move the devtoolkit_docker folder from your
Windows to Ubuntu. Make sure to use ubuntu command line to do this. The windows drive can be
accessed under /mnt directory.

cd ~/oms

C:\Users\VASIREDDYVENKATASURY\Downloads\devtoolkit_docker_10.0.2309.2

cp -r /mnt/c/Users/VASIREDDYVENKATASURY/Downloads/devtoolkit_docker .
cp -r /mnt/c/Users/001YZF744/Downloads/devtoolkit_latest/devtoolkit_docker .

chmod +x devtoolkit_docker/compose/*.sh

Make a copy of the om-compose.properties

cd ~/oms/devtoolkit_docker/compose
cp om-compose.properties.sample om-compose.properties
vi om-compose.properties

Update the below mentioned properties:

DTK_LICENSE=accept

STORE_DISABLE_LEGACY_APP=N

ORDERHUB_ENABLE=N

AP_WAR_FILES=wscdev,smcfs,sbc,isccsdev
Update JVM properties

cd /home/default/oms/devtoolkit_docker/compose/docker/appserver
/home/hari/oms/devtoolkit_docker/compose/docker/appserver
vi jvm.options

Add the below prams

-Dwufdevmode=true
-DuiExtensibilityMode=true
-Ddevmode=true

Install DTK

cd ~/oms/devtoolkit_docker/compose

./om-compose.sh setup

The installation will take ~ 1 hr.

Once completed, run

docker ps

This will show what all containers are running.

We should have:

om-appserver
om-runtime
om-mqserver
om-db2server

Try to connect to the local DB.

Host: localhost
Port: 50000
Database: OMDB
Username: db2inst1
Password: diet4coke

(Make sure the DB2 you installed for 9.5 local is not running. To stop it run db2stop in the db2
command line.)

Try to connect to apps:

COM: https://localhost:9443/isccsdev/isccs/login.do
API tester: https://localhost:9443/smcfs/yfshttpapi/yantrahttpapitester.jsp
Store: https://localhost:9443/wscdev/store/login.do
SBC: https://localhost:9443/sbc/sbc/login.do

IMPORTING BASSPRO CODE AND CDT

As per this IBM document, below mentioned folder structure is required:

This is how it looks for me:

Under /files/properties I have customer_overrides.properties and value maps file.

The lib folder contains the 3rd party jars

Comment the below properties in the customer_overrides

jdbcService.db2Pool.datasource=jdbc/bpsDataSource
yfs.yfs.searchIndex.rootDirectory=/opt/IBM/sterling95/catalogIndex
yfs.log4j.configuration=/resources/extn/BPS_log4jconfig.xml

Update the value of

yfs.bps.providerurl.internal
yfs.bps.providerurl.external

DTK does not allow default properties to be overridden in COP file. To override this behavior we need
to make a change in sandbox.cfg before starting build

cd ~/oms/devtoolkit_docker/runtime/properties/
vi sandbox.cfg

Make DATABASE_PROPERTY_MANAGEMENT=false.

(By default it will be true)

START BUILD

cd ~/oms/devtoolkit_docker/runtime/bin

./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml importfromproject -

Dprojectdir=/home/default/oms/basspro

Should take ~ 30 min the first time

Once this build is successfully completed, an extensions.jar file will get generated
This needs to be deployed now.

FOR DEPLOYMENT

cd ~/oms/devtoolkit_docker/compose

./om-compose.sh update-extn ../extensions.jar

Once deployment is successful, check DB extensions are present and you’re able to log into the apps.

QUEUE CREATION

To create any queue run

./om-compose.sh add-queue QUEUE_NAME

In the compose directory

CDT

Now we need to put v10 Master CDT into out local.

Create a folder named cdtxml in the oms directory and put the cdt xmls in it. These xmls were shared
by v10 team. Make the required changes in the ydkprefs (folder path) and place it in
~/oms/devtoolkit_docker/runtime/resources/ydkresources folder.

Make the required changes in cdtshell.sh that is present under ~/oms/devtoolkit_docker/runtime/bin

Stop the appserver and runtime container

cd ~/oms/devtoolkit_docker/compose

./om-compose.sh stop appserver

./om-compose.sh stop omruntime

Navigate back to runtime bin and execute the cdtshell.sh script.

Once CDT is completed check in DB if basspro customizations are present (Common Codes, Flows
etc.)

Start the appserver and runtime and try to access the apps.

cd ~/oms/devtoolkit_docker/compose
./om-compose.sh start db2server
./om-compose.sh start mqserver

./om-compose.sh start appserver

./om-compose.sh start omruntime

cd compose-orderhub/
./oh-compose.sh start