tcserver-embed-example

• PURPOSE

To demonstrate the creation and use of a basic embedded tc Runtime instance using the Pivotal Commercial Maven Repository to pull down the tc Server artifacts in a Maven project.

• REQUIREMENTS
- Maven 2.2.1 installed
• PRE-BUILD
1. Create your own Pivotal Commercial Maven Repository (vCMR) account at https://commercial-repo.pivotal.io.
2. Add/Modify the pom.xml to add a repository as shown below and in the vCMR.

<repository>
	<id>tcserver-release-repo</id>
	<name>tc Runtime release repository</name>
	<url>https://commercial-repo.pivotal.io/data3/tcserver-release-repo/tcserver</url>
</repository>

3. Add/Modify the ~/.m2/settings.xml to add your username and password for the repository.

NOTE: Make sure the repository <id> and the server <id> match.

<settings>
  <servers>
  	...
    <server>
      <id>tcserver-release-repo</id>
      <username>!-- Username --!</username>
      <password>!-- Insert your decrypted password (which we don't have) --!</password>
    </server>
    ...
  </servers>
</settings>

• BUILD
mvn clean compile assembly:single
• USAGE
java -jar target/example-0.0.3-SNAPSHOT-jar-with-dependencies.jar
• Result
This will startup a self contained tc Runtime instance with a "Hello, World" webapp on port 8080. It will also listen on port 1099 for incoming jmx connections.

Additional Documentation

Full tc Server Documentation can me found at http://tcserver.docs.pivotal.io/

More on embedded tc Server can be found at http://tcserver.docs.pivotal.io/docs-tcserver/topics/postinstall-getting-started.html#postinstall-embedding-tc-server