This section describes how to create and maintain user accounts. These operations are managed from the User Administrator window. This section covers:
Creating and Editing Netcool Reporter Users
Roles
Selecting SQL Data Sources for a User
Importing Existing Users from a Database
The Users tab provides a graphical view of all Netcool Reporter users and allows you to create users, assign them to groups, and set up their data sources. It also allows you to edit or delete existing users.
|
|
Figure 339: User Administrator Window Users Tab |
If you use LDAP to maintain user information, you cannot create new users. For information on importing user, group and role information to Netcool Reporter, see the Netcool Reporter Administration Guide.
To create a new user, select the menu option UsersΖNew User... from the User Administrator window. The New User window is displayed with the Users Info tab selected, as shown below.
|
|
Figure 340: User Info Tab |
Enter the new user information in the User Info tab. The options are described in the following table.
|
Options |
Description |
|
User Name |
Type the name of a Netcool Reporter user. |
|
Password |
Type the password of the Netcool Reporter user. |
|
Confirm Password |
Re-enter the same password to confirm. |
|
Full Name |
Enter the full name of the Netcool Reporter user. |
|
Description |
Enter a description of the Netcool Reporter user account. |
|
Deselect this checkbox to activate a users account. (An account can become disabled if the user attempts to log onto the portal using the incorrect password too many times.) | |
|
User must change password at next logon |
(Optional) Select this checkbox if you want the user to be required to change his or her password the next time the user logs into the portal. |
|
(Optional) Enter an IP address if you want to require the user to log onto Netcool Reporter from only one network address, or one range of network addresses. (An asterisk * can be used in any of the four fields as a wildcard character.) Setting this field prevents the user from logging into Netcool Reporter from another users computer. Depending upon your network settings, it can also prevent the user from logging in from a remote location on a laptop. Note: Whether or not this field is enforced depends upon how the IP Address Settings are set in the System Settings window, as described in System Security Settings on page 529. |
Note:
If you are using LDAP to maintain user information, you can only change the Username and the Account Disabled fields.
To edit an existing user, select the menu option UsersΖEdit User... from the User Administrator window. The Edit User window appears with the Users Info tab selected. This window is identical to the New User window.
If you are editing an existing user, make appropriate changes and click OK.
If you have already created groups of Netcool Reporter users, you can assign your new user to groups. Parent groups allow you to create roles.
Note:
You cannot assign users to, or remove users from, groups if you are using LDAP to maintain user information.
Select the Parent Groups tab to display a list of all groups on the left and selected parent groups on the right, as shown below.
|
|
Figure 341: Parent Groups Tab |
Either double-click a group name on the left, or highlight it and click the Select button to add that group to the list of selected parent groups on the right.
To give a user administrator privileges in the group, including the ability to alter the group's default graphics settings, select the group in the Selected Parent Groups panel and click the Set Admin Attributes button.
A popup menu is displayed. The menu options are described in the following table.
|
Table 109: Selected Parent Groups Options |
|
Menu Option |
Description |
|
Set as Normal Default Group |
This option sets which layout the user sees when logging into Netcool Reporter. The letter D is displayed in the Attributes column, Note: A user can have only one default group. |
|
Set as Forced Default Group |
This option sets which layout the user sees when logging into Netcool Reporter. However a group with the setting Forced Default cannot be changed by the user. The letter F is displayed in the Attributes column. Note: A user can have only one forced default group. |
|
Set as Group Admin |
Makes the user the administrator for the group. Group administrators can set the Group Options settings for the group. A user can be an administrator for more than one group and a group can have more than one administrator. The letter F is displayed in the Attributes column and the Edit Group Administrator Privileges button is enabled for the group. |
If you have selected the Set as Group Admin option, you can click the Edit Group Administrator Privileges button to open the Edit Group Administrator Privileges window, as shown below.
|
|
Figure 342: Edit Group Administrator Privileges window |
In this window you can set or remove the following privileges for the group administrator:
· Add user to group
· Add subgroup to group
· Remove user from group
· Remove subgroup from group
All checkboxes are selected by default. Deselect the checkboxes as appropriate and click OK to close the window.
Netcool Reporter users are organized in a few different ways. There are three organization methods, as shown in the following table.
|
Division |
Description |
|
A group is a collection of users. Every user belongs to one or more groups. When you distribute reports and documents through Netcool Reporter, you can send them to entire groups instead of to specific users. Every member of the group receives the item, just as if it had been sent to the user directly. Only Netcool Reporter administrators may create groups and assign users to them. | |
|
Every user is assigned to one or more roles. Your role determines which Netcool Reporter applets you can use, and which functions are available to you. Your Netcool Reporter administrator can assign you to a role. | |
|
Channels are ways of distributing reports to users. Channels must be assigned to a page which is published to a user or a group. You can create channels directly through Netcool Reporter using the Manage Channels page. |
Not all users use Netcool Reporter in the same way. Some users only view data reports which have been assembled by others. Some create reports for themselves or for other people, and distribute them. Some create users and groups, and otherwise manage and administer the Netcool Reporter installation. To indicate what functions a user may perform, the user is assigned to a role.
Note:
You may not assign users to or remove users from roles if you are using LDAP to maintain user information.
Roles are assigned using the Role tab, as shown below.
|
|
Figure 343: Role Tab |
Table 111 lists the predefined roles, the predefined user that belongs to that role, and which applets are available.
|
Group |
Description |
Applets |
|
Standard_Users |
Corresponds to Standard role. Members can view static HTML reports and download files. The user reporter automatically belongs to this group. |
No applets |
|
Administrators |
Corresponds to Administrator role and the administrator user. The user administrator automatically belongs to this group. |
User Admin Server Admin |
|
This group is a special subclass of administrators. By default, they have the same privileges as administrators except that they cannot assign users to the Administrators or Sub-administrators role, and they cannot create or delete users or groups. |
User Admin Server Admin |
If you are an administrator, you can set the options of the Sub_Administrators group. Click Sub_Administrators in the Selected Roles list and click the Edit Sub Administrator Privileges button.
The Edit Sub Administrator Privileges window is displayed. Select or deselect the checkboxes to set or remove the following privileges:
Create User
Create Group
Delete User
Delete Group
The Portlets tab allows you to determine which individual components of Netcool Reporter a user can access. These components are assigned automatically when you assign a user to one or more roles or groups.
Micromuse recommends that you use the default portlet settings supplied with Netcool Reporter and select the appropriate groups to enable the required components of Netcool Reporter.
There are a few special circumstances in which a report or presentation can overload the Netcool Reporter server, causing performance problems for all users. By default, Netcool Reporter prevents those circumstances from occurring. However, if you wish, you can override these safeguards for specific users by opening the user's Privileges tab, as shown below.
|
An SQL report may sometimes contain a cartesian product in the query. This is, when the query draws on two different tables without joining them together, with the result that the number of lines of output are the product of the number of lines returned from each table. Ordinarily, this happens because the designer made an error in the SQL code. However, it is possible, though rare, that a designer returns such a product deliberately.
By default, the Allow Cartesian privilege is set to true allowing the user to run reports that return cartesian products. If you change the setting to False an error message is displayed when the user runs a report which returns a cartesian product.
Netcool Reporter can limit how many rows a report may return to the user. This limit is set individually for each user, using the Max Rows field.
By default, the maximum number of rows returned is 0, which indicates that there is no limit on the number of rows returned. You can set this limit to any integer you wish.
A person designing an SQL report can set up the report to run one or more database stored procedures before or after the report is run. Users need to select stored procedures for a particular report using the Procedures tab in the Report Designer. Setting this option to true causes the Report Designer to display the Procedures tab for this user.
This option is configured initially for the Netcool Reporter administrator. If the user you are editing or creating does not have access to the Report Designer, setting this option has no effect.
To select the data sources for a user, click the SQL Data Sources tab, as shown below. You can see a list of all SQL data sources on the left and the SQL data sources currently available to the user on the right.
|
|
Figure 345: SQL Data Sources Tab |
If you are creating a new user, select a data source in the List all Data Sources list then click the Select > button or double-click the highlighted data source to move the selection to the Selected SQL Data Sources list.
Repeat this process to select as many of the associated data sources as you want your new Netcool Reporter user to access. Click the OK button to add the new user.
If you are editing an existing user, you can select and deselect data sources.
You may delete users from the Netcool Reporter application using the Users tab. Before deleting a user, however, you must decide what to do with that user's files. When a user is deleted from the Netcool Reporter, his or her files are not automatically deleted. If they were, other users would not be able to view the published reports or presentations that rely on data sources created by the user being deleted. When you delete a user therefore, you must reassign the deleted user's files to another user.
Note:
If you have been assigned to the Sub-administrators role, you may not have permission to delete users. See Sub_Administrators for details.
To delete an existing user, highlight the user name on the Users tab and either:
Select the menu option UserΖDelete User.
-or-
Click the Delete User button on the toolbar.
In either case, a window is displayed asking you to reassign the deleted user's objects to another user. The list you see depends on your privileges. If you have been assigned the Administrators role, you will see a list of all Netcool Reporter users. If you are a Sub-administrator, you will see only those users that you have rights to manage.
Choose a user from the list and click OK. The user you chose to delete will be deleted and his or her files, folders, and channels will be reassigned as explained below. Micromuse recommends that you do not delete the three default Netcool Reporter users.
The user that has been assigned the deleted user's objects will see a new folder in the My Folders folder in the Netcool Reporter interface. This folder will be called del_user_<name>.
For example, suppose user jdoe is deleted and his objects are assigned to user franklin. When Franklin logs into the Netcool Reporter, he will see a a folder called del_user_jdoe in the My Folders folder as shown below:
|
|
Figure 346: View of a Deleted User's Files After They are Reassigned to Another User |
The folder del_user_jdoe will contain all of jdoe's folders and files. Ownership of these files will be reassigned to user franklin, and for each of these files, user franklin will inherit all of jdoe's privileges.
Channels are reassigned differently. When a user is deleted, the user that has been assigned the deleted user's objects will automatically become the owner of that user's channels. If the deleted user owns any of the files in a channel, the user that has been assigned the deleted user's objects will become the owner of those files.
For example, if user jdoe is deleted and his objects are assigned to user franklin, franklin will become the owner of all of jdoe's channels. For each channel, user franklin will inherit jdoe's privileges. So if jdoe has read, edit, and publish privileges for a channel, franklin will be assigned read, edit, and publish privileges for that channel.
Furthermore, if jdoe was the owner of any files in a channel, franklin will become the owner of those files. For each of those files, franklin will inherit jdoe's privileges.
Instead of creating new Netcool Reporter users and associating them with existing database user accounts by creating data sources, you can directly import all database user accounts into the User Administrator window.
Note:
This option is disabled if you are using LDAP to maintain user information. It is also disabled if your repository database is ODBC based.
To import database users:
1. Select the menu option UserΖImport Users from Database....
2. A Database DBA Login window appears, as shown below.
|
|
Figure 347: Database DBA Login Window |
3. You must log on with a database administrator user name and a DBA password in order to read the user account information. Click the Connect button.
4. After you have successfully connected, a window is displayed listing the user IDs extracted from the database system tables.
|
|
Figure 348: Users from the Database |
5. From the Database Users list, select the users you want to import, then click Import.