Versions Compared

Key

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

...

Table of Contents
maxLevel34
minLevel4

Tip
titleBefore you begin!
  • To ensure you get the full understanding of configuring Email OTP with WSO2 IS, the sample travelocity application is used in this use case. The samples run on the Apache Tomcat server and are written based on Servlet 3.0. Therefore, download Tomcat 7.x from here.
  • Install Apache Maven to build the samples. For more information, see Installation Prerequisites.
Excerpt

Download the samples

To be able to deploy a sample of Identity Server, you need to download it onto your machine first. 

Follow the instructions below to download a sample from GitHub.

  1. Create a folder in your local machine and navigate to it using your command line.
  2. Run the following commands.

    Code Block
    languagebash
    mkdir is-samples
    cd is-samples/
    git init
    git remote add -f origin https://github.com/wso2/product-is.git
    Code Block
    languagebash
    git config core.sparseCheckout true
  3. Navigate into the .git/info/ directory and list out the folders/files you want to check out using the echo command below.  

    Code Block
    languagebash
    cd .git
    cd info
    echo "modules/samples/" >> sparse-checkout
  4. Navigate out of .git/info directory and checkout the v5.4.0 tag to update the empty repository with the remote one. 

    Code Block
    languagebash
    cd ..
    cd ..
    git checkout -b v5.4.0 v5.4.0

    Access the samples by navigating to the  is-samples/modules/samples  directory.

Deploy the sample web app

Deploy this sample web app on a web container.

  1. Use the Apache Tomcat server to do this. If you have not downloaded Apache Tomcat already, download it from here
  2. Copy the .war file into the  webapps  folder. For example,  <TOMCAT_HOME>/apache-tomcat-<version>/webapps .
  3. Start the Tomcat server.

To check the sample application, navigate to http://<TOMCAT_HOST>:<TOMCAT_PORT>/travelocity.com/index.jsp on your browser.

For example, http://localhost:8080/travelocity.com/index.jsp.

Note

Note: It is recommended that you use a hostname that is not localhost to avoid browser errors. Modify the /etc/hosts entry in your machine to reflect this. Note that localhost is used throughout thisdocumentation as an example, but you must modify this when configuring these authenticators or connectors with this sample application.