Edit users.xml directly
In addition to configuring users through the User Manager, you can also configure roles by editing the users.xml file directly.
About this task
Note: MadCap Software recommends that you avoid directly editing the
users.xml file whenever possible. The User
Manager window has built-in validation mechanisms to reduce errors
and is the preferred method for configuring groups.Open the User 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 users.xml file.
- Right-click users.xml and select Check Out.
-
Open the file in an XML editor.
Tip: If you are adding a new user, it saves time to copy an existing user and make changes to the copy rather than create a new user from scratch.
- Enter the appropriate personal information for the user.
- Optional:
Enter the user's location(s).
This information can be used to build location-based groups.
- Enter the domain and login for the user.
- Enter the e-mail address for the user.
- Add each role that the user should have.
-
Add each group that the user should be a member of.
To give a user access to the advanced features, make them a member of the Advanced Users group. What is considered an advanced feature is predetermined and is not configurable. See The Advanced Users group for details.
To make a user a System Administrator, make them a member of the System Administrator group. The rights that a System Administrator has are configurable in the accessrights.xml file.
- When you are finished, right-click users.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.