Describes how to configure and access the Control System.
The Control System allows you to manage the cluster (including nodes, volumes, users, and alarms) through a comprehensive graphical user interface with all the functionality of the command-line or REST APIs.
In prior releases, the mapr-webserver package contained both the Control
System UI static files and the server running the Java application. Starting from v6.0, the
UI static files are in mapr-webserver. The mapr-apiserver
runs the server that sends the queries. The apiserver allows you to perform cluster
administration programmatically.
When you install mapr-webserver, the mapr-apiserver is
automatically installed because of the dependency on the mapr-apiserver to
perform the queries. If mapr-webserver is installed, you can use the
graphical user interface to manage your cluster. You can also install the
mapr-apiserver independently to run APIs or web clients that query or
programmatically access filesystem, HPE Ezmeral Data Fabric Database, and other components; however, without the webserver, the
Control System will not be available on this node to perform administrative tasks using the
UI.
To install the webserver and/or apiserver, see Installing Core and Ecosystem Components. If
you install using the Installer, by default, the installer
selects one instance of the mapr-webserver and
mapr-apiserver to install. You can specify additional webserver and/or
apiserver instances to install in the Configure Service Layout page. If you install
manually, run the appropriate command on the node to install the
mapr-webserver and/or mapr-apiserver packages. For more
information on the command to run, see Step 3: Install Cluster Service Packages.
For the purposes of high availability, the recommendation is to run at least 2 instances of the webserver and 2 instances of the apiserver.
During installation using the Installer, you can configure metrics and logging using settings on the Monitoring page of the Installer user interface. The metrics collection infrastructure must be installed because the Control System relies on these metrics to provide graphs and charts. If the metrics collection infrastructure is not installed, you cannot visualize the metrics in the panes on the Control System. If you did not install metrics collection or logging during your initial installation, you can add it later by selecting the feature during an Incremental Install.
The SameSite attribute of the Set-Cookie HTTP response header allows you to declare if your cookie should be restricted to a first-party or same-site context.
Edit the following section in the /opt/mapr/apiserver/conf/web.xml file to
set the SameSite cookie:
<session-config>
<cookie-config>
<http-only>true</http-only>
<max-age>86400</max-age>
<name>MAPR.APISERVER.JSESSIONID</name>
<secure>true</secure>
<comment>__SAME_SITE_LAX__</comment>
</cookie-config>
<session-timeout>30</session-timeout>
</session-config> Set it to one of the following values:
For more information, see SameSite cookies.
The Control System is web-based, and works with the following browsers:
Safari 10.x for v6.0
Secure Connection Failed
Error code: SEC_ERROR_REUSED_ISSUER_AND_SERIALTo use the Control System, navigate to the host that is running the WebServer in the cluster. Control System access to the cluster is typically using HTTP on port 8080 or using HTTPS on port 8443. You should disable pop-up blockers in your browser to allow HPE Ezmeral Data Fabric to open help links in new browser tabs.
The first time you open the Control System using HTTPS from a new browser, the browser alerts you that the security certificate is unrecognized. This is normal behavior for a new connection. Add an exception in your browser to allow the connection to continue.