File: using_jss.md

package info (click to toggle)
jss 5.5.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 8,204 kB
  • sloc: java: 73,154; ansic: 24,874; cpp: 4,414; sh: 873; xml: 402; python: 345; makefile: 28
file content (36 lines) | stat: -rw-r--r-- 1,585 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# Using JSS

Please make sure `libjss.so` is included in your library path or set it via
the `LD_LIBRARY_PATH` environment variable. See `man 8 ld.so` for more
information. Alternatively, this can be done by setting `-Djava.library.path`
to the directory with `libjss.so` on the command line of all Java programs
using JSS. Note that without `libjss.so`, using JSS in nearly any capacity
will fail.

## Classpath Dependencies

To use JSS in your project after installation, you'll need to ensure the
following dependencies are available in your `CLASSPATH`:

 - `jss.jar` -- provided by the `jss` package and installed to
   `/usr/lib/java/jss.jar`.
 - `slf4j-api.jar` -- provided by the `slf4j` package and installed to
   `/usr/share/java/slf4j/slf4j-api.jar`.
 - `apache-commons-lang.jar` -- provided by the `apache-commons-lang` package
   and installed to `/usr/share/java/apache-commons-lang.jar`.

Note that the above paths and packages are for Fedora; for a list of packages
in Debian, please see the [dependencies document](dependencies.md). Note that
paths might differ between various platforms and versions of Fedora.

## Developing against JSS

We recommend referring to the javadoc distribution generated when JSS was
installed. On Fedora-like systems, this is provided by the `jss-javadoc`
package; for an online version tracking master, please refer to our
[live instance](https://dogtagpki.github.io/jss/javadoc/index.html).

## More Information

For more information about using JSS, please see our documentation on loading
the [`JSSProvider`](usage/jssprovider.md).