headctlΒΆ

NAME

headctl -- Manage head node network communication settings.

USAGE

headctl

[-h | --help] [--status] [--prefer-http] [--prefer-https] [--enable-https] [--disable-https] [--enable-xsendfile] [--disable-xsendfile]

DESCRIPTION

This is a low-level tool that directly manipulates configuration settings for head node network communication. When controlling HTTP/HTTPS settings, it modifies /opt/scyld/clusterware/conf/base.ini and two Apache configuration files in /etc/http/conf.d/: ssl.conf and clusterware.conf. When enabling XSendfile support, the tool may install necessary RPMs as well as update variables in the base.ini.

Since the earliest boot steps cannot use encrypted communications, DHCP and PXE booting are not affected by these settings. Communications starting with initramfs execution will use HTTP or HTTPS as instructed by this command.

The tool resides in /opt/scyld/clusterware/bin/headctl and must be executed by user root.

OPTIONAL ARGUMENTS

-h, --help

Print usage message and exit. Ignore trailing args, parse and ignore preceding args.

--status

Report the configuration of the ClusterWare service.

--prefer-http

Instruct compute nodes to use HTTP.

--prefer-https

Instruct compute nodes to use HTTPS where possible.

--enable-https

Proxy through /etc/http/conf.d/ssl.conf.

--disable-https

Do not proxy through /etc/http/conf.d/ssl.conf.

--minimal-ipv6

Confirm the radvd is running on our interfaces by optionally installing radvd, adding blocks to the radvd.conf, and restarting the service if necessary.

--enable-xsendfile

Use the Apache XSendfile header when clients download files.

--disable-xsendfile

Do not use the Apache XSendfile header.

EXAMPLES

RETURN VALUES

Upon successful completion, headctl returns 0. On failure, an error message is printed to stderr and headctl returns 1.