| // | |
| // Licensed to the Apache Software Foundation (ASF) under one | |
| // or more contributor license agreements. See the NOTICE file | |
| // distributed with this work for additional information | |
| // regarding copyright ownership. The ASF licenses this file | |
| // to you under the Apache License, Version 2.0 (the | |
| // "License"); you may not use this file except in compliance | |
| // with the License. You may obtain a copy of the License at | |
| // | |
| // http://www.apache.org/licenses/LICENSE-2.0 | |
| // | |
| // Unless required by applicable law or agreed to in writing, | |
| // software distributed under the License is distributed on an | |
| // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | |
| // KIND, either express or implied. See the License for the | |
| // specific language governing permissions and limitations | |
| // under the License. | |
| // | |
| package org.apache.cloudstack.ha; | |
| import com.cloud.utils.fsm.StateMachine2; | |
| import com.cloud.utils.fsm.StateObject; | |
| import org.apache.cloudstack.api.InternalIdentity; | |
| import org.apache.cloudstack.utils.identity.ManagementServerNode; | |
| public interface HAConfig extends StateObject<HAConfig.HAState>, InternalIdentity { | |
| long getResourceId(); | |
| HAResource.ResourceType getResourceType(); | |
| boolean isEnabled(); | |
| HAState getState(); | |
| String getHaProvider(); | |
| Long getManagementServerId(); | |
| enum Event { | |
| Eligible, | |
| Ineligible, | |
| Disabled, | |
| Enabled, | |
| HealthCheckPassed, | |
| HealthCheckFailed, | |
| PerformActivityCheck, | |
| TooFewActivityCheckSamples, | |
| PeriodicRecheckResourceActivity, | |
| ActivityCheckFailureOverThresholdRatio, | |
| ActivityCheckFailureUnderThresholdRatio, | |
| PowerCycle, | |
| Recovered, | |
| RetryRecovery, | |
| RecoveryWaitPeriodTimeout, | |
| RecoveryOperationThresholdExceeded, | |
| RetryFencing, | |
| Fenced; | |
| public Long getServerId() { | |
| // TODO: change in future if we've better claim & ownership | |
| // Right now the first one to update the db wins | |
| // and mgmt server id would eventually become consistent | |
| return ManagementServerNode.getManagementServerId(); | |
| } | |
| } | |
| enum HAState { | |
| Disabled("HA Operations disabled"), | |
| Available("The resource is healthy"), | |
| Ineligible("The current state does not support HA/recovery"), | |
| Suspect("Most recent health check failed"), | |
| Degraded("The resource cannot be managed, but services end user requests"), | |
| Checking("The activity checks are currently being performed"), | |
| Recovering("The resource is undergoing recovery operation"), | |
| Recovered("The resource is recovered"), | |
| Fencing("The resource is undergoing fence operation"), | |
| Fenced("The resource is fenced"); | |
| String description; | |
| HAState(String description) { | |
| this.description = description; | |
| } | |
| public static StateMachine2<HAState, Event, HAConfig> getStateMachine() { | |
| return FSM; | |
| } | |
| public String getDescription() { | |
| return description; | |
| } | |
| private static final StateMachine2<HAState, Event, HAConfig> FSM = new StateMachine2<>(); | |
| static { | |
| FSM.addInitialTransition(Event.Disabled, Disabled); | |
| FSM.addInitialTransition(Event.Enabled, Available); | |
| FSM.addInitialTransition(Event.Ineligible, Ineligible); | |
| FSM.addTransition(Disabled, Event.Enabled, Available); | |
| FSM.addTransition(Ineligible, Event.Disabled, Disabled); | |
| FSM.addTransition(Ineligible, Event.Ineligible, Ineligible); | |
| FSM.addTransition(Ineligible, Event.Eligible, Available); | |
| FSM.addTransition(Available, Event.Disabled, Disabled); | |
| FSM.addTransition(Available, Event.Ineligible, Ineligible); | |
| FSM.addTransition(Available, Event.HealthCheckPassed, Available); | |
| FSM.addTransition(Available, Event.HealthCheckFailed, Suspect); | |
| FSM.addTransition(Suspect, Event.Disabled, Disabled); | |
| FSM.addTransition(Suspect, Event.Ineligible, Ineligible); | |
| FSM.addTransition(Suspect, Event.HealthCheckFailed, Suspect); | |
| FSM.addTransition(Suspect, Event.PerformActivityCheck, Checking); | |
| FSM.addTransition(Suspect, Event.HealthCheckPassed, Available); | |
| FSM.addTransition(Checking, Event.Disabled, Disabled); | |
| FSM.addTransition(Checking, Event.Ineligible, Ineligible); | |
| FSM.addTransition(Checking, Event.TooFewActivityCheckSamples, Suspect); | |
| FSM.addTransition(Checking, Event.ActivityCheckFailureUnderThresholdRatio, Degraded); | |
| FSM.addTransition(Checking, Event.ActivityCheckFailureOverThresholdRatio, Recovering); | |
| FSM.addTransition(Degraded, Event.Disabled, Disabled); | |
| FSM.addTransition(Degraded, Event.Ineligible, Ineligible); | |
| FSM.addTransition(Degraded, Event.HealthCheckFailed, Degraded); | |
| FSM.addTransition(Degraded, Event.HealthCheckPassed, Available); | |
| FSM.addTransition(Degraded, Event.PeriodicRecheckResourceActivity, Suspect); | |
| FSM.addTransition(Recovering, Event.Disabled, Disabled); | |
| FSM.addTransition(Recovering, Event.Ineligible, Ineligible); | |
| FSM.addTransition(Recovering, Event.RetryRecovery, Recovering); | |
| FSM.addTransition(Recovering, Event.Recovered, Recovered); | |
| FSM.addTransition(Recovering, Event.RecoveryOperationThresholdExceeded, Fencing); | |
| FSM.addTransition(Recovered, Event.Disabled, Disabled); | |
| FSM.addTransition(Recovered, Event.Ineligible, Ineligible); | |
| FSM.addTransition(Recovered, Event.RecoveryWaitPeriodTimeout, Available); | |
| FSM.addTransition(Fencing, Event.Disabled, Disabled); | |
| FSM.addTransition(Fencing, Event.Ineligible, Ineligible); | |
| FSM.addTransition(Fencing, Event.RetryFencing, Fencing); | |
| FSM.addTransition(Fencing, Event.Fenced, Fenced); | |
| FSM.addTransition(Fenced, Event.Disabled, Disabled); | |
| FSM.addTransition(Fenced, Event.HealthCheckPassed, Ineligible); | |
| FSM.addTransition(Fenced, Event.HealthCheckFailed, Fenced); | |
| } | |
| } | |
| } |