This documentation refers to an earlier version of Islandora. https://wiki.duraspace.org/display/ISLANDORA/Start is current.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

This chapter is for those who wish to review Islandora's functionality, or who wish to run a local version of Islandora as a Virtual Machine Image. This chapter assumes that you do not have a current running version of Islandora. If you are currently running an installation of Islandora, you do not need to review this section. If you would like to complete a full server installation of Islandora, please see Chapter 8 - Installing Islandora.

Accessing our Sandbox

To access the Islandora Sandbox, please visit http://sandbox.islandora.ca and login using the following credentials:

username: admin

password: islandora

This is an administrative account that will allow you to see Islandora from the perspective of a user who would add and administer repository content. This instance of Islandora has also been extended with Solution Packs, which will allow you to ingest particular types of content. If you are using the online sandbox to explore Islandora, you may move to the next section of this guide. If you are interested in seeing Islandora code in action, and having additional access to the system, you will want to install a Virtual Machine Image on your local computer.

Installing the Islandora Virtual Machine Image

The Islandora Virtual Machine Image comes pre-installed with Islandora's core modules, as well as several solution packs. At the end of this section, you will have a full running version of Islandora running on your local machine as a Virtual Machine. Because of the size and complexity of Islandora, you should have the following if you are going to run Islandora's Virtual Machine Image.

System Requirements

VirtualBox supports Windows, Mac, and Linux operating systems. For specific OS requirements, please see the Supported host operating systems' section of the VirtualBox guide.

The Islandora Virtual Machine Image itself is a 32 Bit OS with 2GB of RAM and a 6GB thin HDD. With these specifications in mind, your system should have (at a minimum) the following:

  • 32 Bit Windows, Mac, or Linux OS (64 Bit is also supported)
  • 4GB of RAM
  • 10GB of free HD space

Note that these are the minimum specifications for running the VM image, and will not provide the optimum performance environment. You will be able to do things, but expect some lagging.

1. Download VirtualBox and the Islandora VM Image

Download the latest Islandora Virtual Machine image at http://islandora.ca/download. This is a large file; its download time will vary based on your internet connection. Dial-up users should not attempt to download this file.

Download the specific VirtualBox software binaries for your Operating System. The VirtualBox User's Manual is also available.

2. Install VirtualBox

The VirtualBox installation process will differ depending on your Operating System. For detailed instructions, please consult the VirtualBox manual.

3. Run VirtualBox and Import the VM Image

Run VirtualBox and choose the File-Import Appliance menu option to start the Appliance Import Wizard.

  

Use the Choose button in the Appliance Import Wizard to navigate to the folder where you downloaded the Virtual Machine Image file. Select the OVA (or OVF) file, then click continue.

4. Confirm Settings and Import

The Appliance Import Settings page will be displayed - do not alter the configuration. Click 'Import'.

The import will take a few minutes.

5. Start the Virtual Machine

After the import is complete you will be returned to the application home page where you will see the Islandora Virtual Machine. Run your new virtual machine by selecting the Islandora image in the left column and then click "Start."

6. Log in to the Virtual Machine

Once the boot process is complete you will be presented with a command line login prompt. Enter the following commands to complete the process. Login with the Username islandora and the Password islandora.

Your complete Islandora system should now be up and running. You can access the system using the ip address and username/password displayed in the welcome message on your screen.

7. Access Your New Islandora Installation

Finally, open your internet browser and enter the IP address (192.168.56.195) into the navigation bar. This is the base URL for your Islandora instance. You can login using the Username: admin Password: islandora.

You can login separately to the Fedora repository at http://192.168.56.195:8080/fedora/repository. The credentials are username: FedoraAdmin password: islandora.

You now have a fully-functional instance of Islandora.

Troubleshooting

Some users may experience installation issues that prevent them from fully installing the Islandora Virtual Machine image. As these issues are discovered and resolved they will be added to this Troubleshooting section.

I see the following message when trying to start the Islandora VM Image in VirtualBox on Windows 7:

Failed to open a session for the virtual machine Islandora

Nonexistent host networking interface, name

'vboxnet0' (VERR_INTERNAL_ERROR).

Unknown error creating VM (VERR_INTERNAL_ERROR)."

Solution:

  1. In the VM VirtualBox Manager, right click on the Islandora VM or hit the settings button.
  2. Select the Network Menu.
  3. Disable the Network Adapter.
  4. Start the Islandora VM.
  5. Shut it down after it has successfully booted.
  6. Repeat steps 1-3, but this time enable the Network Adapter instead of disabling it.
  7. Restart the Islandora VM. It should now boot correctly.
  • No labels