Skip to main content

Administrating MarkLogic Server

Creating a New Group

To create a new group, follow these steps:

  1. Log into the Admin Interface.

  2. Click the Groups icon on the left tree menu.

  3. Click the Create tab on the Group Summary page. The Create Group page appears.

  4. Go to the group name field and enter a shorthand name for the group. MarkLogic Server will use this name to refer to the group.

  5. You can set the cache sizing method to enable you to manually set the settings for your caches, or have MarkLogic automatically set the cache settings.

    • If you select automatic, MarkLogic automatically sizes the caches based on the available memory resources allocated at startup time.

    • If you select enode, MarkLogic also automatically sizes the caches, but the sizes are tuned for better memory utilization of an Evaluation Node.

    • If you select dnode, MarkLogic automatically sizes the caches as well, but the sizes are tuned for better memory utilization of a Data Node.

    The automatic, enode, and dnode methods are necessary when running MarkLogic in a container, but are also applicable when running MarkLogic in other environments. When the Cache Sizing method is set to automatic, enode, or dnode, all manual cache settings, such as List Cache Size, Compressed Tree Cache Size and so on, can be set in the group configuration, but are not used until the Cache Sizing method is set to manual.

    If you set the Cache Sizing method to manual, you can change cache size values, such as List Cache Size, Compressed Tree Cache Size, Expanded Tree Cache Size, and so on, or leave the defaults.

    Note

    Switching the Cache Sizing method from manual to automatic restarts MarkLogic Server. Switching from automatic to manual restarts MarkLogic Server if the current configuration does not match the saved configuration. Otherwise, MarkLogic Server does not restart.

  6. Notes on other fields:

    • system log level specifies the minimum log level messages sent to the operating system. Log levels are listed in decreasing level of log details. You may change the system log level or leave it at the default level.

    • file log level specifies the minimum log level messages sent to the log file. Log levels are listed in decreasing level of log details. You may change the file log level or leave it at the default level.

    • rotate log files specifies how often to start a new log file. You may change this field or use the default value provided.

    • keep log files specifies how many log files are kept. You may change this field or use the default value provided.

    • Set failover enable to true if you want to enable failover for the hosts in the group. To use failover, you must also enable failover for individual forests. If you set failover enable to false, failover is disabled for all the hosts in the group, regardless of their forest configurations.

    • The ssl enabled option and xdqp ssl ciphers field are to enable SSL for XDQP.

  7. Click ok.

Note

For information about auditing, including how to configure various audit events, see Auditing Events.

Adding a group is a “hot” administrative task; the changes are reflected immediately without a restart.

In this section: