Manage repositories in federated repository

Follow this topic to manage repositories in a federated repository configuration.

1. In the console, click Security > Global security.

2. Under User account repository, select Federated repositories from the Available realm definitions field and click Configure. To configure for a specific domain in a multiple security domain environment, click Security domains > domain_name. Under Security Attributes, expand User Realm, and click Customize for this domain. Select the Realm type as Federated repositories and then click Configure.

3. Under Related items, click Manage repositories. Repositories configured in the system are listed in the collection panel. This list includes repositories configured using the federated repository functionality as well as repositories created using wsadmin commands described in the topic IdMgrRepositoryConfig (AdminTask).

4. Optional: Click Add to configure a new external repository and select the repository type as LDAP repository, Custom repository, or File repository.

   Restriction: We cannot add a database repository using the console. This repository configuration is supported by using wsadmin commands only.

5. Optional: Click Delete to delete a repository that specified previously using the console or wsadmin commands.

   Restriction: We cannot delete the built-in, file-based repository from the collection panel.

6. Optional: Select one of the repository identifier entries to view or update an external repository configured in the system previously.

   • The LDAP repository configuration settings are described in detail in Configure Lightweight Directory Access Protocol in federated repository.

   • The custom repository configuration settings are described in Add a custom repository to a federated repositories configuration.

   • The file-based repository configuration settings are described in Add a file-based repository to a federated repositories configuration.

   Restriction: While database repositories configured in the system are listed in the collection panel, we cannot update a database repository using the console. Updates to a database repository are supported by using wsadmin commands only.

7. Click OK.

Results

After completing these steps, the collection panel under Managing repositories reflects a current list of repositories configured in the system.

What to do next

1. To add one or more external repositories listed on this collection panel into the realm, see Manage the realm in federated repository.

2. After configuring the federated repositories, click Security > Global security to return to the Global security panel. Verify that Federated repositories is identified in the Current realm definition field. If Federated repositories is not identified, select Federated repositories from the Available realm definitions field and click Set as current. To verify the federated repositories configuration, click Apply on the Global security panel. If Federated repositories is not identified in the Current realm definition field, the federated repositories configuration is not used by WebSphere Application Server.

3. If we are enabling security, complete the remaining steps as specified in Enable security for the realm. As the final step, validate this setup by clicking Apply in the Global security panel.

4. Save, stop, and restart all the product servers (deployment managers, nodes, and Application Servers) for changes in this panel to take effect. If the server comes up without any problems, the setup is correct.

Important: Be aware of any changes made to built-in, file-based repositories that are part of the federated repositories configuration. We must replicate these changes to the managed nodes to ensure that the network deployment configuration is synchronized. See Replicating changes to a built-in, file-based repository for the steps needed to perform this replication.

Subtopics

• (dist) Replicating changes to a built-in, file-based repository
  Changes to built-in, file-based repositories are not automatically replicated to managed nodes in a federated repositories configuration. You need to use the console to replicate the changes made to a built-in, file-based repository.

• Manage repositories collection
  Use this page to list repositories configured in the system or to select a repository to view or change its configuration properties. We can add or delete external repositories.

• Repository reference settings
  Use this page to configure a repository reference. A repository reference is a single repository containing a set of identity entries referenced by a base entry into the directory information tree.

IdMgrRepositoryConfig (AdminTask)