test

Sun Desktop Manager 1.0 Administration Guide

Chapter 2 Using the Desktop Manager GUI

This chapter provides information about the Desktop Manager functionality and usage.

Introduction

The following are some terms you should know in order to work with the Desktop Manager:

Configuration Repositories Window

The configuration repository is the storage location for the configuration data that you need to configure your applications and where organizational hierarchy information is stored, along with profile and assignment data for each element. In the Configuration Repositories window, you can create new repositories, as well as work with and synchronize existing repositories.

The Configuration Repositories Window consists of a masthead and the Configuration Repositories list.

The masthead provides a number of general links. The upper part of the masthead contains the Utility Bar, which contains four links (from left to right):

The lower section of the masthead contains the product name, the server name, and the name of the administrator currently logged in.

Configuration Repositories Table

The Configuration Repositories table consists of five columns:

You can perform the following actions within the Configuration Repositories table:

ProcedureCreating a New Configuration Repository

A configuration repository is a place where organizational hierarchy information is stored, along with profile and assignment data for each element.

Steps

  1. Click the New button in the Configuration Repositories table

    The New Configuration Repository Wizard opens. The wizard is used to create a configuration repository for use with the Desktop Manager.

  2. In the Repository Name field, type a name for the new configuration repository, and then click Next.

  3. Select the repository type from the Repository Type list.

    The wizard can be used to configure three types of repositories:

    • LDAP: The hierarchy is taken from LDAP, and all data is stored in LDAP.

    • File-Based: The hierarchy is taken from a file, and all data is stored in directories and files.

    • Hybrid: The hierarchy is taken from LDAP, but all data is stored in directories and files.

  4. Click the Next button.

  5. Enter the details of the LDAP server that you want to configure for this repository.

    The Hostname and Port on which the server runs are required. You can also choose whether or not to connect to this server using SSL.

    Note –

    Note To connect to the server using SSL, the proper certifcate needs to be present in the Desktop Manager key store. This key store is located in /etc/opt/webconsole/keystore, and either the Certifcation Authority or the LDAP server certifcate needs to be present in that store. A certifcate can be added to that location by running the command: 


    keytool -import -file <certificate file> -keystore /etc/opt/webconsole/keystore

    The default password for that key store is changeit. The Java Web Console must be restarted using the smcwebserver restart command for the new certifcate to be recognized by the Desktop Manager.

  6. Further steps are determined by the choices made in the preceding steps. Follow the instructions provided by the wizard.

    Note –

    The directory whose URL is provided for the creation of file-based or hybrid repositories must be owned by user noaccess, group noaccess, and have permissions 755 set. This results in read and write permissions for user noaccess, and read only permissions for all others.

ProcedureRemoving a Configuration Repository

Steps

  1. Select the check box corresponding to the configuration repository that you want to remove.

  2. Click the Remove button.

    A confirmation dialog appears.

  3. If you really want to remove the configuration repository, click the OK button in the confirmation dialog.

ProcedureRenaming a Configuration Repository

Steps

  1. Select the check box corresponding to the configuration repository that you want to rename.

  2. Click the Rename button.

    A Rename dialog opens.

  3. Type the new name of the configuration repository in the text field of the dialog, and click OK.

ProcedureSynchronizing Configuration Repositories

With the Desktop Manager you can manage multiple back ends in parallel. This allows you to define one back end for testing and one back end for the final production. Configuration changes can now be defined and evaluated first in the test back end. Thereafter you can synchronize parts or the complete test back end with the production back end to apply the required changes quickly and safely to the production system. This method can also be used for a simple backup and restore mechanism of the production back end. The Synchronization window allows you to perform this synchronization.

Steps

  1. In the Configuration Repositories window, select the repository that you want to synchronize.

    The Synchronization window opens.

  2. Select the source repository from the Source Configuration Repository list.

    You can change the source repository which serves as source for the changes. This repository is not changed.

  3. (Optional) You can restrict the source repository by clicking the Change button next to Source Starting Point.

    This specifies another element than the root as the source starting point for the synchronization.

    A dialog opens, which allows you to navigate to the desired organization or domain element. Once an element is selected, the new path is reflected in the Source Starting Point.

  4. Select a target repository from the Target Configuration Repository list.

    You can change the target repository which serves as target for the changes. This repository is changed.

  5. (Optional) You can restrict the target repository by clicking the Change button next to Target Starting Point.

    This specifies another element than the root as the target for the synchronization.

    A dialog opens, which allows you to navigate to the desired organization or domain element. Once an element is selected, the new path is reflected in the Target Starting Point.

  6. Click the Compare button.

    The two trees are compared and all differences are listed in a table.

  7. Select the check boxes next to the table rows containing the profiles you want to synchronize and click the Synchronize button.

    When the synchronization is finished the target repository matches the source repository regarding the selected profiles.

Profiles — Tree View

The Profiles — Tree View page displays all available profiles that are currently assigned to an element. On the left side of the page is a navigation area, where you can browse through the tree hierarchies to find profiles. On the right side of the page is the Content area, which displays information about any profile selected in the navigation area.

Navigation Area

The navigation tree is used to browse through the organization and domain trees to select an element. The tree reflects the hierarchy of the elements. If a node has subnodes, a blue triangle is displayed to the left of the node name. Clicking the blue triangle, the node is expanded, and some subnodes are shown.

Note –

By default, only 10 subnodes are displayed for each expanded node. If there are more than 10 subnodes, the 11th “node” does not refer to an element, but indicates that there are nodes that are not displayed: “... some elements not displayed”. Clicking this “node” opens the Find function.

To select an element, navigate the tree and click on the desired element. Once an element has been selected, the element is highlighted, and the content area displays the element's assigned and inherited profiles.

The navigation also provides a mechanism for a recursive search (see Searching for an Element) and a non-recursive find (see Using the Find Function), in order to locate elements in the tree hierarchies. Clicking the Search button opens the Search window.

ProcedureSearching for an Element

The Search function allows you to recursively search for an element in the domain or organization hierarchy. It searches for not only the direct children of an element, but also all descendents. To perform a search of only the direct children of an element, use the Find function.

A search opens the Search window, which also allows you to perform a more advanced search.

Note –

The Search feature only supports LDAP and hybrid repositories, but does not support file-based repositories. If you perform a search on a file-based repository, the result is always reported as Elements Found (0).

Steps

  1. Type the name or partial name of the element that you wish to search for into the search field.

    Note –

    The search is not case-sensitive and not strict, for example, the search string "bc" will match "ABC" and "bcd". An asterisk (*) denotes an arbitrary sequence of characters within a search string. You can use more than one asterisk at any location in the string. An empty field is equivalent to a field with the search string “*”.

  2. Click the Search button.

    The Search window opens. Any string that you typed into the search field of the Navigation area is moved from that search field to the search field of the Search window, and a search for that string is started automatically. Any results are then displayed in a results table, which shows the name, type and path of any found elements.

    Note –

    The maximum number of results is capped at 100.

    If no results were found, or if you left the search field in the Navigation area blank, you can type in the name of an element in the search field of the Search window.

    Tip –

    Use the type modifier list, located next to the search field, to search for a specific element type, such as “Search domains”.

  3. If necessary, add advanced options to the search by clicking the Show Advanced Options button.

    The advanced options consist of the following:

    • Restrict to: you can determine the element at which the search algorithm should start to traverse through the tree.

    • Results displayed per page: allows you to determine the number of results displayed on every page of the results table.

  4. Click the Search button again to view results for a new or modified search.

    Note –

    Clicking the Reset button changes all search parameters to the default and clears the Search field.

ProcedureUsing the Find Function

The Find function allows you to perform a qualified find for all elements that are direct children of the expanded element. This is in contrast to the search function, which provides a recursive search for elements.

Steps

  1. Click the Some Elements are not Displayed node in the navigation tree.

    The Find window opens.

  2. Type a string or partial string into the Find field.

    The search is not case-sensitive and not strict, for example, the search string "bc" will match "ABC" and "bcd". An asterisk (*) denotes an arbitrary sequence of characters within a search string. You can use more than one asterisk at any location in the search string. An empty field is equivalent to a field with the search string “*”.

  3. Click the Find button.

    A list of results is displayed. The number of results is capped at 100.

  4. To add a found element to the navigation tree, click the desired element in the results list.

    The Find window closes, and the element is added to the list of subnodes in the navigation tree.

Content Area

When you select an element, information about that element is displayed in the content area of the Profiles — Tree View page. The content area can contain up to three tables:

ProcedureCreating a new Profile

Steps

  1. Click the New button.

    The Profile Editor opens.

  2. Follow the instructions provided by the Profile Editor.

    For more information about how to use the Profile Editor to create a new profile, see Profile Editor.

    Note –

    When you have finished creating the new profile, it is automatically assigned to the currently selected element.

ProcedureDeleting a Profile

Steps

  1. Select the check box corresponding to the profile that you want to delete.

    A confirmation dialog appears.

    Caution – Caution –

    It is important to understand that Delete removes all assignments and then physically deletes the profile. You cannot retrieve it, it is gone. Deleting a profile also causes assignments to other elements besides the current element to be removed. To simply remove a profile assignment from an element, use Unassign.

  2. Click the Delete button.

  3. If you really want to delete the profile, click the OK button in the confirmation dialog.

ProcedureAssigning a Profile

Steps

  1. Click the Assign Profile button.

    A dialog opens, listing all available profiles that can be assigned to the selected element.

    Note –

    Profiles already assigned to the selected element, as well as profiles that are not stored at or above the currently selected element, are not listed.

  2. Select one or more of the listed profiles, and click OK.

    The newly assigned profiles now appear in the Assigned Profiles table.

ProcedureUnassigning a Profile

Steps

  1. Select the check box corresponding to the profile that you want to unassign.

  2. Click the Unassign Profile button.

    The profile is now unassigned, and disappears from the Assigned Profiles table.

    Caution – Caution –

    There is no warning dialog, so if you clicked the Unassign Profile button by mistake, you can reverse this by using the Assign Profile function.

ProcedureRenaming a Profile

Steps

  1. Select the check box corresponding to the profile that you want to rename.

  2. Choose Rename from the actions list.

    A Rename dialog opens.

  3. Type the new name of the profile in the text field of the dialog, and click OK.

ProcedureCopying and Moving a Profile

Steps

  1. Select the check box corresponding to the profile that you want to copy or move.

  2. Choose Copy and Move from the actions list.

    The Copy and Move wizard opens.

  3. Follow the instructions provided by the Copy and Move wizard to perform your task.

ProcedureImporting Profiles

Steps

  1. Make sure all check boxes are deselected.

  2. Choose Import from the actions list.

    The Import Profile dialog opens.

  3. Enter the path of the file that you want to import, or click the Browse button to choose a file from the default file chooser dialog of your operating system.

  4. Click the Import button.

ProcedureExporting Profiles

Steps

  1. Select the check box corresponding to the profile that you want to export.

  2. Choose Export from the actions list.

    A dialog opens, which allows you to specify the location to which you want to export the file.

  3. Select the Save to Disk option in the dialog and click OK.

  4. Choose the location where you want to save the exported file and click OK.

ProcedureViewing Effective Settings

Effective Settings is a read-only view of the effective configuration settings for a given element, such as an organization, domain or host.

The effective settings of a specific user are the result of a merge process, including the configuration settings stored at the involved organization level(s), role(s), and the user. You can display the merged configuration settings of a selected element in a separate Effective Settings window. This allows for easy verification and also error debugging. An Effective Settings report can also be printed and stored for archival purposes.

Steps

  1. Click the Effective Settings button in the Assigned Profiles table.

    When first opened, the effective settings for the selected element in the navigation tree are displayed.

    The Effective Settings window consists of the following two sections:

    • In the Modify Effective Settings Parameters section, the Create the Effective Settings Using area lets you choose which tree to take into account. The Select an element from the Domain Tree option lets you choose which entities to generate a Effective Settings report for. Use the Browse button to select an element in the organization or domain tree.

    • The Effective Settings section displays the following:

      • The location of the selected element in the hierarchy and the hostname.

      • The time and date when the current effective settings report was generated.

      • In the Profiles Involved section, the list of profiles involved in generating the effective settings report for the current element. They are listed in merge order form most relevant to least relevant. Each profile is a link that opens the Profile Editor window for the profile.

      • The Settings Summary area displays the configuration settings for the current effective settings report, grouped into categories. The Settings Summary contains Name, Value, and Status fields.

        The Status column contains entries of the type “Defined In <pofileName>”, where <profileName> is a link that opens the Profile Editor for that profile on the Configuration Settings tab, and navigates to the particular setting within this profile.

  2. You can modify a generated effective settings report by changing any relevant effective settings parameters, and then clicking the Generate Effective Settings button at the top of the Effective Settings window.

    A new report is then displayed in the Effective Settings window.

  3. To print an effective settings report, click the Print button at the top or bottom of the Effective Settings Window.

Profiles — All

The Profiles — All page displays all available profiles, including those that are not assigned to an element. The profiles are shown in two tables, one for domain profiles and one for organization profiles.

The profile tables let you perform the following actions:

ProcedureCreating a new Profile

Steps

  1. Click the New button in the desired profile table, either organization or domain.

    The Profile Editor wizard opens.

  2. Follow the instructions provided by the wizard.

    For more information about creating a new profile using the Profile Editor, see Profile Editor.

ProcedureDeleting a Profile

Steps

  1. Select the check box corresponding to the profile that you want to delete.

  2. Click the Delete button.

ProcedureRenaming a Profile

Steps

  1. Select the check box corresponding to the profile that you want to rename.

  2. Choose Rename from the actions list.

    A dialog box appears.

  3. Type the new name of the profile in the text field of the dialog, and click OK.

ProcedureCopying and Moving a Profile

Steps

  1. Select the check box corresponding to the profile that you want to copy or move.

  2. Choose Copy and Move from the actions list.

    The Copy and Move wizard opens.

  3. Follow the instructions provided by the Copy and Move wizard to perform your task.

ProcedureImporting Profiles

Steps

  1. Make sure all check boxes are deselected.

  2. Choose Import from the actions list.

    The Import Profile dialog opens.

  3. Enter the path of the file that you want to import, or click the Browse button to choose a file from the default file chooser dialog of your operating system.

  4. Click the Import button.

ProcedureExporting Profiles

Steps

  1. Select the check box corresponding to the profile that you want to export.

  2. Choose Export from the actions list.

    A dialog opens, which allows you to specify the location to which you want to export the file.

  3. Select the Save to Disk option in the dialog and click OK.

  4. Choose the location where you want to save the exported file and click OK.

Profile Editor

The Profile Editor is used to create new profiles and edit existing profiles. You can also view the current settings and options for the currently selected profile.

You can open the Profile Editor by either clicking the name of a profile in one of the tables in the Profiles — Tree View content area or in the Profiles — All page.

Tip –

To create a new profile, see Creating a new Profile.

The Profile Editor contains the following tab pages:

General Properties

The General Properties page allows you to specify general information about a profile. This page is the default view of the Profile Editor window.

Note –

The Profile Editor appears when the user creates a new profile by clicking the New button.

ProcedureSpecifying General Properties for a Profile

Steps

  1. In the Name field, type the desired name of the profile.

  2. Add any comments into the Comments field.

    You can leave the Comments field blank.

    Note –

    The Author and Last Modified fields are read-only, and cannot be modified. The Author field displays the profiles author, and the Last Modified field shows the date and time of the last modification.

  3. Click the Save button.

    If you close the window before saving any new information, and warning dialog appears that prompts you to save the settings.

Configuration Settings

The Configuration Settings page allows you to view and edit the configuration settings that are stored in the selected profile.

ProcedureViewing and Editing a Profile's Configuration Settings

Steps

  1. To view a profile's configuration setting, navigate to the setting from the list of categories on the right side of the page.

    The configuration settings are organized hierarchically into categories that directly correspond to the configuration options of desktop applications, such as StarOfficeTM, MozillaTM, Evolution or Gnome.

  2. Click the desired configuration setting.

    The selected profile's settings appear, which displays the available settings for that profile. If necessary, additional context information is provided, such as the effects of individual settings or the allowed value range.

    Note –

    If you select a category rather than a configuration setting, a table appears that lists that categories settings or sub-categories.

  3. For each configuration setting, you can either specify a concrete value, or you can leave the setting undefined.

    If you leave the setting undefined, the application will not be affected by this profile setting, and instead takes advantage of its own factory built-in default value. In general, the Profile Editor lists and applications default value through additional help text or, if possible, through a marker directly in the setting's options list.

    Note –

    It is important to understand that several profiles might affect the same user. For example, you can create a profile with settings for a specific organization. These settings are automatically available for all users that are part of this organization. Similarly, you can define additional profiles with configuration settings for sub-organizations. These may overwrite settings of the parent organization, for example, different proxy settings for sub-organizations would be defined, but leave other settings unchanged. The effective settings for a specific user would then be the result of a merge process including all profiles assigned to the organization, sub-organizations and probably the user.

    Tip –

    In some cases you might want to control this merge process and want to enforce a configuration setting, meaning that it should not be possible for other profiles to overwrite your setting and to define a different value. The Profile Editor allows to specify for each setting the desired merging behavior. The default is that other "profiles may overwrite" a setting. Deselecting this option will enforce the setting and other profiles can no longer overwrite your value.

Assigned Elements

The Assigned Elements page lists the elements that are assigned to the current profile, and allows you to assign or unassign elements.

The current profiles elements are displayed in the Assigned Elements table, which contains the following information:

ProcedureAssigning an Element to a Profile

Steps

  1. Click the Assign Element button.

    A window containing a navigation tree appears.

  2. Navigate the tree, and select the desired element.

    Tip –

    If you can't find the desired element in the tree, you can click the Search button to open the Search window and find the element.

    The element then appears in the Assigned Elements table, now assigned to the current profile.

ProcedureUnassigning an Element from a Profile

Steps

  1. Select the check box corresponding to the element that you want to unassign.

  2. Click the Unassign Element button.

    The element is now not assigned to the current profile, and disappears from the Assigned Elements table.

Settings Summary

The Settings Summary is a read-only view of all configuration settings that contain data for the selected profile.

The Settings Summary page contains the Settings Summary table. This table shows the configuration settings that contain data for the current profile, grouped into categories. The table has the following fields:

Advanced Options

The Advanced Options page allows you to specify advanced options for the current profile. There are two main options available on this page:

ProcedureChanging the Application from Location

Steps

  1. Click the Change button.

    A window containing a navigation tree appears.

  2. Navigate the tree, and select the desired element.

    Tip –

    If you can't find the desired element in the tree, you can click the Search button to open the Search window and find the element.

  3. Click the OK button.

ProcedureAssigning a Merge Order to a Profile

Steps

  1. Select the desired profile in the Selected list.

  2. Use the buttons on the right of the list to move the profile up or down within the list.