glusterfsd(8) [centos man page]
GlusterFS(8) Gluster Inc. GlusterFS(8) NAME
GlusterFS - Clustered Filesystem. SYNOPSIS
glusterfsd [options] [mountpoint] DESCRIPTION
GlusterFS is a clustered file-system capable of scaling to several peta-bytes. It aggregates various storage bricks over Infiniband RDMA or TCP/IP interconnect into one large parallel network file system. Storage bricks can be made of any commodity hardware such as x86-64 server with SATA-II RAID and Infiniband HBA. GlusterFS is fully POSIX compliant FileSystem. On client side, it has dependency on FUSE package, on server side, it works seemlessly on different OSes. (Currently supported on GNU/Linux, Solaris). OPTIONS
Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. Basic options -f, --volfile=VOLUME-FILE File to use as VOLUME-FILE [default:/etc/glusterfs/glusterfs.vol] -l, --log-file=LOGFILE File to use for logging [default:/var/log/glusterfs/glusterfs.log] -L, --log-level=LOGLEVEL Logging severity. Valid options are TRACE, DEBUG, INFO, WARNING, ERROR and CRITICAL [default: WARNING] -s, --volfile-server=SERVER Server to get the volume from. This option overrides --volfile option Advanced options --debug Run in debug mode. This option sets --no-daemon, --log-level to DEBUG and --log-file to console -N, --no-daemon Run in foreground --read-only Makes the filesystem read-only -p, --pid-file=PIDFILE File to use as pid file -S SOCKFILE Socket file to used for inter-process communication --brick-name DIRECTORY Directory to be used as export directory for GlusterFS --brick-port PORT Brick Port to be registered with Gluster portmapper --volfile-id=KEY KEY of the volume file to be fetched from server --volfile-server-port=PORT Port number of volfile server --volfile-server-transport=TRANSPORT Transport type to get volume file from server [default: tcp] --volume-name=VOLUME-NAME Volume name to be used for MOUNT-POINT [default: top most volume in VOLUME-FILE] --xlator-option=VOLUME-NAME.OPTION=VALUE Add/override a translator option for a volume with the specified value Fuse options --attribute-timeout=SECONDS Set attribute timeout to SECONDS for inodes in fuse kernel module [default: 1] --entry-timeout=SECONDS Set entry timeout to SECONDS in fuse kernel module [default: 1] --direct-io-mode=BOOL Enable/Disable direct-io mode in fuse module [default: enable] Miscellaneous Options -?, --help Give this help list --usage Give a short usage message -V, --version Print program version FILES
/etc/glusterfs/*.vol EXAMPLES
Start a GlusterFS server on localhost with volume name foo glusterfsd -s localhost --volfile-id foo.server.media-disk-1 -p /var/lib/glusterd/vols/foo/run/server-media-disk-1.pid -S /tmp/<uniqueid>.socket --brick-name /media/disk-1 -l /var/log/glusterfs/bricks/media-disk-1.log --brick-port 24009 --xlator-option foo-server.listen-port=24009 SEE ALSO
fusermount(1), mount.glusterfs(8), gluster(8) COPYRIGHT
Copyright(c) 2006-2011 Gluster, Inc. <http://www.gluster.com> 19 March 2010 Cluster Filesystem GlusterFS(8)
Check Out this Related Man Page
glusterd_selinux(8) SELinux Policy glusterd glusterd_selinux(8) NAME
glusterd_selinux - Security Enhanced Linux Policy for the glusterd processes DESCRIPTION
Security-Enhanced Linux secures the glusterd processes via flexible mandatory access control. The glusterd processes execute with the glusterd_t SELinux type. You can check if you have these processes running by executing the ps com- mand with the -Z qualifier. For example: ps -eZ | grep glusterd_t ENTRYPOINTS
The glusterd_t SELinux type can be entered via the glusterd_exec_t file type. The default entrypoint paths for the glusterd_t domain are the following: /opt/glusterfs/[^/]+/sbin/glusterfsd, /usr/sbin/glusterfsd PROCESS TYPES
SELinux defines process types (domains) for each process running on the system You can see the context of a process using the -Z option to ps Policy governs the access confined processes have to files. SELinux glusterd policy is very flexible allowing users to setup their glus- terd processes in as secure a method as possible. The following process types are defined for glusterd: glusterd_t Note: semanage permissive -a glusterd_t can be used to make the process type glusterd_t permissive. SELinux does not deny access to permis- sive process types, but the AVC (SELinux denials) messages are still generated. BOOLEANS
SELinux policy is customizable based on least access required. glusterd policy is extremely flexible and has several booleans that allow you to manipulate the policy and run glusterd with the tightest access possible. If you want to allow glusterfsd to share any file/directory read only, you must turn on the gluster_export_all_ro boolean. Disabled by default. setsebool -P gluster_export_all_ro 1 If you want to allow glusterfsd to share any file/directory read/write, you must turn on the gluster_export_all_rw boolean. Enabled by default. setsebool -P gluster_export_all_rw 1 If you want to allow users to resolve user passwd entries directly from ldap rather then using a sssd server, you must turn on the authlo- gin_nsswitch_use_ldap boolean. Disabled by default. setsebool -P authlogin_nsswitch_use_ldap 1 If you want to allow all daemons to write corefiles to /, you must turn on the daemons_dump_core boolean. Disabled by default. setsebool -P daemons_dump_core 1 If you want to enable cluster mode for daemons, you must turn on the daemons_enable_cluster_mode boolean. Enabled by default. setsebool -P daemons_enable_cluster_mode 1 If you want to allow all daemons to use tcp wrappers, you must turn on the daemons_use_tcp_wrapper boolean. Disabled by default. setsebool -P daemons_use_tcp_wrapper 1 If you want to allow all daemons the ability to read/write terminals, you must turn on the daemons_use_tty boolean. Disabled by default. setsebool -P daemons_use_tty 1 If you want to deny any process from ptracing or debugging any other processes, you must turn on the deny_ptrace boolean. Enabled by default. setsebool -P deny_ptrace 1 If you want to allow all domains to use other domains file descriptors, you must turn on the domain_fd_use boolean. Enabled by default. setsebool -P domain_fd_use 1 If you want to allow all domains to have the kernel load modules, you must turn on the domain_kernel_load_modules boolean. Disabled by default. setsebool -P domain_kernel_load_modules 1 If you want to allow all domains to execute in fips_mode, you must turn on the fips_mode boolean. Enabled by default. setsebool -P fips_mode 1 If you want to enable reading of urandom for all domains, you must turn on the global_ssp boolean. Disabled by default. setsebool -P global_ssp 1 If you want to allow confined applications to run with kerberos, you must turn on the kerberos_enabled boolean. Enabled by default. setsebool -P kerberos_enabled 1 If you want to allow system to run with NIS, you must turn on the nis_enabled boolean. Disabled by default. setsebool -P nis_enabled 1 If you want to allow confined applications to use nscd shared memory, you must turn on the nscd_use_shm boolean. Disabled by default. setsebool -P nscd_use_shm 1 NSSWITCH DOMAIN
If you want to allow users to resolve user passwd entries directly from ldap rather then using a sssd server for the glusterd_t, you must turn on the authlogin_nsswitch_use_ldap boolean. setsebool -P authlogin_nsswitch_use_ldap 1 If you want to allow confined applications to run with kerberos for the glusterd_t, you must turn on the kerberos_enabled boolean. setsebool -P kerberos_enabled 1 PORT TYPES
SELinux defines port types to represent TCP and UDP ports. You can see the types associated with a port by using the following command: semanage port -l Policy governs the access confined processes have to these ports. SELinux glusterd policy is very flexible allowing users to setup their glusterd processes in as secure a method as possible. The following port types are defined for glusterd: gluster_port_t Default Defined Ports: tcp 24007-24027,38465-38469 MANAGED FILES
The SELinux process type glusterd_t can manage files labeled with the following file types. The paths listed are the default paths for these file types. Note the processes UID still need to have DAC permissions. cluster_var_lib_t /var/lib/pcsd(/.*)? /var/lib/cluster(/.*)? /var/lib/openais(/.*)? /var/lib/pengine(/.*)? /var/lib/corosync(/.*)? /usr/lib/heartbeat(/.*)? /var/lib/heartbeat(/.*)? /var/lib/pacemaker(/.*)? cluster_var_run_t /var/run/crm(/.*)? /var/run/cman_.* /var/run/rsctmp(/.*)? /var/run/aisexec.* /var/run/heartbeat(/.*)? /var/run/cpglockd.pid /var/run/corosync.pid /var/run/rgmanager.pid /var/run/cluster/rgmanager.sk non_security_file_type noxattrfs all files on file systems which do not support extended attributes FILE CONTEXTS
SELinux requires files to have an extended attribute to define the file type. You can see the context of a file using the -Z option to ls Policy governs the access confined processes have to these files. SELinux glusterd policy is very flexible allowing users to setup their glusterd processes in as secure a method as possible. EQUIVALENCE DIRECTORIES glusterd policy stores data with multiple different file context types under the /var/run/glusterd directory. If you would like to store the data in a different directory you can use the semanage command to create an equivalence mapping. If you wanted to store this data under the /srv dirctory you would execute the following command: semanage fcontext -a -e /var/run/glusterd /srv/glusterd restorecon -R -v /srv/glusterd STANDARD FILE CONTEXT SELinux defines the file context types for the glusterd, if you wanted to store files with these types in a diffent paths, you need to exe- cute the semanage command to sepecify alternate labeling and then use restorecon to put the labels on disk. semanage fcontext -a -t glusterd_brick_t '/srv/glusterd/content(/.*)?' restorecon -R -v /srv/myglusterd_content Note: SELinux often uses regular expressions to specify labels that match multiple files. The following file types are defined for glusterd: glusterd_brick_t - Set files with the glusterd_brick_t type, if you want to treat the files as glusterd brick data. glusterd_conf_t - Set files with the glusterd_conf_t type, if you want to treat the files as glusterd configuration data, usually stored under the /etc directory. Paths: /etc/glusterd(/.*)?, /etc/glusterfs(/.*)? glusterd_exec_t - Set files with the glusterd_exec_t type, if you want to transition an executable to the glusterd_t domain. Paths: /opt/glusterfs/[^/]+/sbin/glusterfsd, /usr/sbin/glusterfsd glusterd_initrc_exec_t - Set files with the glusterd_initrc_exec_t type, if you want to transition an executable to the glusterd_initrc_t domain. Paths: /etc/rc.d/init.d/gluster.*, /usr/sbin/glusterd glusterd_log_t - Set files with the glusterd_log_t type, if you want to treat the data as glusterd log data, usually stored under the /var/log directory. glusterd_tmp_t - Set files with the glusterd_tmp_t type, if you want to store glusterd temporary files in the /tmp directories. glusterd_var_lib_t - Set files with the glusterd_var_lib_t type, if you want to store the glusterd files under the /var/lib directory. glusterd_var_run_t - Set files with the glusterd_var_run_t type, if you want to store the glusterd files under the /run or /var/run directory. Paths: /var/run/glusterd(/.*)?, /var/run/glusterd.pid Note: File context can be temporarily modified with the chcon command. If you want to permanently change the file context you need to use the semanage fcontext command. This will modify the SELinux labeling database. You will need to use restorecon to apply the labels. SHARING FILES
If you want to share files with multiple domains (Apache, FTP, rsync, Samba), you can set a file context of public_content_t and pub- lic_content_rw_t. These context allow any of the above domains to read the content. If you want a particular domain to write to the pub- lic_content_rw_t domain, you must set the appropriate boolean. Allow glusterd servers to read the /var/glusterd directory by adding the public_content_t file type to the directory and by restoring the file type. semanage fcontext -a -t public_content_t "/var/glusterd(/.*)?" restorecon -F -R -v /var/glusterd Allow glusterd servers to read and write /var/glusterd/incoming by adding the public_content_rw_t type to the directory and by restoring the file type. You also need to turn on the glusterd_anon_write boolean. semanage fcontext -a -t public_content_rw_t "/var/glusterd/incoming(/.*)?" restorecon -F -R -v /var/glusterd/incoming setsebool -P glusterd_anon_write 1 If you want to allow glusterfsd to modify public files used for public file transfer services. Files/Directories must be labeled pub- lic_content_rw_t., you must turn on the gluster_anon_write boolean. setsebool -P gluster_anon_write 1 COMMANDS
semanage fcontext can also be used to manipulate default file context mappings. semanage permissive can also be used to manipulate whether or not a process type is permissive. semanage module can also be used to enable/disable/install/remove policy modules. semanage port can also be used to manipulate the port definitions semanage boolean can also be used to manipulate the booleans system-config-selinux is a GUI tool available to customize SELinux policy settings. AUTHOR
This manual page was auto-generated using sepolicy manpage . SEE ALSO
selinux(8), glusterd(8), semanage(8), restorecon(8), chcon(1), sepolicy(8) , setsebool(8) glusterd 14-06-10 glusterd_selinux(8)