English
Français
Tiếng ViệtSubmitted by Anonymous on
Note
------------
This documentation is only for the OBM versions 3.1.3 or newer.
OBM 3.0.0 has the "provisioning" feature but it was included in the "obm-sync" service.
Installation
=========
The installation requires that your package manager is configured with an OBM repository (see [how there](http://obm.org/content/downloads-sources)).
For debian:
apt-get install obm-provisioning
For centos:
yum install obm-provisioning
chkconfig obm-provisioning on
Start it:
/etc/init.d/obm-provisioning restart
Once you are done, the service is up and it listens for HTTP request on the port 8086.
Even if the optimal configuration is not yet done you can start to [use it](http://obm.org/wiki/obm-provisioning-api), try to run the following curl to assert that the service is fully functional:
curl http://localhost:8086/healthcheck/
## the result should be:
[{"method":"GET","path":"/java/encoding"}, {"method":"GET","path":"/java/version"}, {"method":"GET","path":"/java/vendor"},{"method":"GET","path":"/java/vmname"}]
Hosts & Domains
=========
Hosts
------------
Connect the OBM web interface with your super-administrator account, go on the "Users/Hosts" page and search for the host where you installed the package.
Click "Modify", check the "Provisioning" role and save.
Domains
-------
Go on the domain configuration page by clicking on "Administration/Domains" and click on "Find".
Update each domain that you want be covered by the "provisioning" feature by setting the previously configured host at the "Provisioning servers" section.
Setup your frontend location
=========
Modify your Apache (or httpd) OBM configuration to add the "provisioning" location
Order allow,deny
Allow from all
ProxyPass /provisioning http://localhost:8086
ProxyPassReverse /provisioning http://localhost:8086
Then restart Apache (or httpd)
Run the Healthcheck
=========
Verify that everything goes fine by running the [OBM Healthcheck](http://obm.org/wiki/obm-health-check-system).
Take care of the section named "Provisioning" and check that it is colored with a beautiful green :)
Logs
=========
- /var/log/obm-provisioning/out.log contains the HTTP server output
- /var/log/obm-provisioning/access.log contains the traces of every request received by the service
- /var/log/obm-provisioning/obm-provisioning.log contains others kind of logs
## Additionnal Configuration
The provisioning server can be configured by a number of settings in the _/etc/obm/obm_conf.ini_ file.
### Password Hash
The password, though transmitted as clear text by default, might be hashed before transmission. To enable a hash, use the `password-hash` setting.
| Setting | Type | Default Value | Possible Values |
| ----- |
| password-hash | String| NONE | NONE, MD5, SHA1, SHA256, SHA512 |
Runners Alliance