Ops Director Troubleshooting
03 May 2022 05:11 PM
Note: The Ops Director feature has been deprecated as of September 30, 2020 and support ended on November 14, 2021.
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.
Check for App-Services
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:
Also note that Ops Director will install forests on all hosts in the cluster, regardless of group assignments.
Managing a Cluster
Check DNS Settings
When setting up a managed host, it's important to note that the hosts in both the Ops Director cluster, and the cluster being managed must be able to resolve hostnames via DNS. Modifying the /etc/hosts file is not sufficient.
Check Ops Director Scheduled Tasks
When setting up a managed host, you may encounter a XDMP-DEADLOCK error, or have an issue seeing the data for a managed cluster. If this occurs do the following:
Verify Necessary Ports are Open
Assuming the default installation ports are in use, verify the following access:
Upgrading Ops Director
When upgrading to a new version of Ops Director, it may 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 Un-managing 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.
Installing, Uninstalling, and Configuring Ops Director