Gerenciando Uma Instalação Headless do VirtualBox Com phpvirtualbox (OpenSUSE 12.1)

Versão 1.0
Autor: Falko Timme
Siga-me no Twitter

phpvirtualbox é uma interface web para o VirtualBox escrita em PHP que permite acessar e controlar instâncias remotas do VirtualBox. Ele tenta se assemelhar ao GUI do VirtualBox o máximo possível para tornar o trabalho com ele o mais fácil possível. É uma boa substituição para o GUI do VirtualBox se você executar o VirtualBox em servidores headless (como no tutorial VBoxHeadless - Executando Máquinas Virtuais Com VirtualBox 4.1 Em Um Servidor OpenSUSE 12.1 Headless). Este tutorial explica como instalar o phpvirtualbox em um servidor OpenSUSE 12.1 para gerenciar um VirtualBox headless instalado localmente.

Não dou nenhuma garantia de que isso funcionará para você!

1 Nota Preliminar

Estou assumindo que um VirtualBox headless já está instalado no servidor OpenSUSE 12.1 local, por exemplo, conforme descrito no tutorial VBoxHeadless - Executando Máquinas Virtuais Com VirtualBox 4.1 Em Um Servidor OpenSUSE 12.1 Headless.

Estou executando todos os passos deste tutorial com privilégios de root, então certifique-se de que você está logado como root.

2 Instalando phpvirtualbox

Primeiro, crie um usuário do sistema chamado vbox e adicione-o ao grupo vboxusers:

useradd -m vbox -G vboxusers

Crie uma senha para o usuário vbox:

passwd vbox

Crie o arquivo /etc/default/virtualbox e coloque a linha VBOXWEB_USER=vbox nele (para que a API SOAP do VirtualBox que é chamada vboxwebsrv seja executada como o usuário vbox):

vi /etc/default/virtualbox

| VBOXWEB_USER=vbox |

Em seguida, crie os links de inicialização do sistema para o vboxwebsrv e reinicie-o:

systemctl enable vboxweb-service.service  
systemctl restart vboxweb-service.service

Precisamos de um servidor web com suporte a PHP para servir o phpvirtualbox - estou usando o Apache2 aqui. Instale o Apache2 e o PHP5 da seguinte forma:

yast2 -i apache2 apache2-mod_php5 php5-mysql php5-pear php5-suhosin php5-soap libapr-util1 libapr1 libapr-util1-dbd-sqlite3 wget

Agora configure seu sistema para iniciar o Apache na inicialização…

systemctl enable apache2.service

… e inicie o Apache:

systemctl start apache2.service

Quero servir o phpvirtualbox do host virtual padrão do Apache com o diretório raiz do documento /srv/www/htdocs (vou instalá-lo em /srv/www/htdocs/phpvirtualbox) - se você tiver um diretório raiz diferente, deve ajustar os passos seguintes:

cd /srv/www/htdocs  
wget http://phpvirtualbox.googlecode.com/files/phpvirtualbox-4.1-7.zip

Descompacte o phpvirtualbox e renomeie o phpvirtualbox-4.1-7 para phpvirtualbox para facilitar o uso:

unzip phpvirtualbox-4.1-7.zip  
mv phpvirtualbox-4.1-7 phpvirtualbox

Em seguida, vá para o diretório /srv/www/htdocs/phpvirtualbox/…

cd /srv/www/htdocs/phpvirtualbox/

… e crie o arquivo config.php copiando-o de config.php-example:

cp config.php-example config.php

Abra o config.php e preencha a senha que você criou anteriormente para o usuário do sistema vbox:

vi config.php

| [...] /* Nome de usuário / Senha para o usuário do sistema que executa o VirtualBox */ var $username = 'vbox'; var $password = 'secret'; [...] |

No OpenSUSE, devemos desabilitar a autenticação entre o vboxwebsrv e o SO, pois caso contrário você não conseguirá fazer login no phpvirtualbox (veja http://code.google.com/p/phpvirtualbox/wiki/Installation#Suse_Considerations). Podemos fazer isso da seguinte forma: faça login como o usuário (vbox) que executa o vboxwebsrv:

su vbox

Como o usuário vbox, execute:

VBoxManage setproperty websrvauthlibrary null

Volte para o shell root:

exit

Reinicie o vboxwebsrv:

systemctl restart vboxweb-service.service

É isso - agora você pode abrir um navegador e acessar o phpvirtualbox da seguinte forma:

http://www.example.com/phpvirtualbox/

O nome de usuário padrão é admin, a senha também é admin:

Assim é como o phpvirtualbox se parece - muito parecido com o GUI nativo do VirtualBox:

A primeira coisa que você deve fazer é mudar a senha do admin. Vá para Arquivo > Mudar Senha:

Digite a senha antiga e especifique uma nova:

Se você conhece o GUI nativo do VirtualBox, agora é muito fácil usar o phpvirtualbox. Por exemplo, se você quiser criar uma nova máquina virtual, você tem o mesmo assistente que tem no GUI do VirtualBox: