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
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
You can either:
Prerequisites:
From within the VM, download this repo:
curl https://codeload.github.com/OpenConext/OpenConext-vm/tar.gz/v75.1 | tar zx
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.
Run the install script:
bash OpenConext-vm-75.1/scripts/install_openconext.sh
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 -i
flag:
bash OpenConext-vm-75.1/scripts/install_openconext.sh -i
Prerequisites:
Example for OS X:
mkdir ~/Sites/OpenConext
cd ~/Sites/OpenConext
curl https://codeload.github.com/OpenConext/OpenConext-vm/tar.gz/v75.1 | tar zxv
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.
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.
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:
To login in on the several Service Providers you can choose OpenConext Mujina IdP from the WAYF and login with admin
/ secret
.
If you want to make modifications to the components a Samba share is available at:
smb://address/www
username: openconext
password: openconext
where 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 c0n3xt
.
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.