VirtualBox Image

The Content of the VirtualBox Image - SocrateOpenDemo:

    • Ubuntu 10.10 Desktop (32-bit);

    • OracleXE - preconfigured with auto-launch;

    • SocrateOpen Server - preconfigured with auto-launch.

System Requirements

The minimal system requirements for the host machine (where the image will be installed) are:

    • Operating system: any OS running VirtualBox (Windows, Linux, Solaris, etc.);

    • At least 2 GB RAM;

    • At least 10 GB free space for the virtual machine and 5 GB free space for unzipping the image;

    • Pentium 4 processor or higher;

    • VirtualBox.

Installation

In order to install this image on your machine, follow the steps below:

VirtualBox Installation

We recommend you to reboot the machine when the installation completes (although the VirtualBox installer doesn't require this additional step).

Importing the Image

1. If the image is downloaded from the Internet, it is a rar archive and must be unzipped with a compatible program (for example, WinRAR for Windows or the rar package for Linux).

2. Launch VirtualBox and select Import Appliance... from the File menu, click Choose... and, in the next screen, select the SocrateOpenDemo.ovf file (located either on the DVD or in the location where you unzipped the image).

3. Click Next. In the next screen, you can modify the default values of the virtual machine (assigned processors, required RAM, the path to create the virtual disks, a.s.o.).

4. After you checked and, optionally, changed / customized the parameters of the virtual machine, click the Import button and accept the license (GPL) to start the import process.

5. When the importing completes, the VirtualBox main screen should look similar to the image below:

Starting the SocrateOpenDemo Virtual Machine

1. Once the image has been imported, the virtual machine can be started. Select SocrateOpenDemo in the left frame of the VirtualBox main screen and then click Start.

2. Depending on the performance of your machine, and the resources assigned for the virtual machine, starting the Oracle database and the SocrateOpen server may take a bit longer (5 - 10 minutes). While the database and the server are being initiated, the progress window looks similar to the image below. Please wait until a message like "Started in ..m..s:...ms" is displayed in the SocrateOpen Server Log screen.

3. Once the server has started, you can open the SocrateOpen home page by using the SocrateOpen Local Server shortcut on the desktop.

Activating the Network Access

By default, the virtual machine is not configured to have access to the LAN or the Internet.

To activate the access, follow the steps below:

1. Open Applications > Accessories > Terminal and execute the following commands (enter sopen when a password is requested):

    • sudo /etc/init.d/SocrateOpen stop

    • sudo /etc/init.d/oracle-xe stop

2. Open System > Administration > Network Tools.

3. Select Ethernet Interface (eth0) for Network device. Click Configure.

4. Select Auto eth0 in the Network Connections screen. Select Edit...

5. Go to the IPv4 Settings tab.

6. Choose the Automatic (DHCP) method if your network has a DHCP server; if not, choose the Manual method and add a static IP from the address class of your network (for example, 192.168.1.200 and 255.255.255.0 for Netmask). Click Apply.... If a password is requested, provide sopen.

7. Shut down the virtual machine.

8. In the VirtualBox configuration screen, select SocrateOpenDemo and click Settings.

9. Select the Network configuration option and choose the Bridged Adapter instead of Internal Network. Click OK.

10. Start the virtual machine.

Accessing the Virtual Machine via LAN

If you wish to access the virtual machine from a workstation located in your LAN, follow the steps below:

1. Activate the LAN access for the virtual machine, as described above.

2. Get the IP address of the virtual machine. For this, go to Open Applications > Accessories > Terminal and execute the command: ifconfig.

3. Write down the IP address of the eth0 interface. The address is the series of 4 digits divided by a full stop, displayed after the record inet addr:. For example, for the next ifconfig result, the address is 192.168.100.10.

eth0 Link encap:Ethernet HWaddr 08:00:27:52:64:4d

inet addr:192.168.100.10 Bcast:192.168.100.255 Mask:255.255.255.0

inet6 addr: fe80::a00:27ff:fe52:644d/64 Scope:Link

UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1

RX packets:0 errors:0 dropped:0 overruns:0 frame:0

TX packets:35 errors:0 dropped:0 overruns:0 carrier:0

collisions:0 txqueuelen:1000

RX bytes:0 (0.0 B) TX bytes:6533 (6.5 KB)

4. Edit the hosts file on the workstation from where you intend to access the virtual machine and add the following record (for Windows, this file is located in C:\WINDOWS\system32\drivers\etc, and for Linux in /etc):

  • [IP mașină virtuală] sopen-demo

    • For the above example, the record should look like this:

  • 192.168.100.10 sopen-demo

5. At this stage, you should be able to access the home page of the SocrateOpen Server, located at the address: http://sopen-demo/admin.

Tested Configurations

This is the link to the section containing the tested configurations.