Repository navigation
Configuration
Per the architecture page, there are three main components to load-test-in-a-box: agent, SUT, load generator. Here's how to specify the JVM of each:
| load-test-in-a-box Component | Technique for selecting JVM |
|---|---|
| agent | invoke the java executable of your choice when launching the agent uber jar, load-test-in-a-box_agent-0.0.3.jar |
| SUT (System Under Test} | Use JAVA_HOME to configure which JVM is used for the SUT. |
| Load Generator (JMeter) | Use JAVA_HOME, per this JMeter doc |
Instructions for setting JAVA_HOME
Running load-test-in-a-box (java -jar load-test-in-a-box_agent-0.0.3.jar) creates a folder named .load-test-in-a-box in the current user's home directory ($HOME or %USERPROFILE%) and a number of subfolders are created there. This is where the load-test-in-a-box "system under test" is launched from. load-test-in-a-box checks for these subfolders every time it launches, and replaces them (and their contents) if they're absent.
.load-test-in-a-box
├── apache-maven-3.6.2
├── data
├── glowroot
├── jmeterFiles
├── log
├── processManager
├── repository
├── sutApp
└── wiremock
After 'java -jar load-test-in-a-box_agent-0.0.3.jar' launches, the install process create load-test-in-a-box.json in the .load-test-in-a-box folder. This is the main configuration file. After any changes to this file, load-test-in-a-box must be restarted.
Documentation for selected elements:
-
mavenOnline - Set this to true when compiling/building load-test-in-a-box for your self, so maven dependencies are downloaded. By default, all dependencies for the fully packaged/released snail4j uber jar should be installed into .snail4j/repository. Default value: false.
-
snail4jMavenRepo - Set this to true when you want the SUT and Load Generator to use the maven repo packaged in the .snail4j/repository. When 'false', the default maven local repo is used. Default value: true.
-
loadGenerationThreads - The number of concurrent threads of load configured in the load generator ( which is currently JMeter).
{
"sutAppZipFileName" : "sutApp.zip",
"loadGenerationThreads" : 3,
"loadGenerationTargetPort" : 8080,
"loadGenerationRampupTimeInSeconds" : 3,
"loadGenerationDurationInSeconds" : 3600,
"loadGenerationTargetHost" : "localhost",
"mavenExePath" : "/Users/erikostermueller/.snail4j/apache-maven-3.6.2/bin/mvn",
"mavenOnline" : false,
"javaHome" : "file:///Library/Java/JavaVirtualMachines/jdk-9.0.1.jdk/Contents/Home/",
"mavenHome" : "file:///Users/erikostermueller/.snail4j/apache-maven-3.6.2",
"userHomeDir" : "file:///Users/erikostermueller/",
"maxExceptionCountPerEvent" : 100,
"mavenZipFileNameWithoutExtension" : "apache-maven-3.6.2",
"mavenRepositoryHome" : "file:///Users/erikostermueller/.snail4j/repository",
"processManagerZipFileName" : "processManager.zip",
"systemUnderTestStdoutLogFileName" : "systemUnderTest.log",
"loadGeneratorStdoutLogFileName" : "loadGenerator.log",
"h2DataFileName" : "perfSandboxDb.mv.db",
"h2DataFileHome" : "file:///Users/erikostermueller/.snail4j/data",
"jmeterFilesZipFileName" : "jmeterFiles.zip",
"loadGeneratorLaunchCmd" : "#{mavenExePath} --offline -f #{jmeterFilesHome}/pom-load.xml -Pno-gui clean verify -Dsnail4j.jmeter.port=#{jmeterNonGuiPort} -Dmaven.repo.local=#{mavenRepositoryHome} -Djmeter.test=#{jmeterFilesHome}/load.jmx -DmyHost=#{loadGenerationTargetHost} -DmyPort=#{loadGenerationTargetPort} -DmyDurationInSeconds=#{loadGenerationDurationInSeconds} -DmyRampupInSeconds=#{loadGenerationRampupTimeInSeconds} -DmyThreads=#{loadGenerationThreads}",
"processManagerLaunchCmd" : "#{mavenExePath} -Dsnail4j.maven.offline.passthru=--offline --offline -Dmaven.repo.local=#{mavenRepositoryHome} verify", "processManagerHome" : "file:///Users/erikostermueller/.snail4j/processManager",
"logDir" : "file:///Users/erikostermueller/.snail4j/log",
"sutKillFile" : "file:///Users/erikostermueller/.snail4j/deleteMeToStopSnail4jSut.txt",
"jmeterNonGuiPort" : 4455,
"glowrootZipFileName" : "glowroot-0.13.5-dist.zip",
"snail4jHome" : "file:///Users/erikostermueller/.snail4j/",
"sutAppHome" : "file:///Users/erikostermueller/.snail4j/sutApp",
"wiremockFilesZipFileName" : "wiremockFiles.zip",
"wiremockFilesHome" : "file:///Users/erikostermueller/.snail4j/wiremock",
"jmeterFilesHome" : "file:///Users/erikostermueller/.snail4j/jmeterFiles",
"glowrootHome" : "file:///Users/erikostermueller/.snail4j/glowroot"
}