diff --git a/MAINTAINER_NOTES.md b/MAINTAINER_NOTES.md index 070108a7..25bca487 100644 --- a/MAINTAINER_NOTES.md +++ b/MAINTAINER_NOTES.md @@ -11,10 +11,26 @@ Use the [Versions Maven Plugin](https://www.mojohaus.org/versions-maven-plugin/i ## Release ``` -./mvnw release:prepare -DreleaseVersion=0.17.1 -DdevelopmentVersion=0.17.2-SNAPSHOT -./mvnw release:perform -DreleaseVersion=0.17.1 -DdevelopmentVersion=0.17.2-SNAPSHOT +./mvnw release:prepare -DreleaseVersion=0.17.2 -DdevelopmentVersion=0.17.2-SNAPSHOT +./mvnw release:perform -DreleaseVersion=0.17.2 -DdevelopmentVersion=0.17.2-SNAPSHOT ``` `release:prepare` does Github tags and commits, while `release:perform` signs the artifacts and uploads them to the staging repositoring on [https://oss.sonatype.org](https://oss.sonatype.org). -After that, manually verify the uploaded artifacts on [https://oss.sonatype.org/#stagingRepositories](https://oss.sonatype.org/#stagingRepositories), click `Close` to trigger Sonatype's verification, and then `Release`. +Download the artifacts from the staging repository [https://oss.sonatype.org/#stagingRepositories](https://oss.sonatype.org/#stagingRepositories) and verify them manually: + +```sh +# agent +/usr/lib/jvm/java-11-openjdk/bin/java -javaagent:/home/fabian/Downloads/jmx_prometheus_javaagent-0.17.2.jar=12345:./integration_tests/smoke_tests/src/test/resources/config.yml -jar integration_tests/jmx_example_application/target/jmx_example_application.jar +/usr/lib/jvm/java-17-openjdk/bin/java -javaagent:/home/fabian/Downloads/jmx_prometheus_javaagent-0.17.2.jar=12345:./integration_tests/smoke_tests/src/test/resources/config.yml -jar integration_tests/jmx_example_application/target/jmx_example_application.jar +/usr/lib/jvm/jdk1.6.0_45/bin/java -javaagent:/home/fabian/Downloads/jmx_prometheus_javaagent_java6-0.17.2.jar=12345:./integration_tests/smoke_tests/src/test/resources/config.yml -jar integration_tests/jmx_example_application/target/jmx_example_application.jar + +# standalone +java -Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -jar integration_tests/jmx_example_application/target/jmx_example_application.jar + +/usr/lib/jvm/java-11-openjdk/bin/java -jar ~/Downloads/jmx_prometheus_httpserver-0.17.2.jar 9000 ./integration_tests/smoke_tests/src/test/resources/config-httpserver.yml +/usr/lib/jvm/java-17-openjdk/bin/java -jar ~/Downloads/jmx_prometheus_httpserver-0.17.2.jar 9000 ./integration_tests/smoke_tests/src/test/resources/config-httpserver.yml +/usr/lib/jvm/jdk1.6.0_45/bin/java -jar ~/Downloads/jmx_prometheus_httpserver_java6-0.17.2.jar 9000 ./integration_tests/smoke_tests/src/test/resources/config-httpserver.yml +``` + +If everything looks good, click `Close` to trigger Sonatype's verification, then click `Release`. \ No newline at end of file diff --git a/README.md b/README.md index 39203d89..44b9ac5a 100644 --- a/README.md +++ b/README.md @@ -14,14 +14,14 @@ Agent is thus strongly encouraged. ## Running the Java Agent The Java agent is available in two versions with identical functionality: -* [jmx_prometheus_javaagent-0.17.1.jar](https://repo1.maven.org/maven2/io/prometheus/jmx/jmx_prometheus_javaagent/0.17.1/jmx_prometheus_javaagent-0.17.1.jar) requires Java >= 7. -* [jmx_prometheus_javaagent-0.17.1_java6.jar](https://repo1.maven.org/maven2/io/prometheus/jmx/jmx_prometheus_javaagent_java6/0.17.1/jmx_prometheus_javaagent_java6-0.17.1.jar) is compatible with Java 6. +* [jmx_prometheus_javaagent-0.17.2.jar](https://repo1.maven.org/maven2/io/prometheus/jmx/jmx_prometheus_javaagent/0.17.2/jmx_prometheus_javaagent-0.17.2.jar) requires Java >= 7. +* [jmx_prometheus_javaagent-0.17.2_java6.jar](https://repo1.maven.org/maven2/io/prometheus/jmx/jmx_prometheus_javaagent_java6/0.17.2/jmx_prometheus_javaagent_java6-0.17.2.jar) is compatible with Java 6. Both versions are built from the same code and differ only in the versions of the bundled dependencies. To run as a Java agent, download one of the JARs and run: ``` -java -javaagent:./jmx_prometheus_javaagent-0.17.1.jar=12345:config.yaml -jar yourJar.jar +java -javaagent:./jmx_prometheus_javaagent-0.17.2.jar=12345:config.yaml -jar yourJar.jar ``` Metrics will now be accessible at [http://localhost:12345/metrics](http://localhost:12345/metrics). @@ -39,15 +39,15 @@ Example configurations can be found in the `example_configs/` directory. ## Running the Standalone HTTP Server The HTTP server is available in two versions with identical functionality: -* [jmx_prometheus_httpserver-0.17.1.jar](https://repo1.maven.org/maven2/io/prometheus/jmx/jmx_prometheus_httpserver/0.17.1/jmx_prometheus_httpserver-0.17.1.jar) requires Java >= 7. -* [jmx_prometheus_httpserver-0.17.1_java6.jar](https://repo1.maven.org/maven2/io/prometheus/jmx/jmx_prometheus_httpserver_java6/0.17.1/jmx_prometheus_httpserver_java6-0.17.1.jar) is compatible with Java 6. +* [jmx_prometheus_httpserver-0.17.2.jar](https://repo1.maven.org/maven2/io/prometheus/jmx/jmx_prometheus_httpserver/0.17.2/jmx_prometheus_httpserver-0.17.2.jar) requires Java >= 7. +* [jmx_prometheus_httpserver-0.17.2_java6.jar](https://repo1.maven.org/maven2/io/prometheus/jmx/jmx_prometheus_httpserver_java6/0.17.2/jmx_prometheus_httpserver_java6-0.17.2.jar) is compatible with Java 6. Both versions are built from the same code and differ only in the versions of the bundled dependencies. To run the standalone HTTP server, download one of the JARs and run: ``` -java -jar jmx_prometheus_httpserver-0.17.1.jar 12345 config.yaml +java -jar jmx_prometheus_httpserver-0.17.2.jar 12345 config.yaml ``` Metrics will now be accessible at [http://localhost:12345/metrics](http://localhost:12345/metrics).