ajacoutot 4ad36a70fc Take maintainer.
Drop the HTTP root directory symlink advise; most people will use a
virtualhost.
Updated extpack version.
2014-09-19 12:31:52 +00:00
..
2014-03-22 08:16:21 +00:00
2014-09-19 12:31:52 +00:00

$OpenBSD: README,v 1.4 2014/09/19 12:31:52 ajacoutot Exp $

+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------

phpVirtualBox has been installed into:
    ${INSTDIR}

Configuration is done in:
    ${INSTDIR}/config.php

Default username/password is: admin/admin

VirtualBox configuration on Linux Red Hat(-like) systems
========================================================

Official documentation is available at:
  http://code.google.com/p/phpvirtualbox/wiki/vboxwebServiceConfigLinux

phpVirtualBox user
------------------
Since phpVirtualBox is mostly used in shared environments, it's a good
idea to create a specific UNIX user for it.

# useradd -c "PHP VirtualBox" -U -G vboxusers vbox
# passwd vbox

This user credentials must match the "$username" and "$password" values
set in ${INSTDIR}/config.php.

VirtualBox extension pack
-------------------------
Remote display support using VRDP requires the installation of the
proprietary extension pack from Oracle.

e.g.
# su - vbox
$ wget http://download.virtualbox.org/virtualbox/4.3.16/Oracle_VM_VirtualBox_Extension_Pack-4.3.16-95972.vbox-extpack
$ VBoxManage extpack install Oracle_VM_VirtualBox_Extension_Pack-4.3.16-95972.vbox-extpack

VirtualBox web service
----------------------
By default, the VirtualBox web service will not run and needs to be
enabled.

# chkconfig vboxweb-service on
# echo "VBOXWEB_HOST=127.0.0.1" >> /etc/default/virtualbox
# echo "VBOXWEB_USER=vbox" >> /etc/default/virtualbox
# /etc/init.d/vboxweb-service start

VBOXWEB_HOST is the local IP address the service will bind too. It must
match the "$location" value set in ${INSTDIR}/config.php.
VBOXWEB_USER is the VirtualBox user that phpVirtualBox will use. It must
match the "$username" value set in ${INSTDIR}/config.php.

More info is available at:
    http://code.google.com/p/phpvirtualbox/wiki/vboxwebServiceConfigLinux

SELinux considerations
----------------------
When SELinux is enabled, the VirtualBox's web service port (18083) must
be accessible by a service running in the http context.

# yum install policycoreutils-python
# semanage port -a -t http_port_t -p tcp 18083