Skip to content

Configuration

Erik Ostermueller edited this page Jan 17, 2023 · 12 revisions

Setting JAVA_HOME

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

Install

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

Configuration

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).

Example file:

{ "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" }

Clone this wiki locally