Configuration files

The main configuration file is called wimconfig.xml. This file stores the virtual member manager settings at the global (admin) level or at the domain level in a multiple security domain environment.

When virtual member manager is started, during initialization, the virtual member manager core component retrieves configuration data using the virtual member manager Configuration API. Some of the configuration data is passed to the various adapters for their own initialization. This file contains the following information:
  • General configuration information applicable to the specific instance of virtual member manager
  • Schema and schema extension file names and locations
  • Information about supported entity types such as their RDN property and default parent entry in the virtual member manager hierarchy
  • Repository information (what repositories are configured, for example DB, LDAP, or Custom)
  • Whether entry mapping repository and property extension repository are enabled
  • Mapping of entries in the virtual member manager hierarchy to the underlying repositories

The wimdomain.xsd file contains the “data model” of virtual member manager. It consists of the definitions of the entity types that virtual member manager supports out-of-the-box. The wimdomain.xsd is the detailed XML Schema representation of the virtual member manager common data model. The properties for the entity types are defined at the virtual member manager level and need to be mapped to actual repository-specific property definitions in other configuration files.

The wimdatagraph.xsd file defines the options that can be specified when the virtual member manager API is invoked.

If you need to extend the virtual member manager domain model to add more entity types or properties for the out-of-the-box entity types, you must use a separate XSD file (for example, wimextension.xsd) or a separate XML file (for example wimxmlextension.xml).

Virtual member manager configuration files in a multiple security domain environment

When you create a security domain in WebSphere Application Server 8.0, all virtual member manager configuration files are created for that domain, regardless of whether virtual member manager is configured as the active user registry.

WebSphere Application Server provides an option to create a domain by copying a selected domain from a domain collection. Based on the options you specify while creating a domain, virtual member manager files are copied from the selected domain, the admin security domain, or default profile template location. This might also include copying the file repository if it exists in the source domain.

The domain-specific virtual member manager files are located under the app_server_root/profiles/$ProfileName/config/waspolicies/$PolicyName/securitydomains/$DomainName directory.

The files related to virtual member manager configuration and data model schema are listed in the following table.

The following directory conventions are used in the table:

Table 1. Virtual member manager configuration files
Description Level Directory File name
Virtual member manager configuration schema file One global copy for the whole system app_server_root/etc/wim/schema/config wimconfig.xsd
Virtual member manager configuration file Global level cell_vmm_root/config wimconfig.xml
Domain level domain_vmm_root/config
Argus files Global level cell_vmm_root/config/authz  
Domain level domain_vmm_root/config/authz
File registry that contains users and groups for the out-of-the-box file repository Global level profile_root/config/cells/$CellName fileRegistry.xml
Note: The ThefileRegistry.xml file is copied for a new domain only if the source domain contains this file.
  Domain level profile_root/config/waspolicies/$PolicyName/securitydomains/$DomainName
Virtual member manager out-of-the-box data model schema files. One global copy for the whole system app_server_root/etc/wim/schema/model
Note: The same files are also copied to cell_vmm_root/model as they are required for migration purposes.

wimdatagraph.xsd
wimdomain.xsd
wimschema.xsd
xml.xsd

Virtual member manager data model extension files Global level cell_vmm_root/model

wimxmlextension.xml
custom xsd

Domain level domain_vmm_root/model

wimxmlextension.xml
custom xsd


Icon that indicates the type of topic Concept topic

Terms and conditions for documentation | Feedback


Timestamp icon Last updated: March 30, 2016 13:35
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=vmm&topic=configurationfiles
File name: configurationfiles.html