FAQ

   1 This is the textual form of the GOsa FAQ. Online information with
   2 comments is set up at Wiki: http://oss.gonicus.de/gosa/.
   3
   4 Q: When creating many users for one department, I need to fill some
   5    fields again and again. Is there a shortcut for that?
   6
   7 A: Just create a user template and pre-fill all values you need. You
   8    can use dynamic content, too: uid, sn and givenName will be replaced.
   9    i.E. an entry '/home/%uid' in homeDirectory will be replaced by the
  10    real uid of the user you're creating, %sn.%givenName@yourdomain.com
  11    creates proper email addresses, etc. Templates include group membership.
  12
  13
  14 Q: Can GOsa execute commands after creating/editing/removing users,
  15    departments, etc.
  16
  17 A: Yes. Edit /etc/gosa/gosa.conf's menu section. Each plugin may have
  18    an entry "postremove", "postmodify" and "postcreate".  You can use
  19    ldap attributes as command line options.
  20    i.E. postcreate="/usr/bin/sudo /usr/local/sbin/ftp.setperms %uid '%givenName'"
  21
  22
  23 Q: I'd like to  modify the look of GOsa to fit our CI. How can I create an
  24    own theme?
  25
  26 A: Themes are splitted into two parts. ihtml/ contains templates which
  27    generate the ui, html/ contains all parts that must be readable from
  28    clients. GOsa first looks for predefined files in the directory indirectly
  29    defined via the "theme" parameter in /etc/gosa/gosa.conf. If it can't
  30    find them here, it'll use the default one.
  31
  32    So start over by copying html/themes/default to html/themes/yourtheme
  33    and ihtml/themes/default to ihtml/themes/yourtheme. Change gosa.conf to
  34    contain theme="yourtheme" in section main. Here are some files to edit:
  35
  36    * login.tpl          -> login screen
  37    * framework.tpl      -> page contents
  38    * style.css          -> stylesheets used by GOsa
  39
  40    In fact, the rest of the UI is not converted to smarty, yet. Please be
  41    patient.
  42
  43
  44 Q: How can I let a person do administrative tasks under a specific department?
  45
  46 A: Create a group inside this department. Put all administrative people inside,
  47    go to the "ACL" tab and check all fields these users should be able to adminstrate.
  48
  49
  50 Q: How can I permit users to change some of their own attributes?
  51
  52 A: Same like the point above, but this rule only works for users own attributes
  53    by checking the box on the acl page.
  54
  55
  56 Q: What about applications?
  57
  58 A: GOsa can manage desktop applications in ldap. Create a group and put all users
  59    in there, which have common desktop settings. Go to the "Application" tab and
  60    add all applications common to this group. Applications can be created from the
  61    application plugin.
  62    The idea behind this feature is a script running on the terminal-servers/
  63    workstation which check for applications on login (or on a regular basis using
  64    timestamps). This one will create the corresponding icons on your KDE or GNOME
  65    desktop.
  66
  67
  68 Q: What's this terminal stuff?
  69
  70 A: GOto is - similar to LTSP - a ldap based diskless client system. It is available
  71    from our projects page.
  72
  73
  74 Q: I can't select any mailservers. What's wrong?
  75
  76 A: LDAP stores information about all your servers. The server plugin is not ready
  77    yet, so you've to adjust/add these entries using your favorite ldap tool.
  78
  79
  80 Q: GOsa is not in my native language, can I translate it to my language?
  81
  82 A: Yes. Just go to the locale directory and copy the messages.po file somewhere
  83    else. Edit the copy and put your translations into the msgstr lines. To be
  84    included in next GOsa releases, you may want to send it to the GOsa maintainer.
  85    Finally you need to create a directory with your language code. (i.e. de for
  86    german) containing the LC_MESSAGES directory. Move your messages.po file there
  87    and run 'msgfmt messages.po' in that directory. That's it.
  88
  89    You may need to restart apache, depending on your setup. On Debian, be sure
  90    to have your locale generated (dpkg-reconfigure locales) before.
  91
  92
  93 Q: Can I specify some kind of password policies?
  94
  95 A: You can place the keywords "pwminlen" and "pwdiffer" in the main section of your
  96    gosa.conf. "pwminlen" specifies how many characters a password must have to be
  97    accepted. "pwdiffer" contains the number of characters that must be different
  98    from the previous password.
  99
 100    Note that these only affect passwords that are set by the user, not by the admins.
 101
 102
 103 Q: I've to update passwords on external windows PDCs. Can I add a command to let
 104    synchronize these for me?
 105
 106 A: There's the possibility to add a password hook in gosa.conf's main section using
 107    the keyword "externalpwdhook". The specified command will be executed with
 108    three parameters: /path/to/your/script username oldpassword newpassword
 109
 110    So you can call i.e. smbpasswd to handle your password change on the PDC.
 111
 112
 113 Q: What about templates for vacation messages?
 114
 115 A: Create a directory to keep a set of vacation messages which are readable by the
 116    user that runs your apache. In this example I'll use /etc/gosa/vacation for that.
 117
 118    Put your vacation files in there containing a "DESC:some descriptive text" as the
 119    first line followed by the normal vacation text. You can use all attributes from
 120    the generic tab. I.e.:
 121
 122    /etc/gosa/vacation/business.txt ------------------------------------------------->8
 123    DESC:Away from desk
 124    Hi, I'm currently away from my desk. You can contact me on
 125    my cell phone via %mobile.
 126
 127    Greetings,
 128    %givenName %sn
 129    -----------------------------------------------------------------------------------
 130
 131    Place the config option vacationdir="/etc/gosa/vacation" in the location found in
 132    gosa.conf and a template box is show in the vacation mail tab.
 133
 134
 135 Q: How can I generate automatic ID's for user templates?
 136
 137 A: Add an entry describing your id policy in gosa.conf, location section:
 138
 139    a) using attributes
 140       You can specify LDAP attributes (currently only sn and givenName) in braces {}
 141       and add a percent sign befor it. Optionally you can strip it down to a number
 142       of characters, specified in []. I.e.
 143
 144         idgen="{%sn}-{%givenName[2-4]}"
 145
 146       will generate an ID using the full surename, adding a dash, and adding at least
 147       the first two characters of givenName. If this ID is used, it'll use up to four
 148       characters. If no automatic generation is possible, a input box is shown.
 149
 150    b) using automatic id's
 151       I.e. specifying
 152
 153         idgen="acct{id:3}"
 154
 155       will generate a three digits id with the next free entry appended to "acct".
 156
 157         idgen="ext{id#3}"
 158
 159       will generate a three digits random number appended to "ext".
 160
 161
 162 Q: I'm migrating from the current LDAP, now GOsa does not allow uid's and group
 163    with upper/lower case and spaces. What can I do?
 164
 165 A: Include the strict="no" keyword in your gosa.conf's location section.
 166    WARNING: using strict="no" will cause problems with cyrus/postfix!!
 167
 168
 169 Q: I'd like to place my users under ou=staff, not under ou=people. Can I change
 170    this?
 171
 172 A: Yes. You can change the people and group locations by adding the following
 173    statements to your location sections:
 174
 175    people="ou=staff"
 176    groups="ou=crowds"
 177
 178    After logging in again, people and groups are created in the configured places.
 179    As a side note, you can leave these strings blank for flat structures, too.
 180
 181
 182 Q: I've problems with many objectClass violations/undefined attributes. Can GOsa
 183    check what's missing?
 184
 185 A: Yes. Move away your gosa.conf and go to the GOsa setup. Follow the steps till
 186    you can download the config. If you get up to this point, your schema is ok...
 187
 188
 189 Q: I really don't want dn's containing the CN for user accounts because I don't
 190    want to support anonymous binds for uid resolution. Is it possible to have dn's
 191    containing the uid instead?
 192
 193 A: Yes. Placing the dnmode="uid" keyword in your gosa.conf's location section will
 194    solve your problem.
 195
 196
 197 Q: Hey, I've installed GOsa, but it claims something about "SID and / or RIDBASE
 198    are missing in your configuration". What's wrong?
 199
 200 A: You've configured GOsa to use samba3, but your LDAP has no samba domain object
 201    inside. Either log into samba for the first time to let it create that object,
 202    or supply the sid and ridbase for your domain in your gosa.conf's location, i.e.:
 203
 204    <location name=...>
 205              ...
 206              ridbase="1000"
 207              sid="0-815-4711" \>
 208
 209    Remember to fill in your real domain sid which is retrievable by the command
 210    "net getlocalsid".
 211
 212
 213 Q: We have massive performance problems with using samba as a member server.
 214
 215 A: This is a known issue. We're working around this by putting
 216
 217    <location name=...>
 218         ...
 219         sambaidmapping="true"
 220         ... \>
 221
 222     into the configuration. GOsa will write the additional objectClass sambaIdmapEntry
 223     to the group and user objects.
 224
 225
 226 Q: I get 'The value specified as GID/UID number is too small' when forcing IDs. Why?
 227
 228 A: This is an additional security feature, so that no one can fall back to uid 0. The
 229    default minimum ID is 100. You can set it to every value you like by specifying
 230
 231    <location name=...>
 232         ...
 233         minid="40"
 234         ... \>
 235
 236    in your configuration. In this example 40 will be the smallest ID you can enter.
 237
 238
 239 Q: Aahhrg. I've updated to a new version and my gosa.conf seems to be broken.
 240
 241 A: Some parameters have changed. Please call the fix_config.sh script which is in
 242    the contrib directory.
 243
 244
 245 Q: I've saved my windows workstations in other locations like GOsa is doing it
 246    for decades. Is there a way to change this?
 247
 248 A: Yes. Use the winstation parameter in your location section:
 249
 250    <location name=...>
 251         ...
 252         winstations="ou=machineaccounts"
 253         ... \>
 254
 255
 256 Q: GOsa doesn't seem to follow my referrals. What can I do?
 257
 258 A: Place the option 'recursive = "true"' inside your locations definition
 259    and you should be fine.
 260
 261
 262 Q: I'd like to have TLS based LDAP connections from within GOsa. Is this possible?
 263
 264 A: Yes, add
 265
 266    <main ...>
 267    ...
 268          tls="true"
 269    ... \>
 270
 271    to the main section of GOsa. This switch affects all LDAP connections.
 272
 273
 274 Q: Cyrus folder get created in the style user.username. I prefer the unix hirachy
 275    style user/username. Is it possible to change this?
 276
 277 A: Yes, add
 278
 279    <main ...>
 280    ...
 281          cyrusunixstyle="true"
 282    ... \>
 283
 284    to the main section of GOsa and the folders are created in unix style.
 285
 286
 287 Q: I'd like to do special checks for several plugin parameters. How can I modify
 288    GOsa to take care of these checks?
 289
 290 A: No need to modify anything. Just add a hook the the plugin you'd like to
 291    check:
 292
 293    check="/your/command/binary"
 294
 295    This binary will get an ldif to STDIN for analysis and may write an error message
 296    to STDOUT. Note, that the supplied ldif may NOT be the original target ldif due
 297    to technical reasons.
 298
 299
 300 Q: Is there a way to use ACL independet filtering when using administrative units?
 301
 302 A: Yes. Set STRICT_UNITS to TRUE in your gosa.conf's location section.