Commit b9ded292 authored by Victor Penso's avatar Victor Penso Committed by Victor Penso
Browse files

add client config documentation

parent 8ba2a4e8
Description
===========
Requirements
============
The "cvmfs" cookbook deploys [CernVM File System][1] (CernVM-FS).
Attributes
==========
**Requirements**
* Chef version >=10.12
* [sys][2] cookbook > 0.10.0
**Platforms**
* Debian 7 (Wheezy)
* No other platforms supported yet.
In order to develop this cookbook are for basic understanding
read the “[Manual Deployment][3]” guide.
Usage
=====
[1]: http://cernvm.cern.ch/portal/filesystem
[2]: https://github.com/vpenso/sys-chef-cookbook
[3]: documents/manual.markdown
CernVM-FS Clients
=================
Mount CernVM-FS repositories on a node.
`attributes/clients.rb`
`recipes/clients.rb`
`templates/default/etc_cvmfs_default.local.erb`
`templates/default/etc_cvmfs_config.d_generic.local.erb`
`tests/roles/cvmfs_client_test.rb`
Attributes
----------
Default configuration affecting all mounted repositories
is defined with attributes in `node.cvmfs.default_local`,
and written to `/etc/cvmfs/default.local`.
* `cache_base` (default `/var/cache/cvmfs`) – Path to the local repository cache.
* `quota_limit` (default 20000) – Maximum local storage consumes by a repository (in MB).
* `max_ttl` (default 30) – Metadata synchronisation interval (in minutes).
Defining a repository in `node.cvmfs.client.config_d` will render a
configuration file in `/etc/cvmfs/config.d/*.local`. (Fore a complete
list of available configuration keys refer to the [CernVM-FS Technical
Report][3].)
Example
-------
"cvmfs" => {
"client" => {
"default_local" => {
"cache_base" => "/opt/cvmfs/cache",
"quota_limit" => -1,
"max_ttl" => 60
},
"config_d" => {
"repo1.devops.test" => {
"server_url" => "http://lxcvmfs01.devops.test/cvmfs/repo1.devops.test",
"http_proxy" => "DIRECT",
"public_key" => "/etc/cvmfs/keys/repo1.devops.test.pub"
},
"repo2.devops.test" => {
"server_url" => "http://lxcvmfs02.devops.test/cvmfs/repo2.devops.test",
"public_key" => "/etc/cvmfs/keys/repo2.devops.test.pub",
"quota_limit" => 20000
}
}
}
}
[3]: http://cernvm.cern.ch/portal/filesystem/techinformation
......@@ -18,16 +18,12 @@
#
node.default[:sys][:autofs][:master][:'/cvmfs'][:map] = '/etc/auto.cvmfs'
include_recipe 'sys::autofs'
# Make sure the CMVFS user can use FUSE
# to mount a repositories
node.default[:sys][:fuse][:config] = {
'mount_max' => 1000,
'user_allow_other' => ''
}
# Deploy the changes using the Sys cookbook
node.default[:sys][:fuse][:config][:mount_max] = 1000
node.default[:sys][:fuse][:config][:user_allow_other] = ''
include_recipe 'sys::fuse'
user 'cvmfs' do
......@@ -46,10 +42,6 @@ directory node.cvmfs.client.default_local.cache_base do
recursive true
end
#unless node.cvmfs.client.default_local.has_key? 'repositories'
# node.default[:cvmfs][:client][:default_local][:repositories] = "#{node.cvmfs.client.config_d.join(',')}"
#end
template '/etc/cvmfs/default.local' do
source 'etc_cvmfs_default.local.erb'
mode "0644"
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment