Ops Director Troubleshooting
19 November 2019 06:11 PM
Ops Director enables you to monitor MarkLogic clusters ranging from a single node to large multi-node deployments. A single Ops Director server can monitor multiple clusters. Ops Director provides a unified browser-based interface for easy access and navigation.
Ops Director presents a consolidated view of your MarkLogic infrastructure, to streamline monitoring and troubleshooting of clusters with alerting, performance, and log data. Ops Director provides enterprise-grade security of your cluster configuration and performance data with robust role-based access control and information security powered by MarkLogic Server.
Problems installing Ops Director 2.0.0, 2.0.1 & 2.0.1-1
To successfully install Ops Director, the value for mlhost in gradle.properties must have a hostname and that hostname must match the name of one of the hosts in the cluster. You can not use localhost to install Ops Director, nor can you use a host name other than one that is listed as a host in the cluster as this effects the use of certificates for authentication to the OpsDirectorSystem application server.
Ops Director can sometimes encounter errors when attempting to install in groups other than Default. To successfully install, the Ops Director installer needs to be able to connect to the App-Services application server on port 8000 in the group where Ops Director is being installed. There are two ways to work around this issue:
See the attached Workspace OpsDirCopyAppServers.xml which has scripts to do the following:
Should you wish to create the Ops Director servers manually, the following table lists the default configuration values for the two application servers:
Also note that Ops Director will install forests on all hosts in the cluster, regardless of group assignments.
Upgrading Ops Director
When upgrading to a new version of Ops Director, it is frequently necessary to uninstall the previous version. To do that, you must un-manage any clusters being managed by Ops Director, prior to uninstalling the application.
The first step in uninstalling Ops Director is to remove any clusters from being managed from Ops Director. This is done via the Admin UI on a host in the managed cluster, as detailed in the Ops Director Guide: Disconnecting a Managed Cluster from Ops Director
Uninstalling Ops Director 2.0.0 & 2.0.1
These versions of Ops Director use the ml-gradle plugin for deployment. To uninstall these versions, you will also use gradle, as detailed in the Ops Director Guide: Removing Ops Director 2.0.0 and 2.0.1
Uninstalling Ops Director 1.1 or Earlier
If you are using the 1.1 version that was installed via the Admin UI, then it can be uninstalled via the Admin UI as detailed in the Ops Director Guide: Removing Ops Director 1.1 or Earlier
Problems with Uninstalling Ops Director
Occasionally an Ops Director installation may partially fail, due to misconfiguration, or missing dependencies. Issues can also occur that prevent the standard removal methods from working correctly. In these cases, Ops Director can be removed manually using the attached QConsole Workspace, OpsDirRemove.xml. The instructions for running the scripts are contained in the first tab of the workspace.
Problems with Unmanaging Clusters
Occasionally, disconnecting a managed cluster from Ops Director may partially fail. If this occurs, you can use the attached QConsole Workspace, OpsDirUnmanage.xml. The instructions for running the scripts are contained in the first tab of the workspace.