# KGrid Library
# Running the Library
Download the latest library jar from GitHub Latest Activator Release.
- Create a library directory
- Download kgrid-library-#.#.#.jar
- Place the kgrid-library-#.#.#.jar into the library
- Create a directory named shelf in the new library directory
Directory structure should look similar to the following
└── library
└── shelf
└── kgrid-library-#.#.#.jar
The library is executable jar and can be run from the command line. Open a terminal window and navigate to the directory where the jar and shelf are located.
Type in the following.
java -jar kgrid-library-#.#.#.jar
By default the activator will run on port 8080. You can validate the activator is up and running using the library health endpoint. The health of the Library should display a status of UP.
{
status: "UP",
userDetailService: {
status: "UP",
number of users: 2
} ,
ezidService: {
status: "UP",
ezid.base.url: "https://ezid.lib.purdue.edu/",
ezid.mock: "false"
},
shelf: {
status: "UP",
kgrid.shelf.cdostore.url: "/Users/me/library/shelf"
},
diskSpace: {
status: "UP",
total: 402672611328,
free: 269428576256,
threshold: 10485760
},
db: {
status: "UP",
database: "H2",
hello: 1
}
}
Now simply navigate to the KGrid Library.
# Configuration
There are several settings that you can control on the Library.
Library Knowledge Object Shelf Location
By default the activator will look for a shelf in jar execution directory but the location the shelf can be configured:
java -jar kgrid-library-1.2.2.jar --kgrid.shelf.cdostore.url=filesystem:file:///data/myshelf
java -jar kgrid-library-1.2.2.jar --kgrid.shelf.cdostore.url=filesystem:file:///c:/Users/me/myshelf
Library Server Port
To change the port:
java -jar kgrid-library-1.2.2.jar --server.port=9090