Install the Single-User Demonstration Package

Install the Single-User Demonstration Package
calac41
You can install the single-user demonstration package of 
CA Live API Creator
 that is based on Jetty (demonstration package) to run in a small footprint, installed on your computer. Using this demonstration package is a convenient way to try out 
CA Live API Creator
 or to develop locally. To facilitate learning and experimentation for team development, install it on a centralized server.
The demonstration package is only for development.
The 
B2B Pavlov
B2B Northwind
Sample
Demo
Marketing
, and the 
Marketing - Accounting
 API samples are included with the single-user demonstration package. No additional steps are required to load these API samples.
For more information about these API samples, see API Samples.
The following video demonstrates how to install the single-user demonstration package of 
CA Live API Creator
.

In this article:
2
Installing the demonstration package involves installing API Server. Follow the installation best practices for installing API Server. For more information, see Installation Best Practices.
CA Live API Creator
 requires the corresponding JDBC driver to the database management system (DBMS) you use as your backend data source. This demonstration package includes the following JDBC drivers:
  • MySQL JDBC driver
  • JavaDB/Apache Derby JDBC driver
  • PostgreSQL JDBC driver
  • Salesforce JDBC driver
  • Apache HBase JDBC driver
  • SAP NetWeaver JDBC driver
  • Apache Cassandra JDBC driver
  • CSV JDBC driver
You can connect to other backend data sources where the demonstration package does not include the JDBC driver.
For more information about how to install other JDBC drivers, see the "(Optional) Install Other JDBC Drivers" section.
This demonstration package uses Apache Derby as the admin database and includes the Jetty application server. You can manage the content in your data source using Derby as your admin database.
Verify the Prerequisites for Installation
Before you install this demonstration package, ensure that you have completed the following steps:
  • You have Java SE Development Kit (JDK) installed.For more information:
    You can verify your Java version 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)
  • 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_92
    . If the path contains spaces, use the shortened path name, for example, 
    C:\PROGRA~2\Java\jdk1.8.0_92
    . 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 at least 500 MB of free disk space.
  • You have obtained the demonstration package from your CA Technologies Sales team.
    For more information about how to download demonstration package, see the  trial page or download the package from CA Support (for existing customers).
  • You have reviewed the installation best practices.
    For more information about the best practices, see Installation Best Practices.
Install the Demonstration Package
  1. Create a local directory called 
    lac
    .
  2. Copy the demonstration package (the file) into this local directory.
  3. Unzip the file.
The demonstration package is installed.
Run 
CA Live API Creator
 
Complete the following procedures after you have installed the demonstration package.
Start API Server
  1. From a command prompt or Terminal, change directories to the location of the demonstration package by issuing the following command:
    cd lac/<your demonstration package version>
    For example:
    cd lac/CALiveAPICreator-Jetty-4.1
  2. Start API server by issuing the following command:
    (Windows)
    start.bat
    (Unix/Mac)
    sh Start.sh
API Server is started when the following message appears:
*********************************************************
LAC is started and initialized
*********************************************************
Log in to API Creator
 
Prerequisites:
 
  • You have started API Server.
  • You have decided on which port you would like 
    CA Live API Creator
     to run.
    This installation assumes that the port is 8080, but you can change it to another port.
Follow these steps:
  1. Enter the following URL into a web browser window:
    http://localhost:<HOST_PORT>/APICreator
    Example:
    http://localhost:8080/APICreator
    The API Creator logon authentication dialog opens.
  2. Complete the following fields, and then click 
    Login
    :
    Server
    The URL and location of API Server, which can include the name of the root web application archive (WAR) file.
    Example:
    /APIServer
    The server location and name depends on the type of installation and configuration of your API.
     
    Username
     
    The admin account's username. Enter 
    admin
    .
    Password
    The admin account's password. Enter 
    Password1
    .
  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 as the administrator user (admin).
(Optional) Install other JDBC Drivers 
Follow these steps:
  1. Copy the JDBC driver into the 
    %JETTY_HOME%/caliveapicreator/lib/ext
     directory.
  2. Stop and restart API Server.
The data source is now available as an option in the connection wizard when creating an API.
Start the Debug Services
If you are using the JavaScript debugger, start the debug services.
For more information about how to start the debugger, see Debugger.
Resolve Port Conflict Issues
If you are running an application on your machine that is already using port 8080, 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)
To resolve this port conflict issue, open the (for Mac) 
Start.sh
 or (for Windows) 
Start.bat
 script, and then alter the 
LAC_PORT
 value to a different port number.
You might need to adjust the port in the URL when starting API Creator, such as:
http://localhost:8181/
Configure Offline Viewing of API Server Logs
You can create a logger for externalizing your API logs.
For more about how to configure offline viewing of API Server logs, see External Logging.
Next Steps
Now that you have installed the demonstration package, you can install Node.js and the 
CA Live API Creator
 npm packages.
For more information about how to install Node.js and the npm packages, see Install NodeJS and Command Line Utilities.