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.
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.)
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.
Select "Connect directly to the physical network (Bridged)." Select "Autodetect." Close the dialog box and reboot the virtual machine.
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.shUse this address when attempting to connect to the VM.
All the subsections refer to running programs directly on the guest VM.
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 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.
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.
To create a new store:
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.
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.
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:
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.
The AllegroGraph Python client can be found in the
Please see the
Python client tutorial
for instructions on how to use it.
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.
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.
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.