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
• Configuring Files
• Machine Roles and Server Functions

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

• Importing New Files into a One Identity Manager Database
• Configuring Files

Configuring Files

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

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

• Importing New Files into a One Identity Manager Database
• Exporting Files from a One Identity Manager Database

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.