This repository is obsolete and is kept for reference only.
To deploy OpenConext, please use the Ansible-based deploy scripts from https://github.com/OpenConext/OpenConext-deploy
OpenConext Virtual Machine
These are the resources required to build an OpenConext Virtual Machine.
OpenConext is the completely Open Source version of the educational collaboration platform that is used in the Netherlands, SURFconext. For more information regarding OpenConext, refer to the documentation at http://www.openconext.org
How to use this OpenConext VM?
You can either:
- Install OpenConext on your own server / VM. This option is recommended if you already have a target machine for OpenConext.
- Let Vagrant install and manage a new virtual machine for you. This option is recommended if you already use Vagrant.
Option 1. I already have a machine I want to install OpenConext on.
- a VM running CentOS 6 or RedHat EL 6 (other operating systems may work, but are not supported).
1.1. Download installer
From within the VM, download this repo:
curl https://codeload.github.com/OpenConext/OpenConext-vm/tar.gz/v75.1 | tar zx
1.2. Change the default VM settings
Copy the oc_config.sh file:
install -d /etc/openconext cp OpenConext-vm-75.1/scripts/oc_config.sh /etc/openconext/.
The OpenConext VM has a script to change all the default passwords to new random passwords.
pushd /etc/openconext OpenConext-vm-75.1/scripts/oc_setpasswds.sh popd
Adapt the VM settings to you likings using the comments in the /etc/openconext/oc_config.sh file.
1.3. Run the installer
Run the install script:
By default, the installer will run an 'unattended' setup, choosing sensible defaults.
If you want to install a specific version of the platform, install a subset of components or change the default domain (demo.openconext.org), run the installer with a
bash OpenConext-vm-75.1/scripts/install_openconext.sh -i
Option 2. Letting Vagrant set up a new virtual machine.
- Recent version of Vagrant
2.1. Make a new directory for all OpenConext code
Example for OS X:
mkdir ~/Sites/OpenConext cd ~/Sites/OpenConext
2.2. Download the VM project there
curl https://codeload.github.com/OpenConext/OpenConext-vm/tar.gz/v75.1 | tar zxv
2.3 Up, up and away!
You should now have a directory called OpenConext-vm-v75, go there and run vagrant up.
cd OpenConext-vm-v75.1 && vagrant up
Vagrant will download the basebox, set it up with NFS and install OpenConext for you.
Change your hosts-file
The installer ends with a message suggesting to add an entry to your hosts-file (that is: of the VM-host). Follow this suggestion if you want to use the OpenConext service from outside of the VM.
Visit Welcome URL
Point your browser to the welcome-URL, as mentioned by the installer. Install the CA's certificate in your browser as mentioned on that page.
You can now use the following OpenConext components:
- OpenConext Profile
- OpenConext Manage
- OpenConext ServiceRegistry
- OpenConext Teams
- OpenConext Api
- OpenConext Mujina-SP
To login in on the several Service Providers you can choose OpenConext Mujina IdP from the WAYF and login with
If you want to make modifications to the components a Samba share is available at:
smb://address/www username: openconext password: openconext
address is the ip address of your VM.
If you want to query or update the database you will have to open up port 3306. Type in a VM shell:
iptables -I INPUT -p tcp -m tcp --dport 3306 -j ACCEPT && service iptables save
The MySQL root-password is
Please note that we unfortunately do not support upgrades from earlier versions of OpenConext.
We are working on a new version of the VM that is Ansible based and should ensure better support for upgrades.