Info | |
---|---|
title | GatewaySkip this section if your client applications are accessing your cluster via the Swarm Content Gateway. |
To add, edit, or delete a domain from the Swarm Admin Console:
Open the Swarm Admin Console, and click Settings.
In the Cluster Settings page,
...
verify the Cluster Domains box is empty if no domains are configured.
...
To add a domain, click Add Domain.
To edit a domain, click Edit next to its name.
To delete a domain, select the check box next to its name, click Delete, and click Submit.
...
Note
If you delete a domain that contains buckets without including the recursive query argument, the buckets and any objects they contain are not deleted, but they are inaccessible. To work around this issue, see Restoring Domains and Buckets.
Enter or edit the following information:
Option
Description
Domain Name field
Enter a fully qualified IANA-compliant name to identify this domain (for example, cluster.example.com). The domain name must be unique among all clusters you manage.
If you did not configure a domain name that matches your cluster's name, the cluster name displays in this field. Creating a domain with the same name as the cluster sets up a default cluster domain.
See the Naming Rules. To rename an existing domain, use the Swarm Admin Console.
Protection Setting Determines what users are authorized to POST to the domain (such as buckets and unnamed objects). Click one of the following: - All Users. No authentication required. Any user can create buckets or unnamed objects in the domain without authentication.
- Only users in this domain. Enables users in the user list associated with this domain to POST to the domain.
Only users in domain. Enables users in the user list associated with the specified domain to POST to this domain.
Domain Managers Manages user lists in the domain. For help creating user lists, contact your Support representative. To add a new administrator, click Add Domain Manager. To edit an existing manager, click Edit next to the administrator's manager.
Info title Important Domain manager names consist of ASCII characters only and cannot include a colon character ( : ). See the Naming Rules . Info title Tip If Custom Policy displays for Protection Setting, a domain administrator has manually altered the protection settings. Set the protection setting back to the default setting if attempting to troubleshoot an issue with users being able to access objects in a domain. If you are adding or editing a domain manager, enter or edit the following information:
User ID. Enter a name to identify the domain manager. Domain manager names consist of ASCII characters only and cannot include a colon character (:).
Password. Enter a password for the domain manager.
Click Submit.
If prompted, enter an administrative user name and password.
This is how a domain appears in the Cluster Settings page:
...
Note
The following error indicates that the previous domain name has not expired from the content cache: ERROR! realm name 'domain-name/_administrators' already exists.
This error is displayed if a cluster administrator renamed cluster.example.com to domain.example.com and attempted to create cluster.example.com before the name has expired from the content cache, . Wait several minutes and attempt again.