1GLITE-LB-SETUP(8) EMI Project GLITE-LB-SETUP(8)
2
6 glite-lb-setup - script for setting up L&B services
7
10 glite-lb-setup [OPTIONS] [ACTION...]
11
14 The glite-lb-setup script sets up the L&B server based on environment
15 and sourced files. The setup process is divided into individual
16 ACTIONS.
17
20 -q, --quiet
21 Print only errors.
22 -c, --check
25 Check database availability (check if setup has been already
26 performed). In case there are no other ACTIONS listed, no
27 default actions are performed and glite-lb-setup will exit imme‐
28 diately with return code 0 (if database exists) or 1 (in other
29 cases).
30 -l, --list
33 List ACTIONS to be executed and exit. This option can be used to
34 view and/or select actions to be performed during setup. For
35 example, the following pair of commands lists available actions
36 and runs the setup omitting BDII:
37 glite-lb-setup --list
39 glite-lb-setup `glite-lb-setup --list | sed 's/bdii//'`
40 -h, --help
43 Display help.
44
47 ACTIONS are individual tasks or groups of tasks to be performed during
48 setup.
49 all (group)
52 All default actions. If no action is listed in the command line,
53 this one will be performed.
54 none (group)
57 No action.
58 yaim (group)
61 Actions to be run when launching setup from within the YAIM con‐
62 figurator. Some regular actions (like BDII or CRL) are already
63 covered by YAIM, so they are not performed.
64 logger (group)
67 Only actions needed to set up and L&B logger will be performed.
68 This action consists in setting up certificates, messaging, and
69 running the update action.
70 upgrade (group)
73 All upgrade actions (remove various obsolete files, ...).
74 emir (group)
77 Publish L&B service info to EMIR - complete setup. Provides ser‐
78 vice info for L&B (emir_info action) and setup and launch emir-
79 serp daemon (emir_daemon action).
80 db Checks MySQL, enables MySQL configuration for L&B, sets up the
83 database with grants if it doesn't exist and creates indices.
84 Migrates DB from L&B version 3.x if necessary. MySQL server
85 startup is handled in startup, if enabled.
86 certs Checks and copies host certificates for L&B services.
89 msg Configures EMI Messaging using the glite-lb-msg-config utility.
92 authz Creates file /etc/glite-lb/glite-lb-authz.conf based on all of
95 the following configuration variables: type of L&B node
96 ($GLITE_LB_TYPE), service DNs ($GLITE_LB_WMS_DN,
97 $GLITE_LB_SUPER_USERS, $GLITE_LB_RTM_DN) and fine-tuning vari‐
98 ables $GLITE_LB_AUTHZ_*.
99 harvester
102 If enabled ($GLITE_LB_HARVESTER_ENABLED), L&B harvester will be
103 set up and launched. It will be configured to gather notifica‐
104 tions from local L&B server.
105 bdii Sets up the BDII service and gLite info provider wrappers for
108 L&B. BDII service startup is handled in startup, if enabled.
109 Packages bdii, sudo, and glite-info-provider-service must be
111 intalled for this action to take effect.
112 emir_info
115 Creates service info file for L&B.
116 Package emir-serp must be installed for this action to take
118 effect.
119 emir_daemon
122 Sets up emir-serp daemon.
123 Package emir-serp must be installed and $EMIR_URL must be speci‐
125 fied for this action to take effect.
126 upgrade_files
129 Remove old obsolete files (upgrade from L&B <= 3.1.1).
130 upgrade_logger
133 Move L&B logger event files, if needed (upgrade from L&B <=
134 4.0.1).
135 upgrade_notif
138 Move L&B notification event files, if needed (upgrade from L&B
139 >= 4.0.1).
140 upgrade_proxy
143 Move L&B proxy event files, if needed (upgrade from L&B >=
144 4.0.1).
145 upgrade_log4c
148 Check the log4c config file used by L&B and fix it if necessary.
149 crl Sets up fetch-crl to fetch CRLs automatically.
152 startup
155 Sets up automatic startup of all enabled daemons after boot.
156 krb (run only when GLITE_GSS_MECH=krb5)
159 Sets up Kerberos ticket and credential cache files for L&B.
160 Requires L&B built with Kerberos support.
162 krbgsi (not run by default)
165 Sets up Kerberos and enables GSI authentication.
166 Requires L&B built with Kerberos support and modified Globus and
168 Kerberos libraries. Tested only with Heimdal implementation of
169 Kerberos.
170
173 /etc/profile.d/gridenv.sh Environment variables for setup and startup
174 scripts. Used for interoperability with the YAIM configurator.
175 /etc/sysconfig/glite-lb Environment variables for setup and startup
177 scripts in RedHat-like distributions (RedHat, Scientific Linux, Fedora,
178 ...).
179 /etc/default/glite-lb Environment variables for setup and startup
181 scripts in Debian.
182
185 See L&B Admin Guide, chapter 2.3.2 "Standard Installation."
186
189 Set up an L&B server running in the combined proxy and server ("BOTH")
190 mode in Scientific Linux, granting WMS-specific permissions to the
191 given gLite WMS instance:
192 cat >> /etc/sysconfig/glite-lb <<EOF
194 SITE_NAME=mysite
195 SITE_EMAIL=email@example.com
196 GLITE_LB_TYPE=both
197 GLITE_LB_WMS_DN=\
198 "/C=UG/L=Tropic/O=Utopia/OU=Relaxation/CN=wms.example.com"
199 EOF
200 mysqladmin -u root password [Edited]
202 MYSQL_PASSWORD=[Edited] glite-lb-setup
203
206 Please report all bugs to CESNET gLite L&B issue tracker available at
207 https://github.com/CESNET/glite-lb/issues
208
211 yaim(1) glite-lb-bkindex(8) glite-lb-bkserverd(8) glite-lb-interlogd(8)
212 glite-lb-logd(8) glite-lb-harvester(8)
213
216 L&B Product Team, JRA1, EMI.
217November 2012 19 GLITE-LB-SETUP(8)