Standalone Installation

Overview

One installation of API Simulator can run multiple simulations on the same host concurrently by starting a separate lightweight API Simulator process for each simulation on a different port number.

Minimum Requirements

All that API Simulator needs is Java 8 or above. Using the Docker image is also a great way to enjoy and take advantage of API Simulator without having to have Java.

Install a Java Runtime first, if it is not installed already, on the host where you will be running API Simulator. Make sure that it is a JDK or a Server JRE - do not use Java for browser.

API Simulator is lightweight - it doesn’t require an application server or a database!

Install on Linux

Run the commands with sudo, if needed. For example:

sudo tar xzf ....

First, download the apisimulator-http-<version>-distro.tar.gz file to, say, "/tmp". (Mac users may find that the zipped distro file works better for them)

Assuming for simplicity that API Simulator will be installed under the root / directory, execute:

cd /

Then extract all files from the distro archive:

tar xzf /tmp/apisimulator-http-<version>-distro.tar.gz

If needed, change the owner of all of the installed directories and files to the Linux service account under which the API Simulator will run:

chown -R <account> apisimulator

That’s it!

Install on Windows

First, download the apisimulator-http-<version>-distro.zip file to, say, C:\Temp.

Next, extract all files from the distro archive. One way to do that is to select the distro file in Windows Explorer, click on the file with the right mouse button, and choose "Extract All…​" from the context menu; enter C:\ in the popup dialog box for the location where to extract the file and click the "Extract" button.

That’s it!

Directory Structure

Installing API Simulator creates the following directory structure:

apisimulator
└─ apisimulator-http-x.y.z
    ├─ bin
    ├─ config
    ├─ examples
    ├─ lib
    └─ logs

Here’s a brief description of each directory:

Name Description

apisimulator

API Simulator’s home directory

apisimulator-http-x.y.z

API Simulator for APIs exposed over the HTTP protocol. x.y.z is the version

bin

Scripts for Linux and Windows to start and stop API Simulator for a simulation

config

Default configurations

examples

Simulation examples to get someone started with API Simulator

lib

Libraries the API Simulator uses

logs

Default directory for API Recorder’s log files. Each simulation has its own default logs directory

All trademarks and registered trademarks are the property of their respective owners.

We would love to hear your feedback - send us a quick email to [feedback at APISimulator.com]

Happy API Simulating!