This page documents how to get CLAMP up and running on a local machine and also how to get CLAMP loaded and set up in an IDE. We may use the information on this page as input for a page in the CLAMP documentation.

...

1. Import the CLAMP project into your IDE

2. Eclipse only: Add the following Eclipse profile to pom.xml for Eclipse m2e support, then run Maven->Update

   Code Block
   language xml linenumbers true collapse true
   <profile> <!--This profile is used to store Eclipse m2e settings only. It has no influence on the Maven build itself. --> <id>only-eclipse</id> <activation> <property> <name>m2e.version</name> </property> </activation> <build> <pluginManagement> <plugins> <plugin> <groupId>org.eclipse.m2e</groupId> <artifactId>lifecycle-mapping</artifactId> <version>1.0.0</version> <configuration> <lifecycleMappingMetadata> <pluginExecutions> <pluginExecution> <pluginExecutionFilter> <groupId>de.jpdigital</groupId> <artifactId>hibernate52-ddl-maven-plugin</artifactId> <versionRange>[2.2.0,)</versionRange> <goals> <goal>gen-ddl</goal> </goals> </pluginExecutionFilter> <action> <execute /> </action> </pluginExecution> <pluginExecution> <pluginExecutionFilter> <groupId>org.codehaus.groovy.maven</groupId> <artifactId>gmaven-plugin</artifactId> <versionRange>[1.0,)</versionRange> <goals> <goal>execute</goal> </goals> </pluginExecutionFilter> <action> <execute /> </action> </pluginExecution> <pluginExecution> <pluginExecutionFilter> <groupId>org.codehaus.mojo</groupId> <artifactId>exec-maven-plugin</artifactId> <versionRange>[1.3.2,)</versionRange> <goals> <goal>exec</goal> </goals> </pluginExecutionFilter> <action> <execute /> </action> </pluginExecution> <pluginExecution> <pluginExecutionFilter> <groupId>com.github.eirslett</groupId> <artifactId>frontend-maven-plugin</artifactId> <versionRange>[1.8.0,)</versionRange> <goals> <goal>npm</goal> </goals> </pluginExecutionFilter> <action> <execute /> </action> </pluginExecution> </pluginExecutions> </lifecycleMappingMetadata> </configuration> </plugin> </plugins> </pluginManagement> </build> </profile>

   
   

Running unit tests locally

In order to run the unit tests locally, you need to run an instance of MariaDB and an instance of the emulator for the REST endpoints CLAMP uses. You also need to set the values some variables in a number of configuration files. These values are automatically generated in the maven build but need to be set manually when running tests locally.

1. Open a console and go into the directory extra/bin-for-dev

   Code Block
   language bash
   cd extra/bin-for-dev

   
   

2. Start an instance of the CLAMP MaraDB database in Docker using the helper script. This script uses docker-compose to bring up an instance of the CLAMP MariaDB.

   Code Block
   language bash
   ./start-db.sh

   
   

3. Start an instance of the CLAMP endpoint emulator in Docker using the helper script. This script uses docker-compose to bring up an instance of the CLAMP endpoint emulator.

   Code Block
   language bash
   ./start-emulator.sh

   
   

4. Check that the database and emulator are running

   Code Block
   language bash
   docker ps

   You should see the two images running

   Code Block
   language bash
   CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 93cffd7e7d2e python:2-slim "/bin/sh -c 'pip ins…" 7 seconds ago Up 7 seconds 0.0.0.0:8085->8085/tcp clamp_third-party-proxy_1 0b26d68f4048 mariadb:10.5.4 "docker-entrypoint.s…" About a minute ago Up About a minute 0.0.0.0:3306->3306/tcp clamp_db_1

   
   

5. In the file src/test/resources/application.properties, run this sed command or make the changes below in a text editor:

   Code Block
   language bash
   sed -e 's/${clamp\.it\.tests\.http}/8080/g' -e 's/${docker\.http-cache\.port\.host}/8085/g' -e 's/${docker\.mariadb\.port\.host}/3306/g' -i src/test/resources/application.properties

   
   

   1. Change all occurrences of the string "${clamp.it.tests.http}" to "8080"
   2. Change all occurrences of the string "${docker.http-cache.port.host}" to "8085"
   3. Change all occurrences of the string "${docker.mariadb.port.host}" to "3306"

6. In the file src/test/resources/https/https-test.properties, run this sed command or make the changes below in a text editor:

   Code Block
   language bash
   sed -e 's/${clamp\.it\.tests\.https}/8090/g' -e 's/${clamp\.it\.tests\.http-redirected}/8080/g' -e 's/${docker\.mariadb\.port\.host}/3306/g' -i src/test/resources/https/https-test.properties

   
   

   1. Change all occurrences of the string "${clamp.it.tests.https}" to "8090" (Any free port value)
   2. Change all occurrences of the string "${clamp.it.tests.http-redirected}" to "8080"
   3. Change all occurrences of the string "${docker.mariadb.port.host}" to "3306"

7.  In the file src/test/resources/robotframework/robotframework-test.properties, run this sed command or make the changes below in a text editor:

   Code Block
   language bash
   sed -e 's/${clamp\.it\.tests\.robotframework\.http}/8080/g' -e 's/${docker\.http-cache\.port\.host}/8085/g' -e 's/${docker\.mariadb\.port\.host}/3306/g' -i src/test/resources/robotframework/robotframework-test.properties

   
   

   1. Change all occurrences of the string "${clamp.it.tests.robotframework.http}" to "8080" (Any free port value)
   2. Change all occurrences of the string "${docker.http-cache.port.host}" to "8085"
   3. Change all occurrences of the string "${docker.mariadb.port.host}" to "3306"

Building ControlLoop docker images in CLAMP

Control loop docker images are built in clamp/packages and pushed to ONAP nexus docker registry nexus3.onap.org:10003
using maven command.

Steps are depicted as below:

1. Open a console and go into the directory clamp/packages

   Code Block
   $cd clamp/packages

   
   

2. Run below command

   Code Block
   $mvn clean install -P docker

   Note: This command when run from clamp main directory will build all docker images of Clamp. When run in clamp/packages folder will build
   ControlLoop docker images alone.

3. There is a fabric8, docker-maven-plugin in clamp/packages/policy-clamp-docker/pom.xml which builds 3 docker images and pushes to ONAP nexus docker registry nexus3.onap.org:10003

   Code Block
   onap/policy-clamp-cl-runtime onap/policy-clamp-cl-k8s-ppnt onap/policy-clamp-cl-http-ppnt onap/policy-clamp-cl-pf-ppnt

   
   

4. Configuration to build docker images is present in following files

   Code Block
   $cd clamp/packages/policy-clamp-docker/src/main/docker

   
   

5. Docker images once built can be brought up manually on localhost using docker commands, or through docker-compose in CSIT
   Clone policy docker repo

   Code Block
   $cd docker/csit/ $./run-project-csit.sh clamp

   Note: More detailed information on CSIT is in Testing CLAMP

6. Docker images from docker-compose file in /policy/docker/csit for clamp

   Code Block

   $docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES b2266ab66cbc onap/policy-clamp-cl-runtime:latest "/opt/app/policy/bin…" 28 seconds ago Up 27 seconds 6970/tcp policy-controlloop-runtime c6475277e750   policy-clamp-cl-pf-ppnt:latest "/opt/app/policy/bin…" 29 seconds ago Up 28 seconds 6972/tcp policy-participant 5a83596fd963 nexus3.onap.org:10001/onap/policy-api:2.5-SNAPSHOT-latest "./wait_for_port.sh …" 30 seconds ago Up 29 seconds 6969/tcp policy-api 77746467d139   onap/policy-clamp-cl-k8s-ppnt:latest "/opt/app/policy/bin…" 30 seconds ago Up 29 seconds 6971/tcp kubernetes-participant 6053cdad35fd nexus3.onap.org:10001/onap/policy-models-simulator:2.5-SNAPSHOT-latest "bash simulators.sh" 31 seconds ago Up 30 seconds 3905/tcp, 6666/tcp, 6668-6670/tcp simulator 17cf42071531 nexus3.onap.org:10001/mariadb:10.5.8 "docker-entrypoint.s…" 32 seconds ago Up 30 seconds 3306/tcp mariadb