AllegroGraph 4 Virtual Machine

The AllegroGraph 4 Server runs natively on Linux x86-64 bit. To run AllegroGraph 4 on other operating systems (i.e. Windows, Mac) we suggest you set up a Linux Virtual Machine for non-performance experiments. We provide a Virtual Machine image to help facilitate this installation or you can create one on your own. Clients to an AllegroGraph server may be either 32-bit or 64-bit. The AllegroGraph 4 Virtual Machine can be downloaded from the AllegroGraph download page.

The VMware Appliance will let you run the Linux version in a virtual machine. Performance will be slower than running natively, so we encourage you to install AllegroGraph natively for performance evaluation.

For native 64-bit Mac, Windows, and Solaris, and all 32-bit systems, please use AllegroGraph 3.3.

Guide to the AllegroGraph 4 Virtual Machine

Download the Franz provided 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 Player
• 32/64-bit Mac OS X (Intel): VMware Fusion

Launch the VMware Player

• Click on "Open a Virtual Machine"



• Navigate to the AllegroGraph v4 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 and select "Run in Terminal Window" when prompted.
• Another option is to open a Terminal window and at the prompt type agstart



• Launch FireFox and click "AGWebView" in the task bar, or enter "http://localhost:10035".
• Login to AllegroGraph
  • Username: test
  • Password: xyzzy
• You can backspace the url to just read http:://localhost:10035 to see other repositories on the system.

Stopping AllegroGraph

• Double click on "agstop" short cut on the desktop and select "Run in Terminal Window" when prompted.
• Another option is to open a Terminal window and at the prompt type agstop

Using the AllegroGraph Virtual Machine

AGWebView

• Make sure the AG Server has been started (see above).
• Launch FireFox and click "AGWebView" in the task bar, or enter "http:://localhost:10035".

Gruff

• Double-click the gruff link on the desktop, or right-click and select "Open".
• Select menu File>New Triple Store...
• Accept default port of 10035
• 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

Eclipse (for Java and Jena examples)

• Make sure AllegroGraph has been started.
• Open Eclipse with the link on the desktop.
• In the Package Explorer Tab navigate to the Tutorial Examples. src>tutorial
• Double click on TutorialExamples.java to open it in an editor.
• In the Run menu bar select Run configurations. (Run > Run Configurations)
• Tutorial Examples should be select in the left hand pane.
• Project: AllegroGraph 4.x Java Client
• Main class: tutorial.TutorialExamples
• Next, Look for the Arguments tab, should be second.
• Type "all" in the Program arguments field. Click Apply, then click Run.
• Output of the examples will appear in the Console.
  

Python

• Make sure AllegroGraph has been started
• In a terminal, cd /home/franz/agraph-4.7-client-python/tutorial.
• At the prompt type: python tutorial_examples_40.py all
• The examples will start to run in the terminal window

Remote connections to the VM

• In a terminal window type: ifconfig
• Determine the inet addr (for example inet addr:192.168.209.137)
• Using a browser from your host system type http://192.168.209.137:10035 (use your inet addr)
• For example, from your Windows Host you can open a web browser and view the AllegroGraph server running in the VM.

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 laptop, 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, follow the instructions above this section, in the section "Remote Connections to the VM"

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 to a virtual AllegroGraph server on a network computer, you will have to reconfigure the virtual machine's network adaptor. Open the VM menu > Settings... > Network Adaptor dialog box. The object is to turn off NAT and enable "bridging" instead.

Windows

Select "Bridged: Connect directly to the physical network." Check the option that says "Replicate the physical network connectivity state."

Mac

Select "Connect directly to the physical network (Bridged)." Select "Autodetect."

Close the dialog box and reboot the virtual machine. Use "ifconfig" to get the new IP address. This address (using port 10035) will connect across the network.

Checking for Updates

The AllegroGraph TopBraid Composer plugin will be updated as needed. To check for an update, open TBCs Help menu and select Check for Updates.