Copyright © 2010 Caringo, Inc.
All rights reserved 62
To resolve a conflict in a mirrored configuration, skip this section and use Section D.2.2, “Renaming
a Domain in a Mirrored or DR Cluster” instead.
To rename a domain in the source cluster of a DR cluster, use the Admin Console as follows:
1. Start the Admin Console as discussed in Chapter 2, Introduction to the Admin Console.
2. On the first page, click Settings.
3. On the Cluster Settings page, click Edit next to the name of the domain to rename.
4. In the Add Cluster Tenant section, enter a new name in the Domain Name field.
5. Click Save.
6. If prompted, enter an administrator user name and password.
D.2.2. Renaming a Domain in a Mirrored or DR Cluster
To rename a domain in a mirrored or DR cluster, use an SCSP COPY command with the following
query arguments, and authenticate as a cluster administrator:
Query argument Meaning
admin Also referred to as administrative override, enables
you to ignore Allow headers and bypass the Castor-
Authorization header; requires your cluster
newname=new-domain-name New name for the domain. Make sure you use a name
that follows the rules discussed in Section 4.4, “Rules and
Recommendations for Managing Tenants”.
aliasuuid=domain-UUID The UUID of the domain to rename. You can find the
UUID using a HEAD on the domain in its source cluster,
as discussed in the example following the table.
To rename a domain in a mirrored or DR cluster:
1. HEAD the alias UUID of the domain to rename.
Use SCSP INFO command as follows:
You must authenticate as a cluster administrator (that is, a user in the CAStor administrator
The value of the Castor-System-Alias header is the domain's UUID.
You must also get the value of the Castor-Authorization header from the HEAD request
and pass it in using the new cluster name with the rename command as shown in the next step.
2. Rename the domain.
curl -X COPY -H "Castor-Authorization: renamed-value-from-HEAD" -
H "Cache-Control: no-cache-context" -H "lifepoint:  reps=16" -