Line 40: |
Line 40: |
| yum install smeserver-extrarepositories-epel smeserver-extrarepositories-virtualbox | | yum install smeserver-extrarepositories-epel smeserver-extrarepositories-virtualbox |
| yum --enablerepo=smedev,smecontribs,epel,virtualbox install smeserver-phpvirtualbox | | yum --enablerepo=smedev,smecontribs,epel,virtualbox install smeserver-phpvirtualbox |
− |
| + | The install will prompt you to accept the VirtualBox GPG key |
| </tab><tab name="4.3 For SME 8 and 9"> | | </tab><tab name="4.3 For SME 8 and 9"> |
| You need to install the [[VirtualBox_Repository]], the [[stephdl|Stephdl_repository]] And the [[Epel|Epel Repository]] | | You need to install the [[VirtualBox_Repository]], the [[stephdl|Stephdl_repository]] And the [[Epel|Epel Repository]] |
Line 98: |
Line 98: |
| Go to the phpvirtualbox panel at the url https://your-sme-ip/phpvirtualbox on your local-network. '''You can not reach this contrib trought internet'''. | | Go to the phpvirtualbox panel at the url https://your-sme-ip/phpvirtualbox on your local-network. '''You can not reach this contrib trought internet'''. |
| | | |
− | {{Note box|Authentication is not currently working. | + | === Authentication === |
− | Any device on the local network will have access.}}
| + | {{Note box|Authentication is partially working. |
| + | |
| + | - BuiltIn, will use the phpvirtualbox builtin authentication which lets you manage users within phpvirtualbox ONLY. It does not have any interface/interaction with smeserver users |
| + | |
| + | - LDAP, will allow any smeserver user access, with whoever is defined in the phpvirtualbox adminUser config item as the administrator (default is admin) |
| + | |
| + | - WebAuth, will allow any user defined in the phpvirtualbox Users config item, or belonging to groups defined in the phpvirtualbox userGroups config items access (Note: using group access will generate lots of errors in the /var/loh/httpd/error.log file ATM). Admin access is defined by the phpvirtualbox adminUser config item |
| + | |
| + | - AD, is defined, but has not been tested}} |
| | | |
| Your credentials are the user admin of the SME Server and its password but you can add more users by the [[Phpvirtualbox#DB_Configuration|DB Configuration]]. | | Your credentials are the user admin of the SME Server and its password but you can add more users by the [[Phpvirtualbox#DB_Configuration|DB Configuration]]. |
− | {{Tip box|You can see [[VirtualBox_4.0_on_SME_Server_v8_beta_6|the Tutorial]] hosted on our Wiki in order to learn : | + | |
| + | to add individual users<syntaxhighlight lang="bash"> |
| + | config setprop phpvirtualbox Users <list of comma separated users> |
| + | </syntaxhighlight>to add groups<syntaxhighlight lang="bash"> |
| + | config setprop phpvirtualbox userGroups <list of comma separated smeserver groups> |
| + | </syntaxhighlight>then you'll need to activate via:<syntaxhighlight lang="bash"> |
| + | signal-event smeserver-phpvirtualbox-update |
| + | </syntaxhighlight>{{Tip box|You can see [[VirtualBox_4.0_on_SME_Server_v8_beta_6|the Tutorial]] hosted on our Wiki in order to learn : |
| *how to create [[VirtualBox_4.0_on_SME_Server_v8_beta_6#Creating_a_Virtual_Machinecreate| your first VM]] | | *how to create [[VirtualBox_4.0_on_SME_Server_v8_beta_6#Creating_a_Virtual_Machinecreate| your first VM]] |
| *how to automatically [[VirtualBox_4.0_on_SME_Server_v8_beta_6#Automatically_Start_Virtual_Machine|start VM with the server]] }} | | *how to automatically [[VirtualBox_4.0_on_SME_Server_v8_beta_6#Automatically_Start_Virtual_Machine|start VM with the server]] }} |
Line 139: |
Line 154: |
| ===Installation of Extension Pack=== | | ===Installation of Extension Pack=== |
| | | |
− | Support for USB 2.0 devices, VirtualBox RDP and PXE boot for Intel cards. See this chapter [https://www.virtualbox.org/manual/ch01.html#intro-installing from the User Manual] for an introduction to this Extension Pack. See this page to [https://www.virtualbox.org/wiki/Downloads download the extension pack] if the url below is no longer good. | + | The Extension Pack is now automatically installed with VirtualBox. |
| + | |
| + | You can trigger a recheck and possible install. This will also check the installed driver and recompile if required (e.g. after a kernel upgrade).<syntaxhighlight lang="bash"> |
| + | signal-event smeserver-virtualbox-update |
| + | </syntaxhighlight>Support for USB 2.0 devices, VirtualBox RDP and PXE boot for Intel cards. See this chapter [https://www.virtualbox.org/manual/ch01.html#intro-installing from the User Manual] for an introduction to this Extension Pack. See this page to [https://www.virtualbox.org/wiki/Downloads download the extension pack] if the url below is no longer good. |
| | | |
| For example : | | For example : |
Line 220: |
Line 239: |
| | | |
| ====Authentication==== | | ====Authentication==== |
− | {{Note box|Authentication is not currently working. | + | {{Note box|Authentication is still being worked on, but mostly works as advertised.}} |
− | Any device on your local network will have access.}}
| |
| you can allow authentication to phpvirtualbox via number of methods. This feature is the default behaviour since the bug opened is solved http://sourceforge.net/p/phpvirtualbox/bugs/7/. | | you can allow authentication to phpvirtualbox via number of methods. This feature is the default behaviour since the bug opened is solved http://sourceforge.net/p/phpvirtualbox/bugs/7/. |
| | | |
− | config setprop phpvirtualbox webauth enabled | + | config setprop phpvirtualbox authtype WebAuth |
− | signal-event console-save | + | signal-event smeserver-phpvirtualbox-update |
− | | + | {| class="wikitable" |
− | and you have to modify manually the file config.php
| + | |+authtype |
| + | ! |
| + | ! |
| + | |- |
| + | |BuiltIn |
| + | |will use the phpvirtualbox builtin authentication which lets you manage users within phpvirtualbox ONLY. It does '''NOT''' have any interface/interaction with smeserver users |
| + | |- |
| + | |LDAP |
| + | |will allow any smeserver user access, with whomever is defined in the phpvirtualbox adminUser config item as the administrator (default is admin) |
| + | |- |
| + | |WebAuth |
| + | |will allow any user defined in the phpvirtualbox Users config item, or belonging to groups defined in the phpvirtualbox userGroups config items access |
| + | Admin access is defined by the phpvirtualbox adminUser config item |
| | | |
− | nano /opt/phpvirtualbox/config.php
| + | ('''''Note:''''' using group access will generate lots of errors in the /var/log/httpd/error.log file ATM). |
| + | |- |
| + | |AD |
| + | |is defined, but has not been tested. |
| + | will allow any user defined in the phpvirtualbox Users config item, or belonging to AD groups defined in the phpvirtualbox userGroups config items access. |
| | | |
− | // Authentication library.
| + | Admin access is defined by the phpvirtualbox adminUser config item |
− | var $authLib = 'Builtin';
| + | |- |
− | #var $authLib = 'WebAuth';
| + | |none |
− | #var $authConfig = array('adminUser' => 'admin');
| + | |everyone on your local network has access, without needing to log in |
− | | + | |} |
− | to | |
− |
| |
− | // Authentication library.
| |
− | #var $authLib = 'Builtin';
| |
− | var $authLib = 'WebAuth';
| |
− | var $authConfig = array('adminUser' => 'admin');
| |
| | | |
| + | =====Allow Specific Users===== |
| + | Works with WebAuth and AD |
| | | |
− | =====Allow Specific Users=====
| |
| The users must be declared and a password must be set in the server-manager. | | The users must be declared and a password must be set in the server-manager. |
| | | |
− | config setprop phpvirtualbox User user1,user2,user3 | + | config setprop phpvirtualbox Users user1,user2,user3 |
− | signal-event console-save | + | signal-event smeserver-phpvirtualbox-update |
| | | |
| =====Allow Specific Groups===== | | =====Allow Specific Groups===== |
| + | Works with WebAuth and AD |
| + | |
| These groups must be declared in the server-manager and users need to be included | | These groups must be declared in the server-manager and users need to be included |
| | | |
− | config setprop phpvirtualbox Group Group1,Group2,Group3 | + | config setprop phpvirtualbox userGroups Group1,Group2,Group3 |
− | signal-event console-save | + | signal-event smeserver-phpvirtualbox-update |
| | | |
| === Access The Web Interface Remotely === | | === Access The Web Interface Remotely === |