Adding a new VO
Collect information about the new VO
Go to the CIC portal ([1]) to collect information about the new VO.
Relevant information are the VOMS server(s), the content for the vomses file, possible VOMS roles and groups to be supported, indications of the number of required pool accounts etc.
Create pool accounts and the gridmapdir
Find a free Unix group ID and user ID range for the pool accounts. This can be achieved with via an ldapsearch query, or easier by using the ldap browser (LBE). LBE is available at the Nikhef desktops via /global/ices/toolset/bin/lbe.
Create pool accounts, home directories for the pool accounts and gridmapdir entries using the procedure described at the following page: [[2]].
The LFC no longer needs a gridmapdir. The Resource Brokers, WMS servers and DPM servers (head node and disk servers) use a dynamic pool account range (dynXXXXX) that is independent of the VO. This gridmapdir is managed by Quattor and does not need modification when adding a new VO.
Create a software installation area
This section is only needed if the VO requires a software installation area.
The software installation areas are located under /export/data/esia at host hoeve. The areas should be created manually, as user root at hoeve.
mkdir /export/data/esia/voname chgrp unixgroup /export/data/esia/voname chmod g+wrs /export/data/esia/voname chmod +t /export/data/esia/voname
If there is a group of pool accounts for sgm users for the VO, unixgroup should match the group for the sgm users.
Add the VO configuration to Quattor profiles
All modifications to the Quattor set up are located in the template hierarchy under directory $L/cfg where $L points to the conf-ns directory under the Quattor root directory. The basic VO definition is (by default) independent of the facility. The rest of the configuration is specific per VO.
grid/vo/params/voname.tpl
Configuration of VO settings like the VOMS server, Unix pool account and group for 1 user, various FQAN for groups and roles, location of the software installation directory, the default storage element etc. The FQANs with special roles or groups must be defined in this list before the plain VO name. Otherwise there is the risk that the VO name with wild cards is the first match when LCMAPS is executed (implying all users are mapped to regular pool accounts and special pool accounts are never used). It is recommended to copy an existing template, rename it and customize its contents. Note that for every VOMS server referenced, a template grid/vo/voms/voms-server.tpl must exist!
grid/vo/voms/voms-server.tpl
Definition of the DN of the host certificate of the server, the port number (usually 8443) and the DN of the CA certificate that was used to sign the VOMS server's certificate.
cluster/facility-name/local/pro_config_lcg2_site.tpl
This file defines variable VOS, which is a list of all supported VO names.
cluster/facility-name/local/pro_config_queues.tpl
Add the name of the new VO (or one or more of its VOMS groups/roles) to the variable TORQUE_QUEUE_ACCESS, which is the source for generating the Torque ACLs. If a VO name is given, all unix groups for that VO get access to the queue. If VO views are needed for VOMS groups/roles, the FQANs can be added to the variable VO_VIEW (which is the source for setting Yaim variables <QUEUE>_GROUP_ENABLE).
cluster/facility-name/local/pro_config_maui.tpl
Add a line to the Maui configuration to specify the fair share and priority of the VO or its groups.
Note: it is no longer needed to add user and group information to Yaim. The contents of those files are now derived from the VO parameters defined above. Via variable USE_DYNAMIC_POOL_ACCOUNTS=true all VOs are mapped to the same dynamic pool account range (dyn00000 and up, group dynamic).
Supporting a subset of the VOs
It is possible to let a host define only a subset of the VOs by defining the variable VOS in the object template before including the machine type template, like in the following example:
# restrict access to the WMS because it is too popular with the gratis VOs
variable VOS ?= list( "vo1", "vo2", "vo3" );
include { 'machine-types/wms' };
This trick is currently used on some WMS and storage systems.
