Text repositories

The Text repository type allows OmniGroupServer to retrieve custom user and group information stored in text files. In addition to the parameters that apply to all repository types, you can configure the parameters in this section.

NOTE: If you want to set up multiple text repositories, you can also configure these parameters in the [Default] section (if you also have other repository types set up, they are not affected by these settings).

NOTE: OpenText recommends populating an empty repository using the Import action, rather than configuring a text repository. The import action immediately populates the repository.

The Text repository type can be configured in one of two ways:

  • Incremental synchronize. When GroupServerIncremental is set to true, the group server only retrieves users and groups that have been modified since it last cycled. In this case, the text files from which the group server retrieves security information must be stored in the directory specified in the parameter TextDirectory. And each file must have a filename in the format RepositoryName_Index, where the RepositoryName is the section in the configuration file, and the Index increases by 1 from 0 (zero).

    The Group Server stores the index of the last processed file in the file RepositoryName_LastProcessed. The files can be deleted after processing by setting the parameter TextDeleteProcessed to true. Nested groups can be processed by setting the parameter GroupServerNestedGroups to true.

    An example configuration for incremental synchronize:

    [Text]
    GroupServerLibrary=ogs_text
    GroupServerIncremental=TRUE
    TextDirectory=C:\Autonomy\OmniGroupServer\TextDir
  • Complete synchronize. When GroupServerIncremental is set to false, the group server retrieves all users and groups every time it cycles.

    In this case, the text file from which the group server retrieves security information must be specified in the parameter TextFile. This file is read fully during each cycle of the fetch. Nested groups can be processed by the parameter GroupServerNestedGroups to true.

For detailed information about the text file format, see the file textgsexample.txt. This file is installed in the InstallationDir\TextDir directory when you install OmniGroupServer with the Text component enabled.