Skip to main content

Using Imply Manager

Imply Manager gives administrators a visual interface for deploying and managing Imply clusters. It is available in Imply Hybrid (formerly Imply Cloud) and licensed Imply Enterprise (formerly Imply Private) deployments.

Imply Manager is where you create and configure clusters and servers, apply version updates, and monitor your deployment. With Imply Hybrid Auth enabled, you can use Imply Manager to configure authentication and authorization policies and perform various user management tasks, such as adding users, defining groups, and assigning permissions.

The following sections provide more details on using Imply Manager. For advanced Imply Manager operation modes, such as using direct access Pivot and crossover Pivot, see Direct access Pivot and On-prem Cloud crossover respectively.

For information specifically on creating and administering Imply clusters, see Cluster management.

Cloud Manager API​

Imply Hybrid users can manage Imply clusters using the Cloud Manager API. The Cloud Manager API is a secure, public-facing API that enables integration of cluster management into infrastructure automation frameworks. Use the Cloud Manager API to automate the following:

  • Create a cluster
  • Scale clusters up and down
  • Terminate a cluster

To learn how to use the Cloud Manager API, see Manager API tutorial.

Access user settings​

The User management console is a web interface for setting up, monitoring, and managing user access to Imply Hybrid. It encapsulates access settings across the entire organization. It is also where you configure authentication policies and connect third-party identity providers.

To access the User management console from Imply Manager, click on the profile menu in the top right corner. Select User management from the list of menu options.

Update software versions​

Imply Manager makes it easier to update software across a cluster.

If the cluster is running in high availability mode, you can apply a rolling update. With a rolling update, servers are updated in an order that ensures they remain running to maintain service availability while undergoing the update. If you are using Imply Hybrid, additional options are available for rolling updates. For more information, see .Upgrading Hybrid.

Rolling updates are not supported for clusters with more than one Imply service (master, query, data) on a single node.

If your cluster is not highly available, changing to a different version of the product or service (that is, upgrading or downgrading) will interrupt service for your users for a few minutes. In Imply Hybrid, this service downtime may take 15 to 20 minutes.

To update software, follow these steps:

  1. Open the cluster overview page and click Setup. Notice the current version listed in the Imply version field.
  2. From the Imply version drop-down menu, choose the version you want to update to. Imply Manager gets and displays the version number of the latest releases automatically.
  3. Click Apply changes. If you are using Imply Hybrid, you can also choose to surge the number of nodes during the upgrade. For more information, see Upgrading hybrid.
  4. Confirm the settings and apply the update.

The update status appears in the cluster overview page. At any point you can cancel the update, which causes Imply Manager to revert the upgrade, including the servers for which the update is complete.

Add custom user files​

You can push custom user files to Imply cluster nodes by specifying them in the Setup / Advanced Config section of Imply Manager. These files can be written to the following locations:

  • User files (/opt/imply/user)
  • Druid's classpath
  • as a Hadoop dependency

Additionally, these files can be processed as follows:

  • None
  • Requires unpacking (extracts using tar -x)
  • Is executable (sets chmod +x)

There are two ways to make these files available to the manager:

  • Make them available via HTTP(S) and provide the URL
  • Make them available to the manager locally and reference them using the manager:/// scheme

To make the files available to the manager locally, they will need to be placed in:

  • the /mnt/var/user directory inside the manager container, for Imply Enterprise on Kubernetes
  • the /var/opt/imply/grove/user directory where the manager is running, for Imply Enterprise on Linux

Once the files are available in that directory, reference them using the manager:/// scheme. As an example:

  • File: /mnt/var/user/hdfs-site.xml -> Manager path: manager:///hdfs-site.xml

Logs​

You can use journalctl to view logs for Imply Manager services:

journalctl -u IMPLY_SERVICE

These are the Imply Manager services:

  • imply-grove-server
  • imply-manager-be
  • imply-manager-fe
  • imply-grove-agent
  • imply-runsvdir

Lookups​

The Lookups page lets you manage Druid lookups. For more information on lookups, see the Apache Druid documentation.

Preview features​

Preview features are used to try out early access or other limited access features. Do not use except in consultation with Imply support.