SEE-GRID-SCI Overview of YAIM and SEE-GRID-SCI YAIM templates Dusan Vudragovic Institute of Physics Belgrade Serbia The SEE-GRID-SCI initiative is co-funded by the European Commission under the FP7 Research Infrastructures contract no Regional SEE-GRID-SCI Training for Site Administrators Institute of Physics Belgrade March 5-6, 2009

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, What is YAIM YAIM = Yaim Ain't an Installation Manager YAIM is software to configure Grid services YAIM provides simple configuration methods YAIM has been implemented as a set of bash scripts To support the EGEE project's component based release model YAIM 4 has been modularized YAIM core is supplemented by component specific scripts, distributed as separate RPMs YAIM’s logo – the yak The yak is a long-haired humped domestic bovine found in Tibet and throughout the Himalayan region of south Central Asia, as well as in Mongolia. The yak is not a gnu.

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, YAIM’s directory structure (1/2) YAIM directory structure is created under /opt/glite/yaim  /functions/ - Functions (bash scripts) to configure node types  /functions/local/ - Site administrators can put here their own function definition files  /functions/pre/ - If this function exists, will be executed before the main function  /functions/post/ - If this function exists, will be executed after the main function  /node-info.d/ - Contains a file for each node type which defines the set of functions to be executed during the configuration of that node type

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, YAIM’s directory structure (2/2)  /defaults/ - Files that will be sourced before and after the main site-info.def ; purpose is to give meaningful default values  /bin/ - The main YAIM executable  /log/ - YAIM's logfile  /examples/ - Configuration example

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, YAIM’s configuration directory structure YAIM allows having the site's configuration in a well separated and protected place The site-info.def file has to sit in a directory (ex.: /root/siteinfodir/ ) which could contain the followings  site-info.def - main configuration file of the site  services/ - files are sourced only when that given service is configured  nodes/ - files are sourced only when that given host is configured  vo.d/ - files can contain VO specific variables  users.conf, groups.conf - configurable via the USERS_CONF and GROUPS_CONF variables

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, The bin/yaim command (1/2) Usage /opt/glite/yaim/bin/yaim Actions -c | --configure – configure services -r | --runfunction – execute a configuration function -v | --verify – check variables definition -d | --debug – logging level -e | --explain – explains what the functions are doing -h | --help – help -a | --available –available configuration targets

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, The bin/yaim command (2/2) Parameters -s | --siteinfo – location of the site-info.def file -n | --nodetype – node name to configure -f | --function – function to execute Examples  Configuration./yaim –c –s /root/siteinfo/site-info.def –n SE_dpm_mysql –d 6  Running a function separately./yaim –r –s /root/siteinfo/site-info.def –n LFC_mysql –f config_gip  Verify your site-info.def./yaim –v –s /root/siteinfo/site-info.def –n SE_dpm_mysql

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, Configuration flow (1/2) When launching the configuration the different configuration files will be sourced and will overwrite each other in the following order  /opt/glite/yaim/defaults/site-info.pre (Y)  /opt/glite/yaim/defaults/myservice.pre (S)  /root/siteinfo/site-info.def (S)  /opt/glite/yaim/defaults/site-info.post (Y)  /opt/glite/yaim/defaults/myservice.post (S)  /root/siteinfo/services/mysevice (S)  /root/siteinfo/nodes/mynode (S)  /root/siteinfo/vo.d/myvo (S)  /opt/glite/yaim/node-info.d/myservice (Y)

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, Configuration flow (2/2) For each function myfunc defined in /opt/glite/yaim/node- info.d/myservice yaim executes the followings if they are defined  /opt/glite/yaim/functions/pre/myfunc  /opt/glite/yaim/functions/local/myfunc OR /opt/glite/yaim/functions/myfunc  /opt/glite/yaim/functions/post/myfunc

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, The log file YAIM logs its output to /opt/glite/yaim/log/yaim/yaimlog Each time the yaim command is executed an entry is added to this logfile containing the  command executed  the site-info.def and other config files used  the time and date information  the version of the installed YAIM RPMs

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, SEE-GRID-SCI YAIM template SEE-GRID-SCI YAIM siteinfo directory template is available at

Regional SEE-GRID-SCI Training for Site Administrators, Institute of Physics Belgrade, March 5-6, Other useful info YAIM home page YAIM 4 guide for sysadmins YAIM Status Page gLite 3.1 Generic Installation & Configuration guide