Edit groups.xml directly
In addition to configuring roles through the Group Manager, you can also configure roles by editing the groups.xml file directly.
About this task
Note: MadCap Software recommends that you avoid directly editing the
groups.xml file whenever possible. The Group
Manager window has built-in validation mechanisms to reduce errors
and is the preferred method for configuring groups.Open the Group Manager window.
Procedure
-
Click the TEXTML Administration shortcut on the toolbar
to open the TEXTML Administration perspective or take the following
actions:
- Select Window > Perspective > Open Perspective > Other
- Click TEXTML Administration.
- Click Open.
- In the TEXTML Administration view, double-click the server.
-
If your server is not in the view, add it by taking the following
actions:
-
To find the server name, click Window > Preferences and select IXIA CCMS.
In the TEXTML Server Connection section, the server name is the Hostname.
- Copy the Hostname and close the Preferences window.
- In the TEXTML Administration view, right-click and select Add Server.
-
In the Server field, enter the server
name.
The Port field fills automatically. If it does not and you need the port number, you can find it in the same place as the server name in the Preferences window.
- Click OK.
-
To find the server name, click Window > Preferences and select IXIA CCMS.
- When the Connect as dialog opens, type your username and password and click OK.
- Double-click the name of your Content Store to open a connection to it.
- Expand the Content Store's Repository node and browse to /system/conf to locate the groups.xml file.
- Right-click groups.xml and select Check Out.
-
Open the file in an XML editor.
Tip: If you are adding a new group, it saves time to copy an existing group and make changes to the copy rather than create a new group from scratch.
- Enter the name for the group.
-
If you are adding the API Users group, add the id as provided in the
file's comments.
The four groups listed in the file's comments are the only groups that require an id. If you are adding a custom group, you do not have to provide an id.
- Optional:
Add the
<locations>
element along with a list of location names to the group. For example:<groups> <group name="System Administrators"/> <group name="Guests"/> <group name="Everyone"/> <group name="Content Reviewers"> <locations> <location name="IXIASOFT Montreal"/> <location name="IXIASOFT Toronto"/> </locations> </group> </groups>
The above example indicates that all users in IXIASOFT Montreal and IXIASOFT Toronto are automatically members of the
Content Reviewers
group. Users' locations are configured in the User Manager or in users.xml. - When you are finished, right-click groups.xml and select Check In.
-
Inform users of the changes.
The changes are automatically applied once users close and then reopen their CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIA CCMS > Synchronize Configuration. Additionally, refresh IXIA CCMS Web so that users see the change reflected there.