Issue
CloudBees CI operations center or controller will not start up, and the logs are displaying an error like:
com.cloudbees.jenkins.cjp.installmanager.EnvelopeException: Errors found at com.cloudbees.jenkins.cjp.installmanager.CJPPluginManager$1.createException(CJPPluginManager.java:75) at com.cloudbees.jenkins.cjp.installmanager.CJPPluginManager$1.createException(CJPPluginManager.java:72) at com.cloudbees.jenkins.plugins.updates.envelope.AbstractOutput.createException(AbstractOutput.java:36) at com.cloudbees.jenkins.plugins.updates.envelope.Validation$Error.get(Validation.java:273) at com.cloudbees.jenkins.cjp.installmanager.CJPPluginManager.loadPlugins(CJPPluginManager.java:236) at com.cloudbees.jenkins.cjp.installmanager.CJPPluginManager.loadBundledPlugins(CJPPluginManager.java:215) at hudson.PluginManager$1$1.run(PluginManager.java:383) at org.jvnet.hudson.reactor.TaskGraphBuilder$TaskImpl.run(TaskGraphBuilder.java:169) at org.jvnet.hudson.reactor.Reactor.runTask(Reactor.java:296) at jenkins.model.Jenkins$5.runTask(Jenkins.java:1083) at org.jvnet.hudson.reactor.Reactor$2.run(Reactor.java:214) at org.jvnet.hudson.reactor.Reactor$Node.run(Reactor.java:117) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) at java.lang.Thread.run(Thread.java:748) Caused: org.jvnet.hudson.reactor.ReactorException at org.jvnet.hudson.reactor.Reactor.execute(Reactor.java:282) at jenkins.InitReactorRunner.run(InitReactorRunner.java:48) at jenkins.model.Jenkins.executeReactor(Jenkins.java:1117) at jenkins.model.Jenkins.<init>(Jenkins.java:921) at hudson.model.Hudson.<init>(Hudson.java:85) at hudson.model.Hudson.<init>(Hudson.java:81) at hudson.WebAppMain$3.run(WebAppMain.java:233) Caused: hudson.util.HudsonFailedToLoad at hudson.WebAppMain$3.run(WebAppMain.java:250)
Resolution
This error usually occurs when the $JENKINS_HOME/cb-envelope/envelope.json file is corrupt or empty. To fix this, simply delete the $JENKINS_HOME/cb-envelope/envelope.json and restart CloudBees CI. This should prompt CloudBees CI to recreate the file correctly on boot up and allow it to start successfully.
If after removing the file and restarting your instance is still encountering this EnvelopeException error on startup then it is highly likely you have a misconfigured plugin. Please check your jenkins.log for any plugin related errors on startup, or $JENKINS_HOME/plugins directory for any unexpected plugins, custom or 'SNAPSHOT' plugins that may be stored there causing this error.
Specifically, one error in your jenkins.log at startup that you may see indicating a misconfigured plugin that needed to be deleted/disabled would be as follows:
WARNING: Unable to list plugin <PLUGIN_JPI_PATH> java.io.IOException: Failed to expand <PLUGIN_JPI_PATH>
Any misconfigured or custom plugins should be disabled by adding touch ${PLUGIN_NAME}.jpi.disabled in this /plugins directory and then restart your instance once more.