Versions Compared

Version Old Version 8 New Version 9
Changes made by

bcarlsen (Unlicensed)

bcarlsen (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Step 8

Deploy the term-server--rest.war file to a Tomcat server - either through Eclipse or a standalone tomcat installation.

...

  • Download and install apache tomcat 7 in c:/apache-tomcat-XXXX
  • In Eclipse use the J2EE perspective and click on the "Servers" tab.
  • From here, you can add a server which simply involves pointing Eclipse to the install directory.
  • You can right-click on term-server-rest.war file and use "Run As->Run on Server" to deploy to Tomcat.
    • NOTE: sometimes in Eclipse this doesn't work and the tomcat does not properly recognize or deploy the app.
    • In this event, double-click on the tomcat server installation in the servers tab.
    • In the configuration screen click "Open launch configuration"

    • There, look on the Arguments tab and find the -D setting for "catalina.base", e.g.

      Code Block
      -Dcatalina.base="C:\Users\Brian Carlsen\workspace-luna\.metadata\.plugins\org.eclipse.wst.server.core\tmp0"
    •  If you open this directory you'll see a "webapps" folder.  To deploy you simply build and copy term-server-rest.war to that directory and launch the server in Eclipse.

  • The Tomcat server needs to be able to find the run configuration. Double-click on the Tomcat server you installed, open the launch configuration and add a this setting:

    Code Block
    -Drun.config=/path/to/your/config.properties

...

http://localhost:8080/term-server-rest/index.html

This should be a "swagger" Api documenting the current state of the API.  Everything is still configured to use security so you'd need to at least authenticate and then the other methods would be available using "admin" as the auth token. I'll check if this works... You should be able to test services by using "guest" as the authToken parameter.