KB Test

Step-by-step guide to validate the SCANOSS Engine and Knowledge Base (LDB) in an on-premise installation.

The validation is divided into two parts:

• Validating the Server and LDB
• Validating the API and Load Balancer from a Client

Validating the Server and LDB

These tests ensure that the scanning engine is operational and that versioning information is correctly collected.

Create a sample WFP file to be scanned

echo -e "file=aff32ef2847f81abc62da10769bff43f,421,test\n4=369450fc\n5=bf7226a9\n7=b04dd861\n8=9727e3cd\n10=2152ba16" > sample.wfp

Scan the sample WFP file using the local engine

scanoss sample.wfp

Validate the JSON result

scanoss sample.wfp | jq

If you receive a match in the output, your Knowledge Base is installed correctly.

Validating the API and Load Balancer from a Client

This part verifies that the API, Load Balancer, Engine and Python client can communicate correctly.

Install the SCANOSS Python client

pip3 install scanoss

Unpack the supplied acceptance test package

unzip scanoss-acceptance-test.zip

Run the acceptance test script and collate results

bash runTest.sh -u http://<SCANOSS-IP>:4443/api/scan/direct

Replace <SCANOSS-IP> with the hostname or IP of your API server / Load Balancer.

Package the test results and send to SCANOSS

tar cvzf customer-test-results.tgz output

The test results are saved in the output folder.

Package the results into an archive and send it to SCANOSS support: [e-mail].