JSON RPC Java client (vdsm-jsonrpc-java) for oVirt

Welcome to the vdsm-jsonrpc-java source repository.

Building from Source

This package uses the standard autotools build system.

Prerequisites

• Java 11+ SDK
• Maven 3.6+
• autotools (autoconf, automake)

Build Steps

$ autoreconf -ivf
$ ./configure
$ make
$ make install

The Java SDK artifacts are available for distribution-specific installation at $(builddir)/target.

Maven Central Publishing

To create a new release available on Maven Central one should provide a settings.xml file in the .m2 folder following the structure:

<settings>
    <servers>
        <server>
            <id>central</id>
            <username>${mvn_central_generated_username}</username>
            <password>${mvn_central_generated_pwd}</password>
        </server>
    </servers>
    <profiles>
        <profile>
            <id>central</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <gpg.executable>gpg2</gpg.executable>
                <gpg.passphrase>${gpg_passphrase}</gpg.passphrase>
            </properties>
        </profile>
    </profiles>
</settings>

After that all version tags need to be updated, that can be done using:

$ mvn release:prepare

For publishing artifacts to Maven Central (The sign profile is not required for SNAPSHOT versions):

$ mvn clean deploy -Psign

Note

Snapshot versions do currently have a shelf life of 90 days on maven central.

How to contribute

Submitting patches

Patches are welcome!

Please submit patches to GitHub:vdsm-jsonrpc-java.

Found a bug or documentation issue?

To submit a bug or suggest an enhancement for vdsm-jsonrpc-java please use GitHub issues

If you find a documentation issue on the oVirt website please navigate and click "Report an issue on GitHub" in the page footer.

Still need help?

If you have any other questions, please join oVirt Users forum / mailing list and ask there.