1. Partner Logo German Cancio – WP4-install LCFG HOW-TO - n° 1 LCFGng configuration examples Updated 10/2002 German.Cancio@cern.ch

2. German Cancio – WP4-install LCFG HOW-TO - n° 2 LCFG Configuration examples Component configurations RPM configurations

3. German Cancio – WP4-install LCFG HOW-TO - n° 3 LCFGng configuration: examples 1. Component configuration files

4. German Cancio – WP4-install LCFG HOW-TO - n° 4 LCFGng configuration: Components  The components are installed on the client in the following directory: /etc/obj u Each component has a man page describing its functionality and configuration needs. man edg-lcfg- for EDG created or modified components man lcfg- for ‘untouched’ LCFG components. u On the server, a resource definition file exists for each component, which may also contain default values. The resource definition files (.def) are found on the client under /usr/lib/lcfg/defaults/client n These defaults can be overwritten by the.h template files

5. German Cancio – WP4-install LCFG HOW-TO - n° 5 LCFGng configuration: components (cont.) u Once the configuration of the node is ready, it has to be validated and compiled into an XML profile, which is then read by the clients.  The compilation/validation is done by mkxprof. u Mkxprof is run like: /usr/sbin/mkxprof –v, eg. /usr/sbin/mkxprof –v testbed0314 u Mkxprof will inform if there were warnings or errors during the compilation. u Mkxprof generates the XML file into the following directory: /var/obj/conf/server/web/profiles/ /

6. German Cancio – WP4-install LCFG HOW-TO - n° 6 LCFGng configuration: components (cont) u Mkxprof can also generate a HTML status page: http:// /status/ http:// /details  Unfortunately, mkxprof has to be run with the –s option for updating the HTML status page, and no output is produced on the terminal ;-( n /usr/sbin/mkxprof –v –s testbed0314 u Alternatively, mkxprof can be started from an init.d script, and the compilations can be run by running n /sbin/service mkxprofd reload

7. German Cancio – WP4-install LCFG HOW-TO - n° 7 LCFGng configuration: components (cont) Most commonly checked/modified configuration entries for basic components: Auth component: auth.xxx  The auth component manages the /etc/password file. u Most used resources: n auth.rootpwdencrypted root password n auth.usersspace separated list of user login names n auth.userpwd_ encrypted password for n auth.userhome_ home directory for n auth.usergroup_ group names or numbers for n auth.usershell_ shell for n auth.usercomment. Comment field in passwd file (usually user full name) n auth.groupsspace separated list of groups

8. German Cancio – WP4-install LCFG HOW-TO - n° 8 LCFGng configuration: components (cont) Profile component: profile.xxx u The profile component manages the list of components included on the client node. u Most used resource: n profile.componentsspace separated list of components to be included on the client n profile.version_ “XML profile version” (usually: 1) Boot component: boot.xxx u The boot component manages the list of components started on boot time on the client node. u Most used resource: n boot.servicesspace separated list of components to be started (in order)

9. German Cancio – WP4-install LCFG HOW-TO - n° 9 LCFGng configuration: components (cont) Client object: client.xxx u The client component configures the LCFGng client software running on the client. u Most used resources: n client.urlURL pointing to where to fetch XML profile from server n client.polltime interval between server configuration polls

10. German Cancio – WP4-install LCFG HOW-TO - n° 10 LCFGng configuration: components (cont) Network component: network.xxx u The network component configures the network interfaces. u Most used resources: n network.interfacesknown interfaces (eg. eth0, lo) n network.ipaddr_ IPv4 address for n network.hostname_ name associated with (eg. localhost for lo, myhost for eth0) n network.broadcast_ broadcast address for n network.netmask_ netmask for n network.gatewaygateway host n network.nameserversspace separated list of name servers

11. German Cancio – WP4-install LCFG HOW-TO - n° 11 LCFGng configuration: components (cont) Nfsmount component: nfsmount.xxx u The nfsmount component configures the NFS client. u Most used resources: n nfsmount.nfsmountlist of mount “elements” n nfsmount.nfsdetails_ mount information (mount point, server, details)

12. German Cancio – WP4-install LCFG HOW-TO - n° 12 LCFGng configuration: components (cont) Updaterpms component: updaterpms.xxx u The updaterpms component configures the RPM package manager agent, updaterpms. u Most used resources: n updaterpms.mailemail address for failure notifications n updaterpms.rpmdircolon-separated list of directories where to search for RPM’s (usually mounted over NFS from server) n updaterpms.rpmcfgdirdirectory where to find RPM configs (usually mounted over NFS from server) n updaterpms.initrpmcfgfirst installation time RPM configuration file (contains only minimal set of RPM’s) n updaterpms.rpmcfgfinal RPM configuration file n updaterpms.localpkgsAccept or not locally installed packages. (By default:no local pkgs)

13. German Cancio – WP4-install LCFG HOW-TO - n° 13 LCFGng configuration: Components (cont) u The configuration information as known to the client can be checked using the ‘qxprof’ command on the client. Syntax: qxprof component[.resource] # qxprof auth.rootpwd rootpwd=HjkdoejW443yZ # qxprof updaterpms.rpmcfg Rpmcfg=ngclient # qxprof client.url url=http://lxshare434.cern.ch/profiles/cern.ch u Qxprof can be called also only with the name of the component. Then it dumps all component configuration. u Last but not least: LCFGng components keep a log file on the client: /var/obj/log

14. German Cancio – WP4-install LCFG HOW-TO - n° 14 LCFGng configuration: examples 2. RPM configuration files

15. German Cancio – WP4-install LCFG HOW-TO - n° 15 LCFGng configuration: RPM config files  The RPM configuration files are stored under /opt/local/linux/6.2/rpmcfg. n Template configurations can be downloaded from the EDG CVS. u They include two types of files: header files (.h) and template configurations.  The ‘ ngclient-static’ file contains the minimal configuration for a simple LCFGng client node running RH62 (no EDG services)  More sophisticated testbed RPM config files are used for advanced testbed nodes ( UI-rpm, CE-rpm …) u The configuration resource updaterpms.rpmcfg should contain the name of the RPM configuration file, eg. n updaterpms.rpmcfgngclient-static, OR n updaterpms.rpmcfgUI-rpm u RPM configuration files are not compiled on the server (this is done at the client)