1.3.2.1 Deploying to Apache Tomcat
The example in this topic shows how to deploy the graph server as a web application with Apache Tomcat.
The graph server will work with Apache Tomcat 9.0.x.
- Download the Oracle Graph Webapps zip file from Oracle Software Delivery Cloud. This file contains ready-to-deploy Java web application archives (
.war
files). The file name will be similar to this:oracle-graph-webapps-<version>.zip
. - Unzip the file into a directory of your choice.
- Locate the
.war
file that follows the naming pattern:graph-server-<version>-pgx<version>.war
. - Configure the graph server.
- Modify authentication and other server settings by modifying the
WEB-INF/classes/pgx.conf
file inside the web application archive. See User Authentication and Authorization section for more information. - Optionally, change logging settings by modifying the
WEB-INF/classes/logback.xml
file inside the web application archive. - Optionally, change other servlet specific deployment descriptors by modifying the
WEB-INF/web.xml
file inside the web application archive.
- Modify authentication and other server settings by modifying the
- Copy the
.war
file into the Tomcatwebapps
directory. For example:cp graph-server-<version>-pgx<version>.war $CATALINA_HOME/webapps/pgx.war
Note:
The name you give the war file in the Tomcatwebapps
directory determines the context path of the graph server application. It is recommended naming the war file aspgx.war
. - Configure Tomcat specific settings, like the correct use of TLS/encryption.
- Ensure that port 8080 is not already in use.
- Start Tomcat:
cd $CATALINA_HOME ./bin/startup.sh
The graph server will now listen on
localhost:8080/pgx
.You can connect to the server from JShell by running the following command:
$ <client_install_dir>/bin/opg4j --base_url https://localhost:8080/pgx -u <graphuser>
Related Topics
Parent topic: Deploying Oracle Graph Server to a Web Server