Skip to content
LICENSEWARE Help
Sign in

Collect Java installations

The Java collector is a separate tool from the Licenseware Collector agent. It finds Java installations and how they are started, which is what Oracle Java Deployment Manager needs before it can say whether an install needs a license.

Each row in the file it writes is one Java installation: the host, the binary path, whether it is a JDK or a JRE, the Java home, and the JVM vendor and version. It also records whether that process is running, and the command line it was started with. The default file name is report.csv in the directory you run it from.

Download the binary for your OS from the OJDM collector releases.

  • On Windows, run ojdm-collector.exe.
  • On Linux or macOS, run ./ojdm-collector. If the shell refuses, run chmod +x ojdm-collector first.

-output-path sets the report file. The default is report.csv. -search-paths is a comma-separated list of directories to search.

ojdm-collector -output-path=/path/to/output.csv
ojdm-collector -search-paths=/opt,/oracle,/usr
ojdm-collector -search-paths=/opt,/oracle -output-path=/tmp/java_report.csv

With no -search-paths, Windows looks in %LOCALAPPDATA%, C:\Program Files and C:\Program Files (x86). Linux and macOS look in /home, /usr/bin, /usr/local, /usr/lib, /usr/share, /opt, /snap, /oracle and /bin.

If no running Java processes are reported, the collector did not find jinfo or jps. Put an OpenJDK or a JDK that includes those tools on a default path, or on a path you passed to -search-paths. Without them, process-level evidence is missing, and that evidence is what decides whether the install is licensable.

Upload the file to the OJDM Collector source. Setup for that source is on Data sources.

The Licenseware Collector agent, for general hardware and software inventory, is documented at licenseware-collector.com.