Docs‎ > ‎Espresso Appliance‎ > ‎

Appliance for Evaluation

This page describes the simplest way to run the appliance on your laptop or desktop.  In this mode, you will be able to test Espresso inside your firewall, with access to any database for which you have the credentials. 

Espresso has other installation options, described here.


You will need the following to run the appliance.

Acquiring VMware

In this doc, we will refer to VMware, but it is actually a different set of products, depending on your OS.  In any case, you will need to acquire and install one of the types of VMware described below.

PC:  VMware Player, or VMware Workstation 64 bit

Windows users can use the free VMware Player, or VMware Workstation.

Mac: VMware Fusion 64 bit

Mac users will need to purchase 64 bit VMware Fusion.  This is a widely used piece of software, often used to run Windows under Mac OS.

Unix: Various 64 bit versions

The links above also provide options for Unix versions.

VMware ESX 5.x 

The following components are required:

VMware vCenter and one ESX servers to deploy Espresso Logic Appliance.

The VMware vSphere Client provides access to the virtual appliance interface. The vSphere Client is required to deploy the Open Virtual Appliance (OVA) file to vSphere and to access the deployed virtual appliance remotely to configure networking.

The appropriate VMware licenses.

Machine Resources

The appliance runs fine on any modern 64 bit CPU desktop / laptop with:
  • Sufficient memory to run a 2G image (e.g., runs well on a 4G Macbook Air)

  • 12G of disk space

Download the ova

The Espresso Appliance is distributed as an ova file (a standardized virtual machine format).  You will receive the link address from Espresso.  This is a pre-configured CentOS (Unix) machine, and contains the Espresso server and MySQL.  It's all you need to get started.

Import the ova

ova files are non-executable images, so you must import it to create an image you can run.  This will create a 10G image, after which you can delete the ova file.


Simply double-click the ova. 

 VMware will provide defaults as to where the resultant executable image is to be stored.


Follow this procedure:
  1. Start VMWare

  2. Choose Open a Virtual Machine

  3. On the dialog, be sure to select file-type = "ova" (lower red box), and select your ova file

Run the Image

After the import, VMware will provide an option to run the image. You can do so now.

This starts up the Espresso server, and presents the Unix Shell command window shown below.  This takes about 30 seconds.

Unix Shell

It is not necessary to login at this point, though you can do so.

It is not even necessary to click into this window (e.g., you can just leave it running, or minimize it).  

If you do, it can be disconcerting that it grabs your mouse - use the instructions on the window to regain mouse control.
There are a number of options here, such as resetting passwords using el-setup, installing VMware tools, etc.  They are optional, so we recommend you simply:
  1. Proceed to the next section to Start the Logic Designer, and then when you're done using Espresso... 

  2. Stop the image (see 2nd section, below)
As noted above, you can delete the ova file at this point.

Unable obtain dhcp

You may encounter "unable to obtain dhcp" errors on the PC, instead "Next browse to" message above.  This can typically be resolved by altering networking settings from Bridged to NAT.  See here for more information.

Start the Logic Designer

The Espresso Logic service is already started.  The screen above explains how to start the Browser to access the Logic Designer - in the red box.  
  1. Start your Browser
    1. Obtain the URL from the Unix command window, shown in the red box in the screen above
    2. Enter that URL into in your Browser (as shown in the oval below - but use the URL from step 1, above)
  2. Login with admin, Password1 (square red box, below)

Espresso Tour

At this point, the Espresso Tour will start (rounded red rectangle above), to introduce you to the key features.  It runs about 10 minutes, culminating with this summary of what you did in the Tour:

One of the last steps of the Tour is the Live Browser.  You might want to explore Author Mode, which enables you to take the automatically generated application, and customize it like this in about 2 minutes - no IDE, no Web Editor, just your Browser:

Restricted Web Access

One of the first steps is to illustrate how to connect your database, which uses a central version of the familiar Northwind database.  If your organization does not allow outside web access, don't worry: the Appliance has preloaded local samples you can explore:
There are already preconfigured, using jdbc:mysql://localhost:3306/espresso_demo (last node is schema and user), and espresso_sample.

Install your license file

The appliance normally comes with a time-limited license. 
If you have received a license file from Espresso Logic, you can install it any time using the Logic Designer.

Stop the Image

When you are through, you will want to stop the image:
  1. Access the VMware machine.  It will grab mouse control, which can be disconcerting.  The window provides key stroke commands to regain mouse control.

  2. Login to the CentOS (Unix) image: tomcat, espresso123

  3. Issue the command: sudo shutdown -h now

Installing the Production Appliance

When you are ready to install a version of the appliance for production, configuration instructions are described here.  Depending on your objectives, these can become rather complex, requiring moderate to advanced skills in system administration.