From cc89083f1177606d4cbbb52f8cdc5e34d0d16f70 Mon Sep 17 00:00:00 2001 From: Rich Megginson Date: Wed, 9 Sep 2009 17:01:49 -0600 Subject: Add update code - make setup-ds.pl -u do updates Updates are implemented in: perl - code that plugs in to setup - scriptlets that are imported into the setup perl interpreter and executed in process, giving access to all of the packages and context provided by setup ldif - applied to instances, in the same manner as ConfigFile directives to setup other - any executable file, shell script, etc. can be invoked, with a limited amount of context from the setup process An update directory is added to the package - /usr/share/dirsrv/update - this directory contains the update files - the update filenames begin with two digits and are executed in numeric order (00 first, then 01, etc. up to 99) which should provide enough flexibility In addition, there are 5 stages of update: pre - invoked before any instance specific code preinst, runinst, postinst - invoked for each instance post - invoked after any instance specific code Example files are provided which demonstrate how to get the context. There are two different modes of operation for update: online - must supply a bind dn and password for each instance - servers must be up and running offline - operates directly on the dse.ldif - servers must be shutdown first A new section is added to the .inf file that can be passed in [slapd-instancename] RootDN = binddn RootDNPwd = bindpw The RootDN is optional - if not supplied, it will get the nsslapd-rootdn attribute from the dse.ldif for the instance. I also fixed some problems with error messages. The pam pta plugin entry was giving object class violations, so I added the missing attributes - note that these are replaced by the plugin code when the plugin is loaded - they are only needed during setup. Fixed usage of $_ - $_ behaves like a dynamically scoped variable - which means if you use it in an outer context, you cannot use it in an inner context, even if it is used in a different function. Rather than attempting to figure out how to use $_ safely in lower level functions, I just removed the use of it altogether, which also makes the code easier to read. Reviewed by: nhosoi (Thanks!) - fixed minor issues found Platforms tested: Fedora 11 --- ldap/admin/src/scripts/exampleupdate.sh | 63 +++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 ldap/admin/src/scripts/exampleupdate.sh (limited to 'ldap/admin/src/scripts/exampleupdate.sh') diff --git a/ldap/admin/src/scripts/exampleupdate.sh b/ldap/admin/src/scripts/exampleupdate.sh new file mode 100644 index 00000000..dae2e4c5 --- /dev/null +++ b/ldap/admin/src/scripts/exampleupdate.sh @@ -0,0 +1,63 @@ +#!/bin/sh +# BEGIN COPYRIGHT BLOCK +# This Program is free software; you can redistribute it and/or modify it under +# the terms of the GNU General Public License as published by the Free Software +# Foundation; version 2 of the License. +# +# This Program is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License along with +# this Program; if not, write to the Free Software Foundation, Inc., 59 Temple +# Place, Suite 330, Boston, MA 02111-1307 USA. +# +# In addition, as a special exception, Red Hat, Inc. gives You the additional +# right to link the code of this Program with code not covered under the GNU +# General Public License ("Non-GPL Code") and to distribute linked combinations +# including the two, subject to the limitations in this paragraph. Non-GPL Code +# permitted under this exception must only link to the code of this Program +# through those well defined interfaces identified in the file named EXCEPTION +# found in the source code files (the "Approved Interfaces"). The files of +# Non-GPL Code may instantiate templates or use macros or inline functions from +# the Approved Interfaces without causing the resulting work to be covered by +# the GNU General Public License. Only Red Hat, Inc. may make changes or +# additions to the list of Approved Interfaces. You must obey the GNU General +# Public License in all respects for all of the Program code and other code used +# in conjunction with the Program except the Non-GPL Code covered by this +# exception. If you modify this file, you may extend this exception to your +# version of the file, but you are not obligated to do so. If you do not wish to +# provide this exception without modification, you must delete this exception +# statement from your version and license this file solely under the GPL without +# exception. +# +# +# Copyright (C) 2009 Red Hat, Inc. +# All rights reserved. +# END COPYRIGHT BLOCK +# + +# There are several environment variables passed in: +my $PRE_STAGE = "pre"; +my $PREINST_STAGE = "preinst"; +my $RUNINST_STAGE = "runinst"; +my $POSTINST_STAGE = "postinst"; +my $POST_STAGE = "post"; + +# $DS_UPDATE_STAGE - the current stage of the update - one of +# pre - called at the beginning of the update +# preinst - called before processing an instance +# runinst - the main update stage for an instance +# postinst - called after processing an instance +# post - called the the end of the update +# you should definitely check the stage to make sure you only perform +# your actions during the correct stage e.g. + +if [ "$DS_UPDATE_STAGE" != "pre" ] ; then + exit 0 +fi + +# $DS_UPDATE_DIR - the main config directory containing the schema dir +# the config dir and the instance specific (slapd-instance) directories +# $DS_UPDATE_INST - the name of the instance (slapd-instance), if one of the instance specific stages +# $DS_UPDATE_DSELDIF - the full path ane filename of the dse.ldif file for the instance -- cgit