Install the Single-User Demonstration Package

Install the Single-User Demonstration Package
You can install and run
Layer7 Live API Creator
on your computer for your local development by installing the single-user demonstration package of
Layer7 Live API Creator
that is based on Jetty (the demonstration package).
The following video demonstrates how to install the single-user demonstration package of
Layer7 Live API Creator
.

In this article:
3
Verify the Prerequisites for Installation
Before you install this demonstration package, ensure that you have completed the following prerequisite steps:
  • You have installed the Java SE Development Kit (JDK) version that
    Layer7 Live API Creator
    supports.
    For more information:
  • You have created a
    JAVA_HOME
    environment variable and set the value to point to the JDK installation directory.
    If you have not already done this, complete the following based on your operating system:
    (Windows)
    Set the value for the
    JAVA_HOME
    environment variable as the path to your JDK installation. If you did not change the path during installation, it is something like
    C:\Program Files\Java\jdk1.8.0_201
    . If the path contains spaces, use the shortened path name, for example,
    C:\PROGRA~2\Java\jdk1.8.0_201
    . Close and re-open any command line windows that you had open before you made these changes, since you cannot reload environment variables from an active command prompt. If the changes do not take effect after reopening the command window, restart Windows.
    (Mac)
    From terminal, set the
    JAVA_HOME
    environment variable using the following command:
    export JAVA_HOME=/Library/Java/Home
  • You have downloaded the demonstration package from the trial page or you have obtained the package from your Broadcom Sales team.
  • You have at least 500 MB of free disk space.
  • If you plan to connect to a MySQL database and you do not require both the MySQL and the MariaDB drivers, complete the following:
    1. Delete the MariaDB JDBC driver (the JAR file) that is included with the demonstration package by issuing the following command:
      $rm {InstallationDir}/CALiveAPICreator/lib/ext/mariadb-java-client-2.3.0.jar
    2. Copy the
      mysql-connector-java-<version>-bin.jar
      JAR file (the JDBC driver) to the
      {InstallationDir}/CALiveAPICreator/lib/ext/
      directory.
    Otherwise, if you require connections to MySQL and MariaDB databases, modify the MySQL data source by adding the
    disableMariaDbDriver
    option.
Install the Demonstration Package
  1. Create a local directory called
    lac
    .
  2. Copy the demonstration package (the zip file) into this local directory.
  3. Unzip the file.
Your local
lac
directory should look similar to the directory that is shown in the following image:
UnzipJetty.png
The demonstration package is installed.
Run
Layer7 Live API Creator
Complete the following procedures after you have installed the demonstration package.
Start API Server
  1. From a command line or Terminal, change directories to the location of the demonstration package by issuing the following command:
    cd lac/CALiveAPICreator-Jetty-5.4.00.15
  2. Start API server by issuing the following command:
    (Windows)
    start.bat
    (Unix/Mac)
    sh Start.sh
API Server is started.
Log in to API Creator
  1. Enter the following URL into a web browser window:
    http://localhost:8080/APICreator
    This installation assumes that the port is 8080, but you can change it to another port.
    For more information about how to adjust the port that
    Layer7 Live API Creator
    runs on, see the "Adjust the Port that Live API Creator Runs On" section.
    The API Creator logon authentication dialog opens.
  2. Log in to API Creator as the API developer (
    admin
    ) user. Complete the following fields, and then click
    Login
    :
    Username
    Enter
    admin
    as the username for the initial API developer.
    Password
    Enter
    Password1
    as the password for the initial API developer.
  3. If this is your first time logging in to API Creator, accept the terms of the End User License Agreement (EULA).
    You must accept these terms before you can use API Creator.
    You are logged in to API Creator. The landing page is the APIs page.
    Screen Shot 2019-03-11 at 4.27.21 PM.png
    From this page you can access the Learning Center (by clicking the
    Learning Center
    tile) and the API samples that are included with this installation (by clicking an API tile).
  4. Get started by clicking
    Quick Start
    tab in the Context help that is open on the right.
    For more information about the Quick Start, see Quick Start.
Troubleshooting
Complete the following procedures if you experience issues with installing the demonstration package or logging in to API Creator.
Adjust the Port that Live API Creator Runs On
If you are running an application on your machine that is already using port 8080, you can get port conflict issues when logging in to API Creator. The following error message appears:
Caused by: java.net.BindException: Address already in use at sun.nio.ch.Net.bind0(Native Method)
at sun.nio.ch.Net.bind(Net.java:437)
at sun.nio.ch.Net.bind(Net.java:429)
You can adjust the port that
Layer7 Live API Creator
runs on. Open (for Mac) the
Start.sh
or (for Windows) the
Start.bat
script, alter the port number for the
LAC_PORT
value, for example, to
8181
, and then save your changes. When logging in to API Creator, use this port in the URL.
For the example of adjusting the port that
Layer7 Live API Creator
runs on to
8181
, log in to API Creator by entering the following URL into a web browser window:
http://localhost:8181/APICreator
Check the Java Version
You can check your Java version and whether you have JDK installed by starting a command line/terminal and issuing the following commands:
java -version (checks that Java is installed and available)
javac -version (checks that the JDK is installed)