G.2. Basic Tasks in the Red Hat Console

While most server management functions are carried out in server-specific console windows for the Red Hat Directory Server and Admin Server, the main Red Hat Console itself has some basic management functions, such as creating server instances, searching the directory, setting some access controls, and allowing some entry modifications.
This chapter covers basic tasks in the Red Hat Console, including installing the Console, creating and editing server instances, and configuring the Console appearance.

G.2.1. Installing the Console

The Red Hat Console package, 389-ds-console.noarch, can be installed on Red Hat Enterprise Linux systems using tools like yum. For example:
yum install redhat-idm-console
The Red Hat Console package and also be downloaded through Red Hat Network and installed using package management tools such as rpm and pkgadd. For example:
rpm -ivh redhat-idm-console-1.0.0-22.el4idm.i386.rpm

G.2.2. Launching the Console

  1. Run the redhat-idm-console command. For example:
    redhat-idm-console -a http://server.example.com:9830
    The different options for the redhat-idm-console command are listed in Table G.2, “Arguments for redhat-idm-console”.
  2. Enter the user name and password.
    Also, enter or select the URL for the instance of Admin Server, if one was not passed with the command. The URL can be either the host name or the IP address of the Admin Server host. The Admin Server port number must be given, as well. The five most recent Admin Server URLs accessed are available as a drop-down menu option.

Table G.2. Arguments for redhat-idm-console

Argument Description Example
-a adminURL Specifies a base URL for the instance of Admin Server to log into. -a http://eastcoast.example.com:987
-f fileName Writes errors and system messages to fileName. -f system.out
-h Prints out the help message for redhat-idm-console.
-s Specifies the directory instance to access, either by specifying the DN of the server instance entry (SIE) or the instance name, such as slapd-example. -s slapd-example
-u Gives the user DN to use to log into the Console. -u "cn=Directory Manager"
-w Gives the password to use to log into the Console. -w secret
-w - Reads the password from the standard output.
-x options Specifies extra options. There are three values for extraOptions:
nowinpos, which puts the Console window in the upper left corner of the screen
nologo, which keeps the splash screen from being displayed and only opens the login dialog
javalaf, which uses the Java look and feel for the Console interface rather than the platform-specific styles
To use multiple options, separate them with a comma.
-x nologo,nowinpos
-y file Reads the password from the specified input file. -y password.txt

G.2.3. Opening a Directory or Admin Server Window

The Red Hat Management Console is the avenue to access instance-specific management windows for the Directory Server and Admin Server. To open a console window for a specific server instance:
  1. Open the Red Hat Console.
    redhat-idm-console
  2. Click the Servers and Applications tab, which lists all of the Directory Server and Admin Server instances within the configured Directory Server domain.
  3. In the navigation tree, click a server to select it.
  4. In the right-hand panel, click Open.
    Alternatively, double-click the server icon in the navigation tree.

G.2.4. Changing the Console Appearance

The fonts used for different elements in the Console can be edited. The font settings and the location where the font profiles are stored can be customized. The default font settings can be restored easily.
This section also describes how to control other aspects of the appearance of the Console. For example, table columns can be easily rearranged. It is also possible to control which server instances are displayed (called a navigation view) which makes it easy to sort and find server instances.
Access control instructions can be applied to user interface elements, which is discussed in Section G.5, “Setting Access Controls”.

G.2.4.1. Changing Profile Locations

The Console formatting is stored in profiles. An entry's profiles can be stored locally, which means that they are only available at a specific workstation, or can be stored in the configuration directory, so they are accessible anywhere.
To set the profile location:
  1. Click Edit in the top menu, and choose Preferences.
  2. Click the Settings tab.
  3. Select the radio button for the location to save the settings.
    • In your configuration directory means that the settings are stored in the Directory Server configuration, making them available no matter where you log into the Console.
    • On your computer's hard disk stores the setting profiles locally. This is mainly useful if you want specific, different settings used by default on different Consoles, such as a workstation and a laptop.
  4. Click OK.

G.2.4.2. Restoring Default Font Settings

  1. Click Edit in the top menu, and choose Preferences.
  2. Click the Settings tab.
  3. Click the Restore Defaults button to revert to the default display settings.
  4. Click OK.

G.2.4.3. Changing Console Fonts

Different parts of the Console, such as table headings and regular text, have different font settings. The font settings are stored in profiles. The profiles define the font family, size, and formatting for every text element. There can be multiple font profiles available, and the font profiles can be private, such as settings for a specific user or group, or public, so that any user can access them.
The default profile can be edited without having to create new profiles.
To edit or create a font profile:
  1. In the main Red Hat Management Console window, from the Edit menu, choose Preferences.
  2. Click the Fonts tab.
  3. To save the new settings as a new profile, click the Save As button, and fill in the profile name.
    To edit the default (or current) profile, simply begin editing the fonts.
  4. In the Screen Element column, click a screen element to edit, then click the Change Font button.
  5. Edit the font for that specific element. There are three settings which can be changed: the font family, the size, and the formatting (bold or italic).
  6. Click OK to save the profile.
  7. Restart the Console to apply the changes.
To load and use a saved font profile, open the Font tab in the Preference dialog, and simply select the font profile to use and click OK.
To delete a font profile, simply make sure that it is selected from the drop-down menu in the Fonts tab, and click the Remove button.

G.2.4.4. Reordering Table Columns

The columns in a table can be rearranged by dragging them into a new position.
  1. Click in the table heading.
  2. Still holding down the left mouse button, drag the column to its new location. The other table columns will automatically shift down to their new positions.
  3. When you release the mouse button, the column snaps into its new position.

G.2.4.5. Customizing the Main Window

Different elements of the main Red Hat Management Console window can be displayed or hidden; this is set by check boxes in the View menu.
There are three parts of the Console which can be hidden: the navigation tree (the smaller panel on the left of the Console window); the decorative background and banner at the top of the Console window; and the status bar at the bottom of the Console.

G.2.4.6. Working with Custom Views

The Console allows different views to be created to show different server and domain entries in the Red Hat Management Console window. Views show only a defined set of server entries; this makes it easier to maintain large numbers of instances or to have a quick way to perform specific tasks.
G.2.4.6.1. Creating Custom Views
Custom views show different, defined server instances. Views are either public or private. A public view is visible to any user, while a private view is visible only to the person who created it.
  1. In the View menu, choose Custom View Configuration.
  2. Click New.
  3. Choose whether the new view will be public or private, then click OK.
  4. In the Edit View window, enter a descriptive name for this view.
  5. Select a resource from the Default View navigation tree on the left. Click Copy to list it in the panel on the right and include it in the view.
    To select a range of resources, click the SHIFT key and select the first and last entries; select multiple, separate resources by holding down the Ctrl key and selecting the entries.
To edit a custom view, select it from the list, click the Edit button, and make the changes to the name or resources.
To delete a custom view, select it from the list, and click the Remove button.
G.2.4.6.2. Switching to a Custom View
Choose the desired custom view from the drop-down list on the Servers and Applications tab.
To return to the default view, choose Default View from the drop-down list.
G.2.4.6.3. Setting Access Permissions for a Public View
  1. From the View menu, choose Custom View Configuration.
  2. Choose a public Custom View from the list and click Access.
  3. Set the access control instructions.
  4. Click OK to save the ACI.
For more information on setting access permissions and creating access control instructions, see Section G.5, “Setting Access Controls”.