Working with system administrators
On Settings, choose System Admin Users to work with System Administrator users, as shown in Figure 3‑3.
Figure 3‑3 Working with System Administrator users
Working with System Administrator users includes creating, deleting, and editing a System Administrator user. The following sections describe how to perform these tasks.
Creating a system administrator
A system administrator can create other System Administrator users.
How to create a system administrator
1 On Settings—System Admin Users, choose Add System Administrator to create a new System Administrator user, as shown in Figure 3‑3.
2 Specify the following properties on Add System Administrator, as shown in Figure 3‑4. A property name appearing with an asterisk (*) next to the name is a required property.
*Username
Type the name of the new system administrator.
*Email
Type the new administrator e-mail address.
*Description
Type a description for the new administrator.
*Language
Choose the language System Console uses.
*Is Locked Out
Type true or false.
*Password
In Password, type a password for the new user. The password must be at least eight characters long, and must contain at least one lower case letter, one upper case letter, and one digit. If you create a user using IDAPI, there is no restriction on what the password can be.
*Confirm Password
Type the password again.
Choose OK. Confirm that you want to save changes.
Figure 3‑4 Adding a system administrator
The new System Administrator user appears in the user list, as shown in Figure 3‑5.
Figure 3‑5 Viewing the new system administrator in the list
If you have e-mail notification enabled, BIRT iHub sends a notification e-mail to the new system administrator, as shown in Figure 3‑6. For information on enabling e-mail notification, see “Enabling e-mail notification” in Chapter 6, “Managing clusters.”
Figure 3‑6 Viewing the notification e-mail
Customizing the notification e-mail template file
The name of the e-mail template file that BIRT iHub uses to create the new system administrator notification e-mail is EmailFormat.properties. You can edit this file to customize it for your entity.
How to customize the system administrator notification e-mail template file
1 In a default BIRT iHub installation on Windows, performed using the graphical installer, in which the install folder is C:\Actuate, navigate to the following file:
C:\Actuate\BIRTiHubVisualization\modules\SystemConsole\tomcat\webapps\sysconsole\WEB-INF\lib\resource.jar
2 Using a file utility such as WinZip, open com\actuate\umc\data\resource\EmailFormat.properties and make any necessary modifications.
Save and exit the file.
Editing a system administrator
When editing a system administrator, the properties are the same as when creating a system administrator, and the administrator can change any property.
How to edit a system administrator
1 Left-click the arrowhead icon next to the System Administrator user in the list of users and choose Edit to edit a System Administrator, as shown in Figure 3‑7.
Figure 3‑7 Choosing to edit a system administrator
2 Make any necessary changes on Edit <System Administrator name> and choose Save.
Deleting system administrators
The system administrator can delete one System Administrator user only, or multiple users simultaneously.
How to delete a single administrator
Left-click the arrowhead icon next to the System Administrator user in the list of administrators and choose Delete to delete an administrator, as shown in Figure 3‑8.
Figure 3‑8 Deleting a system administrator
How to delete selected administrators
Check the boxes next to the administrators you want to delete. Then, left-click Actions and choose Delete Items, as shown in Figure 3‑9. Choose Refresh Items to deselect selected administrators.
Figure 3‑9 Deleting one or more users
How to delete all administrators except one
Do not delete all system administrators. Delete all but one system administrator by performing the following tasks:
1 Left-click the arrowhead icon in the check box next to Actions and choose Select All, to select all administrators, as shown in Figure 3‑10. Alternatively, choose Select None to deselect all administrators.
Figure 3‑10 Selecting all system administrators
2 Deselect any system administrator, for example, sysadmin.
3 Left-click Actions and choose Delete Items, as shown in Figure 3‑11. Alternatively, select Refresh Items to deselect administrators.
Figure 3‑11 Deleting all administrators except sysadmin