github
/
OpenID-Connect-Java-Spring-Server
mirror of https://github.com/mitreid-connect/OpenID-Connect-Java-Spring-Server
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

added instructions for #544

master
Justin Richer 2014-01-14 06:59:31 -08:00
parent a3eb045cc7
commit ea97b95ef8
1 changed files with 18 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
Build-Instructions.md

@ -63,10 +63,25 @@ The project uses JCE through BouncyCastle which may require special installation
3. Install the new policy files per the README file included in the download. The download contains new versions of local_policy.jar and US_export_policy.jar. These files must be placed in your jre/lib/security folder(s - multiple on Windows), replacing the current files. If you wish to at some point revert back to your original policy files, store the original files elsewhere.
# Deploying with Tomcat
# Deploying the Server Webapp
To deploy the Server, copy the generated .war file to the tomcat `webapps` directory, such as:
The `openid-connect-server-webapp` module will produce a packaged `WAR` file that can be deployed to a number of different servlet containers. To configure the server for local use, see the [Server Configuration](Server-configuration) documentation. Most importantly, the `issuer` value in the server configuration bean needs to be set to the URL that the server can be accessed from. The default value for the `issuer` is `http://localhost:8080/openid-connect-server-webapp/`.
## Deploying with Jetty
The server webapp can be deployed using an embedded Jetty instance inside of Maven. To deploy to Jetty, first install the application to your local Maven repository by running this from the parent project directory:
`mvn clean install`
To run the embedded Jetty server and deploy the server webapp, run the following command from the `openid-connect-server-webapp` directory (**important: do not run this command from the parent project directory**).
`mvn jetty:run`
This will deploy the server to `http://localhost:8080/openid-connect-server-webapp/`.
## Deploying with Tomcat
The server webapp has been tested with Tomcat 6 and Tomcat 7. To deploy the server to Tomcat (or a similar servlet container), copy the generated .war file to the appropriate Tomcat `webapps` directory, such as:
`cp openid-connect-server-webapp/target/openid-connect-server.war /var/lib/tomcat6/webapps`
To configure the server for local use, see the [Server Configuration](Server-configuration) documentation. Most importantly, the `issuer` value in the server configuration bean needs to be set to the URL that the server can be accessed from. The default value for the `issuer` is `http://localhost:8080/openid-connect-server-webapp/`.