/* * 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 * trunk/opends/resource/legal-notices/OpenDS.LICENSE * or https://OpenDS.dev.java.net/OpenDS.LICENSE. * 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 * trunk/opends/resource/legal-notices/OpenDS.LICENSE. 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 * * * Portions Copyright 2007 Sun Microsystems, Inc. */ package org.opends.quicksetup.upgrader; import org.opends.quicksetup.*; import org.opends.quicksetup.upgrader.ui.WelcomePanel; import org.opends.quicksetup.upgrader.ui.ChooseVersionPanel; import org.opends.quicksetup.upgrader.ui.UpgraderReviewPanel; import org.opends.quicksetup.util.Utils; import org.opends.quicksetup.util.FileManager; import org.opends.quicksetup.util.ServerController; import org.opends.quicksetup.util.ZipExtractor; import org.opends.quicksetup.ui.*; import java.awt.event.WindowEvent; import java.util.*; import java.util.logging.Level; import java.util.logging.Logger; import java.io.*; import java.net.URL; import java.net.MalformedURLException; import static org.opends.quicksetup.Installation.*; /** * QuickSetup application of ugrading the bits of an installation of * OpenDS. */ public class Upgrader extends GuiApplication implements CliApplication { /** * Steps in the Upgrade wizard. */ enum UpgradeWizardStep implements WizardStep { WELCOME("welcome-step"), CHOOSE_VERSION("step-upgrade-choose-version"), REVIEW("review-step"), PROGRESS("progress-step"); private String msgKey; private UpgradeWizardStep(String msgKey) { this.msgKey = msgKey; } /** * {@inheritDoc} */ public String getMessageKey() { return msgKey; } } /** * Steps during the upgrade process. */ enum UpgradeProgressStep implements ProgressStep { NOT_STARTED("summary-upgrade-not-started"), DOWNLOADING("summary-upgrade-downloading"), EXTRACTING("summary-upgrade-extracting"), INITIALIZING("summary-upgrade-initializing"), STARTING_SERVER("summary-starting"), STOPPING_SERVER("summary-stopping"), CALCULATING_SCHEMA_CUSTOMIZATIONS( "summary-upgrade-calculating-schema-customization"), CALCULATING_CONFIGURATION_CUSTOMIZATIONS( "summary-upgrade-calculating-config-customization"), BACKING_UP_DATABASES("summary-upgrade-backing-up-db"), BACKING_UP_FILESYSTEM("summary-upgrade-backing-up-files"), UPGRADING_COMPONENTS("summary-upgrade-upgrading-components"), APPLYING_SCHEMA_CUSTOMIZATIONS( "summary-upgrade-applying-schema-customization"), APPLYING_CONFIGURATION_CUSTOMIZATIONS( "summary-upgrade-applying-config-customization"), VERIFYING("summary-upgrade-verifying"), RECORDING_HISTORY("summary-upgrade-history"), CLEANUP("summary-upgrade-cleanup"), ABORT("summary-upgrade-abort"), FINISHED_WITH_ERRORS("summary-upgrade-finished-with-errors"), FINISHED("summary-upgrade-finished-successfully"); private String summaryMsgKey; private UpgradeProgressStep(String summaryMsgKey) { this.summaryMsgKey = summaryMsgKey; } /** * Return a key for access a summary message. * * @return String representing key for access summary in resource bundle */ public String getSummaryMesssageKey() { return summaryMsgKey; } /** * {@inheritDoc} */ public boolean isLast() { return this == FINISHED || this == FINISHED_WITH_ERRORS; } /** * {@inheritDoc} */ public boolean isError() { return this == FINISHED_WITH_ERRORS; } } static private final Logger LOG = Logger.getLogger(Upgrader.class.getName()); // Root files that will be ignored during backup static private final String[] ROOT_FILES_TO_IGNORE_DURING_BACKUP = { CHANGELOG_PATH_RELATIVE, // changelogDb DATABASES_PATH_RELATIVE, // db LOGS_PATH_RELATIVE, // logs LOCKS_PATH_RELATIVE, // locks HISTORY_PATH_RELATIVE, // history TMP_PATH_RELATIVE // tmp }; private ProgressStep currentProgressStep = UpgradeProgressStep.NOT_STARTED; /** * Assigned if an exception occurs during run(). */ private ApplicationException runException = null; /** * Helps with CLI specific tasks. */ private UpgraderCliHelper cliHelper = null; /** * Directory where backup is kept in case the upgrade needs reversion. */ private File backupDirectory = null; /** * ID that uniquely identifieds this invocation of the Upgrader in the * historical logs. */ private Long historicalOperationId; /** SVN rev number of the current build. */ private Integer currentVersion = null; /** New OpenDS bits. */ private Installation stagedInstallation = null; /** SVN rev number of the build in the stage directory. */ private Integer stagedVersion = null; private RemoteBuildManager remoteBuildManager = null; /** * Creates a default instance. */ public Upgrader() { if (Utils.isWebStart()) { initLoader(); } } /** * {@inheritDoc} */ public String getFrameTitle() { return getMsg("frame-upgrade-title"); } /** * {@inheritDoc} */ public WizardStep getFirstWizardStep() { return UpgradeWizardStep.WELCOME; } /** * {@inheritDoc} */ protected void setWizardDialogState(QuickSetupDialog dlg, UserData userData, WizardStep step) { // TODO } /** * Gets a remote build manager that this class can use to find * out about and download builds for upgrading. * @return RemoteBuildManager to use for builds */ public RemoteBuildManager getRemoteBuildManager() { if (remoteBuildManager == null) { try { // TODO: make this configurable. // The slash at the end of the URL was/is important in getting the // correct redirection from the web server URL buildRepo = new URL("http://builds.opends.org/"); remoteBuildManager = new RemoteBuildManager(this, buildRepo); } catch (MalformedURLException e) { LOG.log(Level.INFO, "error", e); } } return remoteBuildManager; } /** * {@inheritDoc} */ public int getExtraDialogHeight() { return UIFactory.EXTRA_DIALOG_HEIGHT; } /** * {@inheritDoc} */ protected String getInstallationPath() { // The upgrader runs from the bits extracted by BuildExtractor // in the staging directory. So 'stagePath' below will point // to the staging directory [installroot]/tmp/upgrade. However // we still want the Installation to point at the build being // upgraded so the install path reported in [installroot]. String installationPath = null; String path = Utils.getInstallPathFromClasspath(); if (path != null) { File f = new File(path); if (f.getParentFile() != null && f.getParentFile().getParentFile() != null && new File(f.getParentFile().getParentFile(), Installation.LOCKS_PATH_RELATIVE).exists()) { installationPath = Utils.getPath(f.getParentFile().getParentFile()); } else { installationPath = path; } } return installationPath; } /** * {@inheritDoc} */ public ProgressStep getCurrentProgressStep() { return currentProgressStep; } /** * {@inheritDoc} */ public Integer getRatio(ProgressStep step) { return 100 * ((UpgradeProgressStep) step).ordinal() / EnumSet.allOf(UpgradeWizardStep.class).size(); } /** * {@inheritDoc} */ public String getSummary(ProgressStep step) { String txt = null; if (step == UpgradeProgressStep.FINISHED) { // String installPath = Utils.getPath(getInstallation().getRootDirectory()); // String newVersion = null; // try { // newVersion = getInstallation().getBuildId(); // } catch (QuickSetupException e) { // newVersion = getMsg("upgrade-build-id-unknown"); // } // String[] args = { // formatter.getFormattedText(installPath), // newVersion }; // txt = getFormattedSuccess( // getMsg("summary-upgrade-finished-successfully", // args)); txt = "Upgrade completed successfully"; // TODO BETTER MESSAGE } else if (step == UpgradeProgressStep.FINISHED_WITH_ERRORS) { txt = getFormattedError( getMsg("summary-upgrade-finished-with-errors")); } else { txt = getMsg(((UpgradeProgressStep) step).getSummaryMesssageKey()); } return txt; } /** * {@inheritDoc} */ public void windowClosing(QuickSetupDialog dlg, WindowEvent evt) { // TODO } /** * {@inheritDoc} */ public ButtonName getInitialFocusButtonName() { // TODO return null; } /** * {@inheritDoc} */ public Set getWizardSteps() { return Collections.unmodifiableSet(EnumSet.allOf(UpgradeWizardStep.class)); } /** * {@inheritDoc} */ public QuickSetupStepPanel createWizardStepPanel(WizardStep step) { QuickSetupStepPanel pnl = null; if (UpgradeWizardStep.WELCOME.equals(step)) { pnl = new WelcomePanel(this); } else if (UpgradeWizardStep.CHOOSE_VERSION.equals(step)) { pnl = new ChooseVersionPanel(this); } else if (UpgradeWizardStep.REVIEW.equals(step)) { pnl = new UpgraderReviewPanel(this); } else if (UpgradeWizardStep.PROGRESS.equals(step)) { pnl = new ProgressPanel(this); } return pnl; } /** * {@inheritDoc} */ public WizardStep getNextWizardStep(WizardStep step) { WizardStep next = null; if (UpgradeWizardStep.WELCOME.equals(step)) { next = UpgradeWizardStep.CHOOSE_VERSION; } else if (UpgradeWizardStep.CHOOSE_VERSION.equals(step)) { next = UpgradeWizardStep.REVIEW; } else if (UpgradeWizardStep.REVIEW.equals(step)) { next = UpgradeWizardStep.PROGRESS; } return next; } /** * {@inheritDoc} */ public WizardStep getPreviousWizardStep(WizardStep step) { WizardStep prev = null; if (UpgradeWizardStep.PROGRESS.equals(step)) { prev = UpgradeWizardStep.REVIEW; } else if (UpgradeWizardStep.REVIEW.equals(step)) { prev = UpgradeWizardStep.CHOOSE_VERSION; } else if (UpgradeWizardStep.CHOOSE_VERSION.equals(step)) { prev = UpgradeWizardStep.WELCOME; } return prev; } /** * {@inheritDoc} */ public boolean canCancel(WizardStep step) { return UpgradeWizardStep.WELCOME == step || UpgradeWizardStep.CHOOSE_VERSION == step || UpgradeWizardStep.REVIEW == step; } /** * {@inheritDoc} */ public void quitClicked(WizardStep step, QuickSetup qs) { } /** * {@inheritDoc} */ public void updateUserData(WizardStep cStep, QuickSetup qs) throws UserDataException { List errorMsgs = new ArrayList(); UpgradeUserData uud = getUpgradeUserData(); if (cStep == UpgradeWizardStep.WELCOME) { // User can only select the installation to upgrade // in the webstart version of this tool. Otherwise // the fields are readonly. if (Utils.isWebStart()) { String serverLocationString = qs.getFieldStringValue(FieldName.SERVER_LOCATION); if ((serverLocationString == null) || ("".equals(serverLocationString.trim()))) { errorMsgs.add(getMsg("empty-server-location")); qs.displayFieldInvalid(FieldName.SERVER_LOCATION, true); } else { try { File serverLocation = new File(serverLocationString); Installation.validateRootDirectory(serverLocation); // If we get here the value is acceptable final Installation installation = new Installation(serverLocation); setInstallation(installation); // The build ID is needed on the review panel and it is // fairly time consuming to get. So prime this cached // value in a separate thread. new Thread(new Runnable() { public void run() { try { installation.getBuildId(); } catch (QuickSetupException e) { LOG.log(Level.INFO, "error", e); } } }).start(); uud.setServerLocation(serverLocationString); } catch (IllegalArgumentException iae) { errorMsgs.add(getMsg("error-invalid-server-location", iae.getLocalizedMessage())); qs.displayFieldInvalid(FieldName.SERVER_LOCATION, true); } } } else { // do nothing; all fields are read-only } } else if (cStep == UpgradeWizardStep.CHOOSE_VERSION) { Build buildToDownload = null; File buildFile = null; Boolean downloadFirst = (Boolean)qs.getFieldValue(FieldName.UPGRADE_DOWNLOAD); if (downloadFirst) { buildToDownload = (Build)qs.getFieldValue(FieldName.UPGRADE_BUILD_TO_DOWNLOAD); } else { buildFile = (File)qs.getFieldValue(FieldName.UPGRADE_FILE); if (buildFile == null) { errorMsgs.add("You must specify a path to an OpenDS build file"); } else if (!buildFile.exists()) { errorMsgs.add("File " + Utils.getPath(buildFile) + " does not exist."); qs.displayFieldInvalid(FieldName.UPGRADE_FILE, true); } } uud.setBuildToDownload(buildToDownload); uud.setInstallPackage(buildFile); } if (errorMsgs.size() > 0) { throw new UserDataException(Step.SERVER_SETTINGS, Utils.getStringFromCollection(errorMsgs, "\n")); } } /** * {@inheritDoc} */ public void previousClicked(WizardStep cStep, QuickSetup qs) { } /** * {@inheritDoc} */ public void finishClicked(final WizardStep cStep, final QuickSetup qs) { qs.launch(); qs.setCurrentStep(UpgradeWizardStep.PROGRESS); } /** * {@inheritDoc} */ public void nextClicked(WizardStep cStep, QuickSetup qs) { } /** * {@inheritDoc} */ public void closeClicked(WizardStep cStep, QuickSetup qs) { // TODO: prompt qs.quit(); } /** * {@inheritDoc} */ public void cancelClicked(WizardStep cStep, QuickSetup qs) { // TODO: confirm cancel System.exit(1); } /** * {@inheritDoc} */ public boolean canFinish(WizardStep step) { boolean cf = UpgradeWizardStep.REVIEW.equals(step); return cf; } /** * {@inheritDoc} */ public boolean canGoBack(WizardStep step) { return super.canGoBack(step) && !step.equals(UpgradeWizardStep.PROGRESS); } /** * {@inheritDoc} */ public boolean canClose(WizardStep step) { return step.equals(UpgradeWizardStep.PROGRESS); } /** * {@inheritDoc} */ public void run() { // Reset exception just in case this application is rerun // for some reason runException = null; try { if (Utils.isWebStart()) { try { waitForLoader(15); // TODO: ratio } catch (QuickSetupException e) { LOG.log(Level.SEVERE, "Error downloading WebStart jars", e); throw e; } } File buildZip; Build buildToDownload = getUpgradeUserData().getInstallPackageToDownload(); if (buildToDownload != null) { try { setCurrentProgressStep(UpgradeProgressStep.DOWNLOADING); buildZip = new File(getStageDirectory(), "OpenDS.zip"); if (buildZip.exists()) { if (!buildZip.delete()) { throw ApplicationException.createFileSystemException( "Could not delete existing build file " + Utils.getPath(buildZip), null); } } getRemoteBuildManager().download(buildToDownload, buildZip); notifyListeners(formatter.getFormattedDone()); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error downloading build file", e); throw e; } } else { buildZip = getUpgradeUserData().getInstallPackage(); } if (buildZip != null) { try { setCurrentProgressStep(UpgradeProgressStep.EXTRACTING); ZipExtractor extractor = new ZipExtractor(buildZip, 1, 10, // TODO figure out these values Utils.getNumberZipEntries(), this); extractor.extract(getStageDirectory()); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error extracting build file", e); throw e; } } try { setCurrentProgressStep(UpgradeProgressStep.INITIALIZING); initialize(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error initializing upgrader", e); throw e; } try { setCurrentProgressStep(UpgradeProgressStep.INITIALIZING); initialize(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error initializing upgrader", e); throw e; } if (!getInstallation().getStatus().isServerRunning()) { try { setCurrentProgressStep(UpgradeProgressStep.STARTING_SERVER); startServerWithoutConnectionHandlers(); getServerController().stopServerInProcess(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error starting server to insure configuration" + " changes have been written to the filesystem", e); throw e; } } if (getInstallation().getStatus().isServerRunning()) { try { setCurrentProgressStep(UpgradeProgressStep.STOPPING_SERVER); new ServerController(this).stopServer(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error stopping server", e); throw e; } } try { setCurrentProgressStep( UpgradeProgressStep.CALCULATING_SCHEMA_CUSTOMIZATIONS); calculateSchemaCustomizations(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error calculating schema customizations", e); throw e; } try { setCurrentProgressStep( UpgradeProgressStep.CALCULATING_CONFIGURATION_CUSTOMIZATIONS); calculateConfigCustomizations(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error calculating config customizations", e); throw e; } try { setCurrentProgressStep(UpgradeProgressStep.BACKING_UP_DATABASES); backupDatabases(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error backing up databases", e); throw e; } try { setCurrentProgressStep(UpgradeProgressStep.BACKING_UP_FILESYSTEM); backupFilesytem(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error backing up files", e); throw e; } try { setCurrentProgressStep( UpgradeProgressStep.UPGRADING_COMPONENTS); upgradeComponents(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error upgrading components", e); throw e; } try { setCurrentProgressStep( UpgradeProgressStep.APPLYING_SCHEMA_CUSTOMIZATIONS); applySchemaCustomizations(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error applying schema customizations", e); throw e; } try { setCurrentProgressStep( UpgradeProgressStep.APPLYING_CONFIGURATION_CUSTOMIZATIONS); applyConfigurationCustomizations(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error applying configuration customizations", e); throw e; } // This allows you to test whether or not he upgrader can successfully // abort an upgrade once changes have been made to the installation // path's filesystem. if ("true".equals( System.getProperty( "org.opends.upgrader.Upgrader.CreateError.CreateError"))) { throw new ApplicationException( null, "ARTIFICIAL ERROR FOR TESTING ABORT PROCESS", null); } try { setCurrentProgressStep(UpgradeProgressStep.VERIFYING); verifyUpgrade(); } catch (ApplicationException e) { LOG.log(Level.INFO, "Error verifying upgrade", e); throw e; } } catch (ApplicationException ae) { this.runException = ae; } catch (Throwable t) { this.runException = new ApplicationException(ApplicationException.Type.BUG, "Unexpected error: " + t.getLocalizedMessage(), t); } finally { try { HistoricalRecord.Status status; String note = null; if (runException == null) { status = HistoricalRecord.Status.SUCCESS; } else { status = HistoricalRecord.Status.FAILURE; note = runException.getLocalizedMessage(); // Abort the upgrade and put things back like we found it ProgressStep lastProgressStep = getCurrentProgressStep(); setCurrentProgressStep(UpgradeProgressStep.ABORT); abort(lastProgressStep); } setCurrentProgressStep(UpgradeProgressStep.CLEANUP); cleanup(); // Write a record in the log file indicating success/failure setCurrentProgressStep(UpgradeProgressStep.RECORDING_HISTORY); notifyListeners("See '" + Utils.getPath(getInstallation().getHistoryLogFile()) + "'" + formatter.getLineBreak()); writeHistoricalRecord(historicalOperationId, getCurrentVersion(), getStagedVersion(), status, note); } catch (ApplicationException e) { System.err.print("Error cleaning up after upgrade: " + e.getLocalizedMessage()); } } // Decide final status based on presense of error if (runException == null) { setCurrentProgressStep(UpgradeProgressStep.FINISHED); } else { setCurrentProgressStep(UpgradeProgressStep.FINISHED_WITH_ERRORS); notifyListeners(formatter.getFormattedError(runException, true)); } } /** * Abort this upgrade and repair the installation. * * @param lastStep ProgressStep indicating how much work we will have to * do to get the installation back like we left it * @throws ApplicationException of something goes wrong */ private void abort(ProgressStep lastStep) throws ApplicationException { UpgradeProgressStep lastUpgradeStep = (UpgradeProgressStep) lastStep; EnumSet stepsStarted = EnumSet.range(UpgradeProgressStep.NOT_STARTED, lastUpgradeStep); if (stepsStarted.contains(UpgradeProgressStep.BACKING_UP_FILESYSTEM)) { // Files were copied from the stage directory to the current // directory. Repair things by overwriting file in the // root with those that were copied to the backup directory // during backupFiles() File root = getInstallation().getRootDirectory(); File backupDirectory; try { backupDirectory = getFilesBackupDirectory(); FileManager fm = new FileManager(this); for (String fileName : backupDirectory.list()) { File f = new File(backupDirectory, fileName); // Do our best to restore the filesystem like // we found it. Just report potential problems // to the user. try { fm.move(f, root, null); } catch (Throwable t) { notifyListeners("The following could not be restored after the" + "failed upgrade attempt. You should restore this " + "file/directory manually: '" + f + "' to '" + root + "'"); } } fm.deleteRecursively(backupDirectory); } catch (IOException e) { LOG.log(Level.INFO, "Error getting backup directory", e); } } } private void verifyUpgrade() throws ApplicationException { try { new ServerController(this).startServer(); } catch (QuickSetupException e) { LOG.log(Level.INFO, "Error starting server: " + e.getLocalizedMessage(), e); } } private void applyConfigurationCustomizations() throws ApplicationException { try { File configDiff = getCustomConfigDiffFile(); if (configDiff.exists()) { applyCustomizationLdifFile(configDiff); } } catch (IOException e) { String msg = "IO Error applying configuration customization: " + e.getLocalizedMessage(); LOG.log(Level.INFO, msg, e); throw new ApplicationException(ApplicationException.Type.IMPORT_ERROR, msg, e); } catch (org.opends.server.util.LDIFException e) { String msg = "LDIF error applying configuration customization: " + e.getLocalizedMessage(); LOG.log(Level.INFO, msg, e); throw new ApplicationException(ApplicationException.Type.IMPORT_ERROR, msg, e); } } private void applySchemaCustomizations() throws ApplicationException { try { File schemaDiff = getCustomSchemaDiffFile(); if (schemaDiff.exists()) { applyCustomizationLdifFile(schemaDiff); } } catch (IOException e) { String msg = "IO Error applying schema customization: " + e.getLocalizedMessage(); LOG.log(Level.INFO, msg, e); throw new ApplicationException(ApplicationException.Type.IMPORT_ERROR, msg, e); } catch (org.opends.server.util.LDIFException e) { String msg = "LDIF error applying schema customization: " + e.getLocalizedMessage(); LOG.log(Level.INFO, msg, e); throw new ApplicationException(ApplicationException.Type.IMPORT_ERROR, msg, e); } } private void startServerWithoutConnectionHandlers() throws ApplicationException { try { ServerController control = new ServerController(this); if (getInstallation().getStatus().isServerRunning()) { control.stopServer(); } control.startServerInProcess(true); } catch (IOException e) { String msg = "Failed to determine server state: " + e.getLocalizedMessage(); LOG.log(Level.INFO, msg, e); throw new ApplicationException(ApplicationException.Type.IMPORT_ERROR, msg, e); } catch (org.opends.server.types.InitializationException e) { String msg = "Failed to start server due to initialization error:" + e.getLocalizedMessage(); LOG.log(Level.INFO, msg, e); throw new ApplicationException(ApplicationException.Type.IMPORT_ERROR, msg, e); } catch (org.opends.server.config.ConfigException e) { String msg = "Failed to start server due to configuration error: " + e.getLocalizedMessage(); LOG.log(Level.INFO, msg, e); throw new ApplicationException(ApplicationException.Type.IMPORT_ERROR, msg, e); } } private void applyCustomizationLdifFile(File ldifFile) throws IOException, org.opends.server.util.LDIFException, ApplicationException { try { startServerWithoutConnectionHandlers(); org.opends.server.protocols.internal.InternalClientConnection cc = org.opends.server.protocols.internal. InternalClientConnection.getRootConnection(); org.opends.server.types.LDIFImportConfig importCfg = new org.opends.server.types.LDIFImportConfig( Utils.getPath(ldifFile)); org.opends.server.util.LDIFReader ldifReader = new org.opends.server.util.LDIFReader(importCfg); org.opends.server.util.ChangeRecordEntry cre; while (null != (cre = ldifReader.readChangeRecord(false))) { if (cre instanceof org.opends.server.util.ModifyChangeRecordEntry) { org.opends.server.util.ModifyChangeRecordEntry mcre = (org.opends.server.util.ModifyChangeRecordEntry) cre; org.opends.server.types.ByteString dnByteString = org.opends.server.types.ByteStringFactory.create( mcre.getDN().toString()); org.opends.server.core.ModifyOperation op = cc.processModify(dnByteString, mcre.getModifications()); org.opends.server.types.ResultCode rc = op.getResultCode(); if (rc.equals( org.opends.server.types.ResultCode. OBJECTCLASS_VIOLATION)) { // try again without schema checking org.opends.server.core.DirectoryServer.setCheckSchema(false); op = cc.processModify(dnByteString, mcre.getModifications()); rc = op.getResultCode(); } if (rc.equals(org.opends.server.types.ResultCode. SUCCESS)) { if (org.opends.server.core.DirectoryServer.checkSchema()) { notifyListeners( getMsg("upgrade-mod", modListToString(op.getModifications())) + formatter.getLineBreak()); } else { notifyListeners( getMsg("upgrade-mod-no-schema", modListToString(op.getModifications())) + formatter.getLineBreak()); org.opends.server.core.DirectoryServer.setCheckSchema(true); } } else if (rc.equals( org.opends.server.types.ResultCode. ATTRIBUTE_OR_VALUE_EXISTS)) { // ignore this error notifyListeners( getMsg("upgrade-mod-ignore", modListToString(op.getModifications())) + formatter.getLineBreak()); } else { // report the error to the user StringBuilder error = op.getErrorMessage(); if (error != null) { throw new ApplicationException( ApplicationException.Type.IMPORT_ERROR, "error processing custom configuration " + error.toString(), null); } } } else { throw new ApplicationException( ApplicationException.Type.IMPORT_ERROR, "unexpected change record type " + cre.getClass(), null); } } } catch (Throwable t) { throw new ApplicationException(ApplicationException.Type.BUG, t.getMessage(), t); } finally { getServerController().stopServerInProcess(); } } private String modListToString( List modifications) { StringBuilder modsMsg = new StringBuilder(); for(int i = 0; i < modifications.size(); i++) { modsMsg.append(modifications.get(i).toString()); if (i < modifications.size() - 1) { modsMsg.append(" "); } } return modsMsg.toString(); } private Long writeInitialHistoricalRecord( Integer fromVersion, Integer toVersion) throws ApplicationException { Long id; try { HistoricalLog log = new HistoricalLog(getInstallation().getHistoryLogFile()); id = log.append(fromVersion, toVersion, HistoricalRecord.Status.STARTED, null); } catch (IOException e) { String msg = "IO Error logging operation: " + e.getLocalizedMessage(); throw ApplicationException.createFileSystemException( msg, e); } return id; } private void writeHistoricalRecord( Long id, Integer from, Integer to, HistoricalRecord.Status status, String note) throws ApplicationException { try { HistoricalLog log = new HistoricalLog(getInstallation().getHistoryLogFile()); log.append(id, from, to, status, note); } catch (IOException e) { String msg = "Error logging operation: " + e.getLocalizedMessage(); throw ApplicationException.createFileSystemException(msg, e); } } private void upgradeComponents() throws ApplicationException { try { File stageDir = getStageDirectory(); File root = getInstallation().getRootDirectory(); FileManager fm = new FileManager(this); for (String fileName : stageDir.list()) { File f = new File(stageDir, fileName); fm.copyRecursively(f, root, new UpgradeFileFilter(stageDir), /*overwrite=*/true); } } catch (IOException e) { throw ApplicationException.createFileSystemException( "I/0 error upgrading components: " + e.getLocalizedMessage(), e); } } private void calculateConfigCustomizations() throws ApplicationException { try { if (getInstallation().getCurrentConfiguration().hasBeenModified()) { try { ldifDiff(getInstallation().getBaseConfigurationFile(), getInstallation().getCurrentConfigurationFile(), getCustomConfigDiffFile()); } catch (Exception e) { throw ApplicationException.createFileSystemException( "Error determining configuration customizations: " + e.getLocalizedMessage(), e); } } else { // TODO i18n notifyListeners("No configuration customizations to migrate" + formatter.getLineBreak()); } } catch (IOException e) { // TODO i18n throw ApplicationException.createFileSystemException( "Could not determine configuration modifications: " + e.getLocalizedMessage(), e); } } private void ldifDiff(File source, File target, File output) throws ApplicationException { List args = new ArrayList(); args.add("-s"); // source LDIF args.add(Utils.getPath(source)); args.add("-t"); // target LDIF args.add(Utils.getPath(target)); args.add("-o"); // output LDIF args.add(Utils.getPath(output)); args.add("-O"); // overwrite args.add("-S"); // single-value changes // TODO i18n notifyListeners(formatter.getFormattedWithPoints("Diff'ing " + Utils.getPath(source) + " with " + Utils.getPath(target))); int ret = org.opends.server.tools.LDIFDiff.mainDiff( args.toArray(new String[]{}), false); if (ret != 0) { StringBuffer sb = new StringBuffer() .append("'ldif-diff' tool returned error code ") .append(ret) .append(" when invoked with args: ") .append(Utils.listToString(args, " ")); notifyListeners(formatter.getLineBreak()); throw ApplicationException.createFileSystemException(sb.toString(), null); } else { notifyListeners(formatter.getFormattedDone() + formatter.getLineBreak()); } } private void calculateSchemaCustomizations() throws ApplicationException { if (getInstallation().getStatus().schemaHasBeenModified()) { // TODO i18n notifyListeners( "Schema contains customizations and needs to be migrated" + formatter.getLineBreak()); try { ldifDiff(getInstallation().getBaseSchemaFile(), getInstallation().getSchemaConcatFile(), getCustomSchemaDiffFile()); } catch (Exception e) { throw ApplicationException.createFileSystemException( "Error determining schema customizations: " + e.getLocalizedMessage(), e); } } else { // TODO i18n notifyListeners("No schema customizations to migrate" + formatter.getLineBreak()); } } private void backupFilesytem() throws ApplicationException { try { File filesBackupDirectory = getFilesBackupDirectory(); FileManager fm = new FileManager(this); File root = getInstallation().getRootDirectory(); FileFilter filter = new UpgradeFileFilter(root); for (String fileName : root.list()) { File f = new File(root, fileName); //fm.copyRecursively(f, filesBackupDirectory, fm.move(f, filesBackupDirectory, filter); } } catch (Exception e) { throw new ApplicationException( ApplicationException.Type.FILE_SYSTEM_ERROR, e.getLocalizedMessage(), e); } } private void backupDatabases() throws ApplicationException { List args = new ArrayList(); args.add("--configClass"); args.add("org.opends.server.extensions.ConfigFileHandler"); args.add("--configFile"); args.add(getInstallation().getCurrentConfigurationFile().getPath()); args.add("-a"); // backup all args.add("-d"); // backup to directory try { args.add(getUpgradeBackupDirectory().getCanonicalPath()); } catch (IOException e) { // TODO i18n throw new ApplicationException( ApplicationException.Type.FILE_SYSTEM_ERROR, "error backup up databases", e); } int ret = org.opends.server.tools.BackUpDB.mainBackUpDB( args.toArray(new String[0])); if (ret != 0) { StringBuffer sb = new StringBuffer() .append("'backup utility returned error code ") .append(ret) .append(" when invoked with args: ") .append(Utils.listToString(args, " ")); throw new ApplicationException( ApplicationException.Type.FILE_SYSTEM_ERROR, sb.toString(), null); } } private void cleanup() throws ApplicationException { deleteStagingDirectory(); } private void deleteStagingDirectory() throws ApplicationException { File stagingDir = null; try { stagingDir = getStageDirectory(); FileManager fm = new FileManager(this); // Doing this seems to work better than just plain // old delete. Note that on Windows there are file // locking issues to we mark files for deletion after // this JVM exits if (stagingDir.exists()) { fm.deleteRecursively(stagingDir, null, /*onExit=*/true); } } catch (IOException e) { // TODO i18n throw ApplicationException.createFileSystemException( "Error attempting to clean up tmp directory " + stagingDir != null ? stagingDir.getName() : "null" + ": " + e.getLocalizedMessage(), e); } } private void initialize() throws ApplicationException { try { Integer fromVersion = getCurrentVersion(); Integer toVersion = getStagedVersion(); this.historicalOperationId = writeInitialHistoricalRecord(fromVersion, toVersion); insureUpgradability(); } catch (Exception e) { throw new ApplicationException( ApplicationException.Type.FILE_SYSTEM_ERROR, e.getMessage(), e); } } /** * Given the current information, determines whether or not * an upgrade from the current version to the next version * is possible. Upgrading may not be possible due to 'flag * day' types of changes to the codebase. */ private void insureUpgradability() throws ApplicationException { Integer currentVersion; Integer newVersion; try { currentVersion = getInstallation().getSvnRev(); } catch (QuickSetupException e) { LOG.log(Level.INFO, "error", e); throw ApplicationException.createFileSystemException( "Could not determine current version number: " + e.getLocalizedMessage(), e); } try { newVersion = getStagedInstallation().getSvnRev(); } catch (Exception e) { LOG.log(Level.INFO, "error", e); throw ApplicationException.createFileSystemException( "Could not determine upgrade version number: " + e.getLocalizedMessage(), e); } UpgradeOracle uo = new UpgradeOracle(currentVersion, newVersion); if (!uo.isSupported()) { throw new ApplicationException(ApplicationException.Type.APPLICATION, uo.getSummaryMessage(), null); } } private Installation getStagedInstallation() throws IOException, ApplicationException { if (stagedInstallation == null) { File stageDir = getStageDirectory(); try { Installation.validateRootDirectory(stageDir); stagedInstallation = new Installation(getStageDirectory()); } catch (IllegalArgumentException e) { throw ApplicationException.createFileSystemException( "Directory '" + getStageDirectory() + "' does not contain a staged installation of OpenDS" + " as was expected. Verify that the new installation" + " package (.zip) is an OpenDS installation file", null); } } return stagedInstallation; } /** * {@inheritDoc} */ public UserData createUserData() { UpgradeUserData uud = new UpgradeUserData(); String instanceRootFromSystem = System.getProperty("org.opends.quicksetup.upgrader.Root"); if (instanceRootFromSystem != null) { uud.setServerLocation(instanceRootFromSystem); } return uud; } /** * {@inheritDoc} */ public UserData createUserData(String[] args, CurrentInstallStatus cis) throws UserDataException { return getCliHelper().createUserData(args, cis); } /** * {@inheritDoc} */ public ApplicationException getException() { return runException; } private void setCurrentProgressStep(UpgradeProgressStep step) { this.currentProgressStep = step; String msg = getMsg(step.getSummaryMesssageKey()); notifyListeners(getFormattedProgress(msg) + getLineBreak()); } private UpgraderCliHelper getCliHelper() { if (cliHelper == null) { cliHelper = new UpgraderCliHelper(); } return cliHelper; } private File getStageDirectory() throws ApplicationException, IOException { return getInstallation().getTemporaryUpgradeDirectory(); } private UpgradeUserData getUpgradeUserData() { return (UpgradeUserData) getUserData(); } private File getFilesBackupDirectory() throws IOException { File files = new File(getUpgradeBackupDirectory(), "files"); if (!files.exists()) { if (!files.mkdirs()) { throw new IOException("error creating files backup directory"); } } return files; } private File getUpgradeBackupDirectory() throws IOException { if (backupDirectory == null) { backupDirectory = getInstallation().createHistoryBackupDirectory(); } return backupDirectory; } private File getCustomConfigDiffFile() throws IOException { return new File(getUpgradeBackupDirectory(), "config.custom.diff"); } private File getCustomSchemaDiffFile() throws IOException { return new File(getUpgradeBackupDirectory(), "schema.custom.diff"); } private Integer getCurrentVersion() { if (this.currentVersion == null) { try { currentVersion = getInstallation().getSvnRev(); } catch (QuickSetupException e) { LOG.log(Level.INFO, "error trying to determine current version", e); } } return currentVersion; } private Integer getStagedVersion() { if (stagedVersion == null) { try { stagedVersion = getStagedInstallation().getSvnRev(); } catch (Exception e) { LOG.log(Level.INFO, "error", e); } } return stagedVersion; } /** * Filter defining files we want to manage in the upgrade * process. */ private class UpgradeFileFilter implements FileFilter { Set filesToIgnore; public UpgradeFileFilter(File root) throws IOException { this.filesToIgnore = new HashSet(); for (String rootFileNamesToIgnore : ROOT_FILES_TO_IGNORE_DURING_BACKUP) { filesToIgnore.add(new File(root, rootFileNamesToIgnore)); } // Definitely want to not back this up since it would create // infinite recursion. This may not be necessary if we are // ignoring the entire history directory but its added here for // safe measure. filesToIgnore.add(getUpgradeBackupDirectory()); } public boolean accept(File file) { boolean accept = true; for (File ignoreFile : filesToIgnore) { if (ignoreFile.equals(file) || Utils.isParentOf(ignoreFile, file)) { accept = false; break; } } return accept; } } }