README.md

Integration

Diagram

Prereqs

Install docker-compose https://docs.docker.com/compose/install/

Minimal supported version is:

 $ docker-compose -v
docker-compose version 1.29.2, build unknown

Prereqs - Red Hat

docker-compose does work on Red Hat OSes starting with podman 3.x. For example:

sudo dnf install -y podman podman-docker podman-plugins
sudo systemctl enable podman.socket --now

Prereqs - PIP

One can install latest docker-compose via PIP

sudo python3 -m pip install --upgrade docker-compose

Start

This pulls the latest images and only builds those it cannot find.

./scripts/integration.sh start

If you are making changes to the container images, you can build them before running start. Note This does not work for images pulled from a cr like the spdk-target image.

./scripts/integration.sh build
./scripts/integration.sh start

If you try to run on a platform that does not support every extended instruction that SPDK supports, the pulled spdk-target image will not function. To work around this, set the BUILD_SPDK variable before starting:

BUILD_SPDK=1 ./scripts/integration.sh start

Start - Red Hat

Note Root-less podman is not supported. So run the integration script as root:

sudo ./scripts/integration.sh start

Test

To manually check the run, execute the following:

• Check Prometheus at http://0.0.0.0:9091
• Check Platform/Host BMC redfish server http://0.0.0.0:8001/redfish/v1
• Check NIC/DPU/IPU BMC redfish server http://0.0.0.0:8002/redfish/v1
• Check PXE server http://0.0.0.0:8082/var/lib/tftpboot
• Log into Host CPU: ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -p 2210 [email protected]
• Log into Host BMC: ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -p 2208 [email protected]
• Log into xPU CPU: ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -p 2207 [email protected]
• Log into xPU BMC: ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -p 2209 [email protected]

You can also run the CI tests and log collection as follows:

./scripts/integration.sh tests
./scripts/integration.sh logs

Stop

./scripts/integration.sh stop

Stop - Red Hat

Note stop currently has an issue in this environment where you need to run it twice to fully clean up.

sudo ./scripts/integration.sh stop
sudo ./scripts/integration.sh stop