Managing the server properties

You can create, update, or reconfigure the custom property values, the IBM® Security Identity Manager Server property values, or the application server property values from the Appliance Dashboard of the IBM Security Identity Manager virtual appliance.

Before you begin

You must be familiar with the property keys and values of the IBM Security Identity Manager, the custom property, or the application server supplemental property files before you do this task.

About this task

When you select a property, the Property value field is populated with a value. You can update a property value by overwriting its old value with the new one. For example, to use another file in the IBM Security Identity Manager virtual appliance, do these steps:
  1. Upload a file that you want by using the upload function of the virtual appliance.
  2. Update or edit the name of that file in the Property value field.

Procedure

  1. From the top-level menu of the Appliance Dashboard, select Configure > Advanced Configuration > Update Property to display the Update Property page.
  2. In the Update Property page, do these actions to work with the properties files.
    See Table 1.
    Table 1. Properties tabs and their actions
    Tab Tab Description Actions
    All properties
    Displays this property list in the left pane:
    • Custom property files
    • Identity server property files
    • Application server property files

    Displays a list of properties files when you select a property.

    Select a properties file to display a list of the property names in the right pane. The right pane can have multiple tabbed pages, depending on the number of property names that are associated with the selected properties file. The default setting is 10 names per page. Depending on your requirement, click the tabbed page number or change the setting to view the property names. You can also go to a specific page by specifying the page number in the Go to Page window. To open this window, click the arrow, which is placed next to tabbed page number.

    You can use the search box to find a specific property name that you want to update. Type a name or a character string for the properties file in the box to help you narrow your search. Your string search is done within the context of the properties file that you selected. All property names that contain the string are displayed. If you want to return to the full list of property names, clear the search box.

    The right pane contains these buttons:
    • New
    • Edit
    • Refresh
    • Upload
    • Delete File
    To add a property, do these steps:
    1. Click a property files tab:
      • Custom property files
      • Identity server property files
      • Application server property files
      For example, click Identity server property files.
    2. Select a property file from its list. For example, CustomLabels.properties.
    3. Click New to open the Update property window.
    4. Provide a value in the Property name field. For example, ernamingcontexts.
    5. Provide a value in the Property value field. For example, AttributesExtension.
    6. Click Save Configuration.
    To edit a property, do these steps:
    1. Click a property files tab:
      • Custom property files
      • Identity server property files
      • Application server property files
      For example, click Application server property files.
    2. Select a properties file from its list. For example, CustomLabels.properties. Depending on any property names and its values that are associated with the selected file, the right pane displays all of them.
    3. Select a property name. For example, com.ibm.SOAP.loginUserid.
    4. Click Edit to open the Update property window.
    5. Edit the existing value in the Property value field with the new value. For example, User1.
    6. Click Save Configuration.

    To display the most recent version of the data, including changes that were made to the data since it was last refreshed, click Refresh.
    To upload a property file, do these steps:
    1. Click Custom property files.
    2. Click Upload to open the File Upload window.
    3. Click Browse to search and select the property file.
    4. Click Save Configuration.
    Note: You can upload property files only from Custom property files.
    To delete a property file, do these steps:
    1. Click Custom property files.
    2. Select a properties file. For example, demo.properties.
    3. Select a property name from the table.
    4. Click Delete File.
    5. Click Yes to confirm.
    Note: You can delete property files only from Custom property files.
    Modified properties Displays a segregated list of all the updated properties files under these tabs, including the Reconfigure button:
    • Identity server
    • Application server
    • Custom
    Note: Depending on your requirement, you can choose to reconfigure a properties file.
    To reconfigure a properties file, do these steps.
    1. Click a property tab that contains the properties file:
      • Identity server
      • Application server
      • Custom
      For example, select Identity server.
    2. Select a properties file. For example, ui.properties.
    3. Click Reconfigure to display the Update property window.
    4. Edit the existing value in the Property value field with the new value. For example, 700.
    5. Click Save Configuration.
    To delete a properties file, do these steps:
    1. Click Custom.
    2. Select a property file. For example, enRole.properties.
    3. Click Delete.
    4. Click Yes to confirm.
    Note: You can delete properties files only from Custom.