Chat now with support
Chat with Support

Identity Manager 8.0 - Configuration Guide

One Identity Manager Software Architecture Working with the Designer Customizing the One Identity Manager Default Configuration Checking Data Consistency Compiling a One Identity Manager Database Working with Change Labels Basic System Configuration Data
One Identity Manager Authentication Module Database Connection Data Configuration Parameters for System Configuration Setting up the Mail Notification System Enabling More Languages for Displaying and Maintaining Data Displaying Country Information Setting Up and Configuring Schedules Password Policies in One Identity Manager Reloading Changes Dynamically TimeTrace Databases Machine Roles and Server Functions Files for Software Update Operating Systems in Use System Configuration Reports Using Predefined Database Queries Managing Custom Database Objects within a Database
The One Identity Manager Data Model Granting One Identity Manager Schema Permissions Working with the User Interface
Object definitions for the User Interface User Interface Navigation Forms for the User Interface Statistics in the One Identity Manager Extending the Launchpad Task Definitions for the User Interface Applications for Configuring the User Interface Icons and Images for Configuring the User Interface Language Dependent Data Representation
Process Orchestration in One Identity Manager
Declaring the Job Server One Identity Manager Service Configuration Handling Processes in the One Identity Manager
Tracking Changes with Process Monitoring Conditional Compilation using Preprocessor Conditions One Identity Manager Scripts Maintaining Mail Templates Reports in the One Identity Manager Custom schema extensions Transporting One Identity Manager Schema Customizations Importing Data Web Service Integration SOAP Web Service One Identity Manager as SPML Provisioning Service Provider Searching for Errors in the One Identity Manager Processing DBQueue Tasks One Identity Manager Configuration Files

Importing New Files into a One Identity Manager Database

Importing New Files into a One Identity Manager Database

In order to distribute new or changed custom files, such as custom form archives, through automatic software updating, the files are loaded into the One Identity Manager database with the program "Software Loader".

To import files

  1. Open the Launchpad and select Files for software update. This starts the program "Software Loader".
  2. Select Import into database on the start page.
  3. Enter the One Identity Manager database connection credentials on the Connect to database page.
  4. Specify the file to be imported on the Select files page.
    1. Select the base directory where the files can be found.

      The status and file size of all the files in the selected directory are displayed in the file list. The status is determined from the file information in the database. To test the file version, the file size and the hash value are determined and compared to the entry in the database.

      NOTE: Take note when selecting the base directory that a directory tree is not created accidentally.

      Table 72: Status Meaning
      Status Meaning
      Version unknown The file belongs to the known files but has not been loaded into the database yet. There is no version information in the database.
      File unknown This file is new. The file is in the list of known files but has not been loaded in the database yet. There is no version information in the database.
      Version OK The file version matches the version in the database.
      Version changed This version of the file has change with respect to the version in the database.
    2. Mark the files to be loaded into the One Identity Manager database. You can multi-select files with SHIFT + SELECT or CTRL + SELECT.

      TIP: Click with the mouse in a column header to sort by the selected column.

      TIP: Modified files can be preselected in the context menu.

      Table 73: Meaning of Context Menu Items
      Context Menu Item Meaning
      Open all directories All the directories are opened.
      Open all modified files All the files with the status "Version changed" are selected. Files in the subdirectories are only selected if the directories are opened beforehand.
  5. Apply a change label on the Select change label page.

    Issue a change label to mark files in order to simplify the transfer of new files between various databases (test database, development database, operational database). Change labels are offered in the program "Database Transporter" as export criteria when a customer transport package is created.

    1. Select Assign files to following change label.
    2. Select the change label using the button next to this option.
  6. The files are loaded straight from the One Identity Manager database. After successfully loading the files into the database, the semaphore value "Softwarerevision" is updated in the database by the DBQueue Processor. In this way, the files to be updated are added to the update file list at the next semaphore test and distributed to the workstations and servers.
  7. Specify other file settings on the Assign machine roles page.
    1. Assign a computer role to the files.
    2. To specify other settings, click ... next to the file name.
      Table 74: Other File Settings
      Setting Description
      Source directory Path in the installation source.
      Create backup A copy of the file is made if the software is updated automatically.
      No update The file is not updated automatic software update.
  8. Click Finish on the last page to end the program.
Related Topics

Exporting Files from a One Identity Manager Database

Exporting Files from a One Identity Manager Database

In order to equip individual Job servers with the newest software version, you have to export the files from the One Identity Manager database. The program"Software Loader" exports the files from the database.

To export files

  1. Open the Launchpad and select Files for software update. This starts the program "Software Loader".
  2. Select Export from database on the start page and click Next.
  3. Enter the One Identity Manager database connection data on the Connect to database page and click Next.
  4. Specify which data to export on the Select files page.
    1. Specify the destination directory to which to export the data.
    2. Mark the files to export. You can multi-select files with SHIFT + CLICK or CTRL + CLICK.

      TIP: Click with the mouse in a column header to sort by the selected column.

      Exportable files are displayed with their status and file size. The program checks whether One Identity Manager files already exist in the given directory in order to determine the status. If this is the case, the files are updated, otherwise the files are recreated.

      Table 75: Status Meaning
      Status Meaning
      Unknown file The file has not been exported from the database into the given directory yet.
      Version OK The file version matches the version in the database.
      Version changed This version of the file has change with respect to the version in the database.
    3. Click Next.
  5. The marked files are export to the given directory. This may take some time depending on the number of files selected. The export steps are displayed on the page Uploading files. Any export errors are displayed.
    • After exporting is complete, click Next.
  6. Click Finish on the last page to end the program.
Related Topics

Configuring Files

Specify whether a backup should be made of an existing file when the software is updated.

NOTE: You specify these properties when you import new files with the "Software Loader" program.

To configure the file properties

  1. Select the category Base data | Installation | One Identity Manager software in the Designer.
  2. Select a file.
  3. Edit the following master data.
    Table 76: File Properties
    Property Description
    Create backup A backup of the existing file is made during the software update for files that are labeled with this option.
    No update The file is not updated automatic software update.

    CAUTION: Do not change any other properties as it may result in errors during automatic software update.

Related Topics

Operating Systems in Use

References to operating systems are required at various places in the One Identity Manager schema. The One Identity Manager supplies predefined entries for operating systems. If other operating systems are required, you can create the necessary entries.

To set up an operating system

  1. Select the category Base Data | Advanced | Operating systems in the Designer.
  2. Select the menu item Object | New.
  3. Edit the master data.
Table 77: Operating System Properties
Property Description
Processing Status

Object processing status. The process state is used for creating customer configuration packages.

Operating system Short name of the operating system.
Name Long name of the operating system.
Client operating system Specifies whether the operating system can be used for workstations.
Server operating system Specifies whether the operating system can be used for servers.
Version Version number of the operating system.
Related Documents