Examples of com.sleepycat.je.EnvironmentFailureException

com.sleepycat.je.EnvironmentFailureException
Indicates that a failure has occurred that could impact the {@code Environment} as a whole. For failures that impact only the currentoperation and/or transaction, see {@link OperationFailureException}). For an overview of all exceptions thrown by JE, see {@link DatabaseException}.
Depending on the nature of the failure, this exception may indicate that {@link Environment#close} must be called. The application should catch{@code EnvironmentFailureException} and then call {@link Environment#isValid}. If {@code false} is returned, all {@code Environment}handles (instances) must be closed and re-opened in order to run recovery and continue operating. If {@code true} is returned, the {@code Environment} can continue operating without being closed and re-opened.Also note that {@link Environment#isValid} may be called at any time, notjust during exception handling.

The use of the {@link Environment#isValid} method allows JE to determinedynamically whether the failure requires recovery or not, and allows for this determination to change in future releases. Over time, internal improvements to error handling may allow more error conditions to be handled without invalidating the {@code Environment}.

(Although this exception class extends {@link RunRecoveryException}, it does not always indicate that recovery is necessary, as described above. {@code RunRecoveryException} has been deprecated and {@code EnvironmentFailureException} should be used instead.)
If an {@code EnvironmentFailureException} consistently occurs soon afteropening the Environment, this may indicate a persistent problem. It may indicate a system problem or a persistent storage problem. In this case, human intervention is normally required and restoring from a backup may be necessary.

Note that subclasses of {@code EnvironmentFailureException} indicate howto handle the exception in more specific ways.
- If {@code Thread.interrupt} is called for a thread performing JEoperations, a {@link ThreadInterruptedException} is thrown. Sinceinterrupting a thread is intentional, it does not indicate a persistent problem and human intervention is not normally required.
- If an {@code IOException} occurs while writing to the JE log, a{@link LogWriteException} is thrown. Although an {@code IOException} canoccur for different reasons, it is a hint that the disk may be full and applications may wish to attempt recovery after making more disk space available.
- For replicated environments, see the subclasses of {@code EnvironmentFailureException} in the {@link com.sleepycat.je.rep} package formore information. Such exceptions may require special handling.
If {@link Environment#close} is not called after an {@code EnvironmentFailureException} invalidates the {@code Environment}, all subsequent method calls for the {@code Environment} will throw the sameexception. This provides more than one opportunity to catch and handle the specific exception subclass that caused the failure.

            nodeState.setChangeListener(prevListener);
            LoggerUtils.severe
                (envLogger, this,
                 "State Change listener exception: " + e.getMessage());
            /* An application error. */
            throw new EnvironmentFailureException
                (this, EnvironmentFailureReason.LISTENER_EXCEPTION, e);
        }
    }

View Full Code Here

        if (syncupProgressListener == null) {
            return;
        }


        if (!(syncupProgressListener.progress(progress, n, total))) {
            throw new EnvironmentFailureException
              (this, EnvironmentFailureReason.PROGRESS_LISTENER_HALT,
              "ReplicatedEnvironmentConfig.syncupProgressListener: ");
        }
    }

View Full Code Here

         * Returns the highest level the feeder can support, or the version we
         * just sent, if it can support that version
         */
        Message message = defaultProtocol.read(namedChannel);
        if (message instanceof DuplicateNodeReject) {
            throw new EnvironmentFailureException
                (repNode.getRepImpl(),
                 EnvironmentFailureReason.HANDSHAKE_ERROR,
                 "A replica with the name: " +  replicaNameIdPair +
                 " is already active with the Feeder:" + feederNameIdPair);
        }


        FeederProtocolVersion feederVersion =
            ((FeederProtocolVersion) message);
        feederNameIdPair = feederVersion.getNameIdPair();
        Protocol configuredProtocol =
            Protocol.get(repNode, feederVersion.getVersion());
        LoggerUtils.fine(logger, repNode.getRepImpl(),
                         "Feeder id: " + feederVersion.getNameIdPair() +
                         "Response message: " + feederVersion.getVersion());
        namedChannel.setNameIdPair(feederNameIdPair);
        LoggerUtils.fine(logger, repNode.getRepImpl(),
                         "Channel Mapping: " + feederNameIdPair + " is at " +
                         namedChannel.getChannel());


        if (configuredProtocol == null) {
            throw new EnvironmentFailureException
                (repNode.getRepImpl(),
                 EnvironmentFailureReason.PROTOCOL_VERSION_MISMATCH,
                 "Incompatible protocol versions. " +
                 "Version: " + feederVersion.getVersion() +
                 " requested by the Feeder: " + feederNameIdPair +

View Full Code Here

                         * Flush to get all exception tracing out to the log.
                         */
                        logManager.flush();
                        fileManager.clear();
                    } catch (IOException e) {
                        throw new EnvironmentFailureException
                            (this, EnvironmentFailureReason.LOG_INTEGRITY,
                             e);
                    }
                }
            } else {

View Full Code Here

            Class<?> newClass = Class.forName(className);
            MBeanRegistrar mBeanReg = (MBeanRegistrar) newClass.newInstance();
            mBeanReg.doRegister(env);
            mBeanRegList.add(mBeanReg);
        } catch (Exception e) {
            throw new EnvironmentFailureException
                (DbInternal.getEnvironmentImpl(env),
                 EnvironmentFailureReason.MONITOR_REGISTRATION, e);
        }
    }

View Full Code Here

                                         LogEntryType.LOG_VERSION),
                       namedChannel);
        Message message = protocol.read(namedChannel);
        if (message instanceof JEVersionsReject) {
            /* The software version is not compatible with the Feeder. */
            throw new EnvironmentFailureException
                (repNode.getRepImpl(),
                 EnvironmentFailureReason.HANDSHAKE_ERROR,
                 " Feeder: " + feederNameIdPair + ". " +
                 ((JEVersionsReject) message).getErrorMessage());
        }

View Full Code Here


        message = protocol.read(namedChannel);


        if (message instanceof NodeGroupInfoReject) {
            NodeGroupInfoReject reject = (NodeGroupInfoReject) message;
            throw new EnvironmentFailureException
                (repImpl,
                 EnvironmentFailureReason.HANDSHAKE_ERROR,
                 " Feeder: " + feederNameIdPair + ". " +
                 reject.getErrorMessage());
        }


        if (!(message instanceof NodeGroupInfoOK)) {
            throw new EnvironmentFailureException
                (repImpl,
                 EnvironmentFailureReason.HANDSHAKE_ERROR,
                 " Feeder: " + feederNameIdPair + ". " +
                 "Protcol error. Unexpected response " + message);
        } else if (repNode.getGroup().hasUnknownUUID()) {

View Full Code Here

             "Round trip delay: " + clockDelay + " ms. " + "Clock delta: " +
             clockDelta + " ms. " + "Max permissible delta: " +
             maxClockDelta + " ms.");


        if (Math.abs(clockDelta) >= maxClockDelta) {
            throw new EnvironmentFailureException
                (repNode.getRepImpl(),
                 EnvironmentFailureReason.HANDSHAKE_ERROR,
                 "Clock delta: " + clockDelta + " ms. " +
                 "between Feeder: " + feederNameIdPair.getName() +
                 " and this Replica exceeds max permissible delta: " +

View Full Code Here

                currentChild = null;
            }
        }


        void fail(String errorMessage) {
            throw new EnvironmentFailureException
                (tracker.getEnvImpl(), 
                 EnvironmentFailureReason.LOG_INTEGRITY,
                 errorMessage + "\ntracker contents=" + tracker);
        }

View Full Code Here

        /*
         * Sanity check that the replication stream is in sequence. We want to
         * forestall any possible corruption from replaying invalid entries.
         */
        if (!wireRecord.getVLSN().follows(lastReplayedVLSN)) {
            throw new EnvironmentFailureException
                (repImpl,
                 EnvironmentFailureReason.UNEXPECTED_STATE,
                 "Rep stream not sequential. Current VLSN: " +
                 lastReplayedVLSN +
                 " next log entry VLSN: " + wireRecord.getVLSN());

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of com.sleepycat.je.EnvironmentFailureException

com.sleepycat.je.cleaner.Cleaner

com.sleepycat.je.cleaner.FileProcessor

com.sleepycat.je.cleaner.VerifyUtils

com.sleepycat.je.dbi.CursorImpl

com.sleepycat.je.dbi.DbTree

com.sleepycat.je.dbi.EnvironmentImpl

com.sleepycat.je.dbi.SortedLSNTreeWalker

com.sleepycat.je.dbi.StartupTracker

com.sleepycat.je.log.FileHeader

com.sleepycat.je.log.FileManager

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.