README.md

© Copyright 2018-2020 Hewlett Packard Enterprise Development LP Licensed under Apache License version 2.0: http://www.apache.org/licenses/LICENSE-2.0

What is simulap-plugin-sip?

simulap-plugin-sip, brings SIP (RFC 3261) connectivity to Apache JMeter.

How to get simulap-plugin-sip source code?

Prerequisites:

• git must be installed on your local system and you must be familiar with git CLI: see https://git-scm.com/.
• You must know how to fork, clone a repository on GitHub: see https://help.github.com/.

Step 1: fork https://github.com/SIMULAP/simulap-plugin-sip

You obtain a new public GitHub repository: https://github.com/MY_USERNAME/simulap-plugin-sip. In the following, https://github.com/SIMULAP/simulap-plugin-sip is called the upstream while https://github.com/MY_USERNAME/simulap-plugin-sip is called the origin.

Step 2: create a local clone of https://github.com/MY_USERNAME/simulap-plugin-sip

prompt> git clone  git@github.com:MY_USERNAME/simulap-plugin-sip.git

Result:

A new directory has been created (simulap-plugin-sip) containing the source code for simulap-plugin-sip plug-in.

How to build simulap-plugin-sip?

Prerequisites:

• Maven must be installed on your system. See https://maven.apache.org/.

Step 1:

Copy bin/upgrade.properties.sip content into your JMeter's bin/upgrade.properties file.

Step 2:

> cd simulap-plugin-sip
> mvn -X clean package 

Result:

A new directory has been created (simulap-plugin-sip/target) containing the jar file simulap-plugin-sip-0.0-00.jar.

How to start Apache JMeter with simulap-sip-plugin?

Prerequisites:

• Apache JMeter must be installed on your system: see http://jmeter.apache.org/.
• In the following, JMETER_HOME is the Apache JMeter home directory.

Step 1:

> cd simulap-plugin-sip
> mvn -X install -Djmeter.command=JMETER_HOME/bin/jmeter 

How to create a SIP Test plan with simulap-sip-plugin and Apache JMeter?

Please refer to simulap-plugin-sip GitHub wiki pages.