Chat now with support
Chat with Support

Identity Manager 8.1.4 - Operational Guide

About this guide Simulating data changes in the Manager Scheduling operations activation times Re-applying templates Exporting data with Manager Analyzing data and data changes Analyzing process monitoring in the Manager Schedules in One Identity Manager Mail templates in One Identity Manager Password policies in One Identity Manager Working with change labels Checking data consistency Compiling a One Identity Manager database Transporting custom changes Importing data with Data Import Importing and exporting individual files for the software update Command line programs

Using an import definition file

The import definition provides you with configuration settings for future data imports. Create the import definition file in the Data Import after creating an import. The import definition is saved as a .xml file.

To save an import definition

  1. In the Data Import, on the Saving the import definition page, enable the Save import definition file option.
  2. Click the ... button beside the input field.
  3. Select the path and enter the file name.
  4. Click Save.
Related topics

Importing and exporting individual files for the software update

To distribute new or modified files, such as files from a hotfix package or custom form archives, using the automatic software update function to the workstations and servers, import the files into the Software Loader database using the One Identity Manager program.

All files of a One Identity Manager installation are stored in the One Identity Manager database with their name, repository, content, and a hash value. Each file's assignment to the One Identity Manager tools, such as Manager or One Identity Manager Service, is logged.

When you import a file, the Software Loader initially determines the file status based on 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.

After a file is successfully imported into the database, the software revision semaphore value in the database is updated by the DBQueue Processor. During the next semaphore test, the file is added to the list of files to be updated and is distributed to the workstations and servers.

To equip individual Job servers with the latest software revision manually, you can use the Software Loader program to export individual files from the One Identity Manager database. During the export, the Software Loader checks whether the file already exists in the specified export directory. If this is the case, the file is updated; otherwise, a new version of the file is created.

For detailed information about updating One Identity Manager and about the automatic software update function, see the One Identity Manager Installation Guide.

Detailed information about this topic

Importing custom files into a One Identity Manager database

NOTE: When importing custom files, make sure that the directory structure is correctly generated.

  • Files for FAT clients do not generally require a subdirectory. When importing the files, select the One Identity Manager installation directory as a base directory.
  • Files for web applications generally require a subdirectory, for example a bin directory. When importing the files, select the installation directory for the web application as a base directory. This ensures that the necessary subdirectories, such as the bin directory, are correctly recognized.
  • If a file is required for FAT clients and for web applications, this file must be imported twice; once without a subdirectory and once with a subdirectory.

To import files into a One Identity Manager database

  1. Start the Launchpad and log in to the One Identity Manager database.

  2. In the Change & Extend view, select the Import files for software update entry. This starts the Software Loader program.
  3. Select Import into database on the start page.
  4. On the Connect to database page, check the One Identity Manager database connection data and change if necessary.
  5. Specify the file to be imported on Select files.
    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.

      Table 53: Meaning of status
      Status Meaning
      Version unknown The file belongs to the known files but has not yet been loaded into the database. There is no version information in the database.
      Unknown file The 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 modified The file version has been modified compared with the version in the database.
    2. Select the files you want to load into the One Identity Manager database.

      TIP:

      • Click a column in the table header to order the display by the selected column.
      • Press Shift + select or Ctrl + select to select more than one file.
      • To quickly select all files with Changed version as their status, select Open all directories and Open all modified files in the context menu. Files in subdirectories are only selected if the higher-level directories have already been opened.
  6. On the Select change label page, assign a change label to make it easier to exchange files between various databases, such as the test database, development database and productive database.
    1. Select Assign files to following change label.
    2. Use the button next to the option to select the change label.
  7. The files are loaded straight from the One Identity Manager database.

  8. Specify other file settings on Assign machine roles.
    1. Assign a computer role to the files.
    2. (Optional) For more file settings, click ... next to the file names.
      Table 54: More file settings
      Setting Description
      Directory source Directory path in installation source.
      Create backup A copy must be made of the file during the automatic software update.
      No update The file is not updated by the automatic software update.
  9. Click Finish on the last page to end the program.
Related topics

Editing file settings for the automatic software update

When importing files using the Software Loader program, you specify whether a backup copy of the existing file is to be created during the automatic software update. You can modify these settings later on.

WARNING: Do not change any other file properties as this can lead to errors during the automatic software update.

To configure the file properties

  1. Select the Base data | Installation | Designer software in the One Identity Manager category.
  2. Select a file.
  3. Edit the following master data.
    Table 55: File properties
    Property Description
    Create backup During the automatic software update, a backup of the existing file is created for files marked with this option.
    No update The file is not updated by the automatic software update.
Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating