Support/Doc | About | Purchase | Advanced Search

AllegroGraph

Product Description

White Papers
Customers

AllegroGraph Virtual Machine

The AllegroGraph Server runs natively on Linux x86-64. To run AllegroGraph on other operating systems (i.e. Windows, Mac) we suggest you set up a Linux virtual machine. We provide a VMware virtual machine image to help facilitate this installation or you can create one on your own. The AllegroGraph virtual machine can be downloaded from the AllegroGraph download page.

Performance in the virtual machine will be slower than running natively, so we encourage you to install AllegroGraph natively for performance evaluation.

Guide to the AllegroGraph Virtual Machine

Download the virtual machine image

After download, unzip the file into your desired location on your computer.
NOTE: the native Windows unzip for many versions of Windows cannot unzip the file you download. You will need to use a free program like 7-Zip.

Download and install the VMware Player

32/64-bit Windows: VMware Workstation Player
32/64-bit Mac OS X (Intel): VMware Fusion

Launch the VMware Player

Click on "Open a Virtual Machine"

Navigate to the AllegroGraph Virtual Machine.vmx file in the directory where you unzipped the AllegroGraph download. Open this file.
Take ownership if prompted
(Note: You will see on error dialog if your BIOS is not set with Virtualization Enabled.)
Play virtual machine
When prompted for Moved or Copied. Select Copied

Logging in to the Linux Virtual Machine

Username: franz
Password: allegrograph

Starting AllegroGraph

Double click on "agstart" short cut on the desktop.
Another option is to open a Terminal window and at the prompt type agstart

Stopping AllegroGraph

Double click on "agstop" short cut on the desktop.
Another option is to open a Terminal window and at the prompt type agstop

Remote Connection to the VM

NAT Vs. Bridged Network Connections

The AllegroGraph VM is configured with a network adaptor that uses NAT. In this configuration, the VM shares the IP address of the host server. Only the host machine (and possibly other VMs running on the same host) will be able to connect to the AllegroGraph VM. No other machines on the host network will be able to connect to the AllegroGraph VM.

In Bridged mode, the AllegroGraph VM and the host machine will share the host's network connection, but the VM will attempt to join the same network that the host belongs to. In this configuration, any machine on the same network as the host will also be able to connect to the AllegroGraph VM.

To change the type of network connection, make sure your AllegroGraph VM is selected and open the Player | Manage menu and select Virtual Machine Settings.

This displays the settings dialog. To connect from a remote machine, you want to turn off NAT and enable Bridged instead. (The illustrations except under the Mac heading are from a VM running on Windows.)

Windows

Select "Bridged: Connect directly to the physical network." Check the option that says "Replicate the physical network connectivity state." Close the dialog box and reboot the virtual machine.

Mac

Select "Connect directly to the physical network (Bridged)." Select "Autodetect." Close the dialog box and reboot the virtual machine.

Determining the IP Address of your VM

Boot up your VM. After you log in, open a terminal window. Run the following script which will return the IP address of your VM.

    ~/franz/ipaddr.sh

Use this address when attempting to connect to the VM.

Using the AllegroGraph Virtual Machine

AGWebView

All the subsections refer to running programs directly on the guest VM.

Make sure the AG Server has been started (see above).
Double click on the AllegroGraph VM Quickstart.html icon to Launch FireFox and click "AGWebView" in the bookmarks bar, or enter "http://localhost:10035".

You will be logged in as Anonymous. Click on User anonymous and choose Login. It is better to login as a superuser as you can do more things. The superuser name is test and password is xyzzy. Here is the browser before and after you choose Login:

The Wilburwine preloaded dataset

The AllegroGraph VM comes with a repository named "wilburwine" with the Wilburwine dataset preloaded from ~/franz/AG Triple Data/. This dataset has information about wine and wineries.

Running Gruff in the VM

Here are the steps for starting Gruff in the VM. First we show the steps for opening the wilburwine repository and then for creating a new repository.

Double-click the gruff link on the desktop, or right-click and select "Open".
Select menu File>Open Triple Store...
Check that the Server Machine (localhost or the VM's IP adress) and Port (10035) have the correct values.
User is test and password is xyzzy.
Select the Root Catalog and the wilburwine Store.
Click OK.

To create a new store:

Double-click the gruff link on the desktop, or right-click and select "Open".
Select menu File>New Triple Store...
Check that the Server Machine (localhost or the VM's IP adress) and Port (10035) have the correct values.
User is test and password is xyzzy.
Specify "anyname" (without qoutes) as the triple store name.
Select menu File>Load>N-Triples and point to one of the Ntriple files available in the (Home>Franz>AG Triple Data) folder, then select Open.

This has created a store and loaded the selected RDF data. You can now browse/query this data.
Open FireFox to browse Gruff documentation

Running Gruff outside the VM

You can also run Gruff outside the VM, either on the machine running the VM or on a different one.

If you have Gruff running (not in the VM), you can connect it to AllegroGraph in the VM. Just run the script ~/franz/ipaddr.sh in a terminal in the VM to determine the IP address of the VM and use that value in the Windows Gruff to connect to the VM AllegroGraph. The port number for AllegroGraph on the VM is 10035.

If you are running Gruff on a machine which is not also running the VM, turn off the Use Session Ports option displayed by the Global Options | Communications menu.

Eclipse (for Java, and Jena, and Triple Attributes examples)

The java client has been preloaded as a project in Eclipse. TutorialExamples.java and AttributesExample.java should already be open and viewable when Eclipse starts. Run configurations have already been defined for each tutorial.

Make sure AllegroGraph has been started.
Open Eclipse with the link on the desktop.

The Package Explorer tab should include AllegroGraph 6.1.3 Java Client, already selected, and tabs for AttributesExample.java and TutorialExamples.jave should be in the editor window to the right. Run configurations have already been defined for each Tutorial.

To run a tutorial:

Click on the Run menu (a green circle with a right-facing triangle) in the menu bar) and select Run Configurations.
Under Java Application in the pane on the left side of the window that appears, select Select the configuration for the tutorial you would like to run.
Click the Run button on the upper right.

Output will appear in the Console on the lower right.

All examples will run. If you want to run a single example or a subset of examples, click on the Arguments tab and change All to one or more example numbers. The last picture shows Example 1 only being run, with results in the Console.

Python

The AllegroGraph Python client can be found in the ~franz/python-client directory. Please see the Python client tutorial for instructions on how to use it.

Connecting TopBraid Composer to the Virtual Server

TopBraid Composer (TBC) can be connected to the VM for experiments where performance is not critical. Both the virtual server and TopBraid can be installed on the same computer, or TBC can connect to the VM from another computer across a network.

TBC and VM on the Same Computer

To connect TopBraid Composer to a virtual AllegroGraph server, with both running on the same physical computer, all you need is the IP address of the virtual machine. This IP address is usually assigned when the virtual machine comes on line, and may change from session to session. To discover the current IP address, use the script ~/franz/ipaddr.sh as described in the section Determining the IP Address of your VM above.

Use this IP address and the AllegroGraph port number (10035) when you connect TopBraid Composer to the VM.

Connect TBC to the VM on a Local Network

The VM's network adaptor is set Network Address Translation (NAT) by default. This setting makes it easy to connect TBC to the VM when both are on the same host computer. If you have TBC and the VM running on separate computers, you might encounter difficulty making the connection.

To connect TBC to a virtual AllegroGraph server on a network computer, you will have to reconfigure the virtual machine's network adaptor, as described in the section Remote Connection to the VM above.