/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License, Version 1.0 only * (the "License"). You may not use this file except in compliance * with the License. * * You can obtain a copy of the license at legal-notices/CDDLv1_0.txt * or http://forgerock.org/license/CDDLv1.0.html. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at legal-notices/CDDLv1_0.txt. * If applicable, add the following below this CDDL HEADER, with the * fields enclosed by brackets "[]" replaced with your own identifying * information: * Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END * * * Copyright 2006-2009 Sun Microsystems, Inc. * Portions Copyright 2012-2014 ForgeRock AS. */ package org.opends.server.tasks; import org.forgerock.i18n.LocalizableMessage; import org.opends.messages.TaskMessages; import org.opends.server.backends.task.Task; import org.opends.server.backends.task.TaskState; import org.opends.server.backends.jeb.RebuildConfig; import org.opends.server.backends.jeb.BackendImpl; import org.opends.server.backends.jeb.RebuildConfig.RebuildMode; import org.opends.server.types.Attribute; import org.opends.server.types.AttributeType; import org.opends.server.types.DN; import org.opends.server.types.DirectoryException; import org.opends.server.types.Entry; import org.opends.server.types.InitializationException; import org.opends.server.types.Operation; import org.opends.server.types.Privilege; import org.opends.server.types.ResultCode; import org.opends.server.core.DirectoryServer; import org.opends.server.core.LockFileManager; import org.opends.server.api.ClientConnection; import org.opends.server.api.Backend; import static org.opends.server.core.DirectoryServer.getAttributeType; import static org.opends.server.util.StaticUtils.*; import org.forgerock.i18n.slf4j.LocalizedLogger; import static org.opends.messages.TaskMessages.*; import static org.opends.messages.ToolMessages.*; import static org.opends.server.config.ConfigConstants.*; import java.util.List; import java.util.ArrayList; /** * This class provides an implementation of a Directory Server task that can be * used to rebuild indexes in the JEB backend.. */ public class RebuildTask extends Task { private static final LocalizedLogger logger = LocalizedLogger.getLoggerForThisClass(); String baseDN = null; ArrayList indexes = null; private String tmpDirectory = null; private RebuildMode rebuildMode = RebuildMode.USER_DEFINED; boolean isClearDegradedState = false; /** * {@inheritDoc} */ public LocalizableMessage getDisplayName() { return TaskMessages.INFO_TASK_REBUILD_NAME.get(); } /** * {@inheritDoc} */ @Override public void initializeTask() throws DirectoryException { // If the client connection is available, then make sure the associated // client has the INDEX_REBUILD privilege. Operation operation = getOperation(); if (operation != null) { ClientConnection clientConnection = operation.getClientConnection(); if (!clientConnection.hasPrivilege(Privilege.LDIF_IMPORT, operation)) { LocalizableMessage message = ERR_TASK_INDEXREBUILD_INSUFFICIENT_PRIVILEGES.get(); throw new DirectoryException(ResultCode.INSUFFICIENT_ACCESS_RIGHTS, message); } } Entry taskEntry = getTaskEntry(); AttributeType typeBaseDN; AttributeType typeIndex; AttributeType typeTmpDirectory; AttributeType clearDegradedState; typeBaseDN = getAttributeType(ATTR_REBUILD_BASE_DN, true); typeIndex = getAttributeType(ATTR_REBUILD_INDEX, true); typeTmpDirectory = getAttributeType(ATTR_REBUILD_TMP_DIRECTORY, true); clearDegradedState = getAttributeType(ATTR_REBUILD_INDEX_CLEARDEGRADEDSTATE, true); List attrList; attrList = taskEntry.getAttribute(typeBaseDN); baseDN = TaskUtils.getSingleValueString(attrList); attrList = taskEntry.getAttribute(typeIndex); indexes = TaskUtils.getMultiValueString(attrList); rebuildMode = getRebuildMode(indexes); if (rebuildMode != RebuildMode.USER_DEFINED) { if (indexes.size() != 1) { LocalizableMessage msg = ERR_TASK_INDEXREBUILD_ALL_ERROR.get(); throw new DirectoryException(ResultCode.UNWILLING_TO_PERFORM, msg); } indexes.clear(); } attrList = taskEntry.getAttribute(clearDegradedState); isClearDegradedState = Boolean.parseBoolean(TaskUtils.getSingleValueString(attrList)); attrList = taskEntry.getAttribute(typeTmpDirectory); tmpDirectory = TaskUtils.getSingleValueString(attrList); } private RebuildMode getRebuildMode(List indexList) { for (String s : indexList) { if (s.equalsIgnoreCase(REBUILD_ALL)) { return RebuildMode.ALL; } if (s.equalsIgnoreCase(REBUILD_DEGRADED)) { return RebuildMode.DEGRADED; } } return RebuildMode.USER_DEFINED; } /** * {@inheritDoc} */ protected TaskState runTask() { RebuildConfig rebuildConfig = new RebuildConfig(); try { rebuildConfig.setBaseDN(DN.valueOf(baseDN)); } catch (DirectoryException de) { logger.error(ERR_CANNOT_DECODE_BASE_DN, baseDN, de.getMessageObject()); return TaskState.STOPPED_BY_ERROR; } for (final String index : indexes) { rebuildConfig.addRebuildIndex(index); } // The degraded state is set(if present in args) // during the initialization. rebuildConfig.isClearDegradedState(isClearDegradedState); boolean isBackendNeedToBeEnabled = false; if (tmpDirectory == null) { tmpDirectory = "import-tmp"; } rebuildConfig.setTmpDirectory(tmpDirectory); rebuildConfig.setRebuildMode(rebuildMode); final Backend backend = DirectoryServer.getBackendWithBaseDN(rebuildConfig.getBaseDN()); if (backend == null) { logger.error(ERR_NO_BACKENDS_FOR_BASE, baseDN); return TaskState.STOPPED_BY_ERROR; } if (!(backend instanceof BackendImpl)) { logger.error(ERR_REBUILDINDEX_WRONG_BACKEND_TYPE); return TaskState.STOPPED_BY_ERROR; } // If we are rebuilding one or more system indexes, we have // to acquire exclusive lock. Shared lock in 'cleardegradedstate' mode. String lockFile = LockFileManager.getBackendLockFileName(backend); StringBuilder failureReason = new StringBuilder(); // Disable the backend // Except in 'cleardegradedstate' mode we don't need to disable it. if (!isClearDegradedState) { try { TaskUtils.disableBackend(backend.getBackendID()); } catch (DirectoryException e) { logger.traceException(e); logger.error(e.getMessageObject()); return TaskState.STOPPED_BY_ERROR; } try { if (!LockFileManager.acquireExclusiveLock(lockFile, failureReason)) { logger.error(ERR_REBUILDINDEX_CANNOT_EXCLUSIVE_LOCK_BACKEND, backend.getBackendID(), failureReason); return TaskState.STOPPED_BY_ERROR; } } catch (Exception e) { logger.error(ERR_REBUILDINDEX_CANNOT_EXCLUSIVE_LOCK_BACKEND, backend .getBackendID(), getExceptionMessage(e)); return TaskState.STOPPED_BY_ERROR; } } else { // We just need a shared lock on the backend for this part. try { if (!LockFileManager.acquireSharedLock(lockFile, failureReason)) { logger.error(ERR_REBUILDINDEX_CANNOT_SHARED_LOCK_BACKEND, backend.getBackendID(), failureReason); return TaskState.STOPPED_BY_ERROR; } } catch (Exception e) { logger.error(ERR_REBUILDINDEX_CANNOT_SHARED_LOCK_BACKEND, backend .getBackendID(), getExceptionMessage(e)); return TaskState.STOPPED_BY_ERROR; } } TaskState returnCode = TaskState.COMPLETED_SUCCESSFULLY; // Launch the rebuild process. try { BackendImpl jebBackend = (BackendImpl) backend; jebBackend.rebuildBackend(rebuildConfig); } catch (InitializationException e) { // This exception catches all 'index not found' // The backend needs to be re-enabled at the end of the process. LocalizableMessage message = ERR_REBUILDINDEX_ERROR_DURING_REBUILD.get(e.getMessage()); logger.traceException(e); logger.error(message); isBackendNeedToBeEnabled = true; returnCode = TaskState.STOPPED_BY_ERROR; } catch (Exception e) { logger.traceException(e); logger.error(ERR_REBUILDINDEX_ERROR_DURING_REBUILD, e.getMessage()); returnCode = TaskState.STOPPED_BY_ERROR; } finally { // Release the lock on the backend. try { lockFile = LockFileManager.getBackendLockFileName(backend); failureReason = new StringBuilder(); if (!LockFileManager.releaseLock(lockFile, failureReason)) { logger.warn(WARN_REBUILDINDEX_CANNOT_UNLOCK_BACKEND, backend.getBackendID(), failureReason); returnCode = TaskState.COMPLETED_WITH_ERRORS; } } catch (Throwable t) { logger.warn(WARN_REBUILDINDEX_CANNOT_UNLOCK_BACKEND, backend.getBackendID(), getExceptionMessage(t)); returnCode = TaskState.COMPLETED_WITH_ERRORS; } } // The backend must be enabled only if the task is successful // for prevent potential risks of database corruption. if ((returnCode == TaskState.COMPLETED_SUCCESSFULLY || (isBackendNeedToBeEnabled)) && !isClearDegradedState) { // Enable the backend. try { TaskUtils.enableBackend(backend.getBackendID()); } catch (DirectoryException e) { logger.traceException(e); logger.error(e.getMessageObject()); returnCode = TaskState.STOPPED_BY_ERROR; } } return returnCode; } }