Espresso Appliance Installation Instructions
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.
You will need the following to run the appliance.
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.
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
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:
- Start VMWare
- Choose Open a Virtual Machine
- On the dialog, be sure to select file-type = "ova" (lower red box), and select your
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.
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:
- Proceed to the next section to Start the Logic Designer, and then when you're done using Espresso...
- Stop the image (see 2nd section, below)
As noted above, you can delete the ova file at this point.
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.
- Start your Browser
- Obtain the URL from the Unix command window, shown in the red box in the screen above
- Enter that URL into in your Browser (as shown in the oval below - but use the URL from step 1, above)
- Login with
admin, Password1 (square red box, below)
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
Install your license file
The appliance normally comes with a time-limited license.
Stop the Image
When you are through, you will want to stop the image:
- Access the VMware machine. It will grab mouse control, which can be disconcerting. The window provides key stroke commands to regain mouse control.
- Login to the CentOS (Unix) image:
- 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.