1GLITE-LB-SETUP(8)                 EMI Project                GLITE-LB-SETUP(8)
2
3
4

NAME

6       glite-lb-setup - script for setting up L&B services
7
8

SYNOPSIS

10       glite-lb-setup [OPTIONS] [ACTION...]
11
12

DESCRIPTION

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
18

OPTIONS

20       -q, --quiet
21              Print only errors.
22
23
24       -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
31
32       -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
38               glite-lb-setup --list
39               glite-lb-setup `glite-lb-setup --list | sed 's/bdii//'`
40
41
42       -h, --help
43              Display help.
44
45

ACTIONS

47       ACTIONS are individual tasks or groups of tasks to be performed  during
48       setup.
49
50
51       all (group)
52              All default actions. If no action is listed in the command line,
53              this one will be performed.
54
55
56       none (group)
57              No action.
58
59
60       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
65
66       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
71
72       upgrade (group)
73              All upgrade actions (remove various obsolete files, ...).
74
75
76       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
81
82       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
87
88       certs  Checks and copies host certificates for L&B services.
89
90
91       msg    Configures EMI Messaging using the glite-lb-msg-config utility.
92
93
94       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
100
101       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
106
107       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
110              Packages bdii, sudo,  and  glite-info-provider-service  must  be
111              intalled for this action to take effect.
112
113
114       emir_info
115              Creates service info file for L&B.
116
117              Package  emir-serp  must  be  installed  for this action to take
118              effect.
119
120
121       emir_daemon
122              Sets up emir-serp daemon.
123
124              Package emir-serp must be installed and $EMIR_URL must be speci‐
125              fied for this action to take effect.
126
127
128       upgrade_files
129              Remove old obsolete files (upgrade from L&B <= 3.1.1).
130
131
132       upgrade_logger
133              Move  L&B  logger  event  files,  if needed (upgrade from L&B <=
134              4.0.1).
135
136
137       upgrade_notif
138              Move L&B notification event files, if needed (upgrade  from  L&B
139              >= 4.0.1).
140
141
142       upgrade_proxy
143              Move  L&B  proxy  event  files,  if  needed (upgrade from L&B >=
144              4.0.1).
145
146
147       upgrade_log4c
148              Check the log4c config file used by L&B and fix it if necessary.
149
150
151       crl    Sets up fetch-crl to fetch CRLs automatically.
152
153
154       startup
155              Sets up automatic startup of all enabled daemons after boot.
156
157
158       krb (run only when GLITE_GSS_MECH=krb5)
159              Sets up Kerberos ticket and credential cache files for L&B.
160
161              Requires L&B built with Kerberos support.
162
163
164       krbgsi (not run by default)
165              Sets up Kerberos and enables GSI authentication.
166
167              Requires L&B built with Kerberos support and modified Globus and
168              Kerberos  libraries.  Tested only with Heimdal implementation of
169              Kerberos.
170
171

FILES

173       /etc/profile.d/gridenv.sh Environment variables for setup  and  startup
174       scripts. Used for interoperability with the YAIM configurator.
175
176       /etc/sysconfig/glite-lb  Environment  variables  for  setup and startup
177       scripts in RedHat-like distributions (RedHat, Scientific Linux, Fedora,
178       ...).
179
180       /etc/default/glite-lb  Environment  variables  for  setup  and  startup
181       scripts in Debian.
182
183

ENVIRONMENT

185       See L&B Admin Guide, chapter 2.3.2 "Standard Installation."
186
187

EXAMPLES

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
193        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
201        mysqladmin -u root password [Edited]
202        MYSQL_PASSWORD=[Edited] glite-lb-setup
203
204

BUGS

206       Please report all bugs to CESNET gLite L&B issue tracker  available  at
207       https://github.com/CESNET/glite-lb/issues
208
209

SEE ALSO

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
214

AUTHOR

216       L&B Product Team, JRA1, EMI.
217
218
219
220November 2012                         19                     GLITE-LB-SETUP(8)
Impressum