FileRegistryCommands

Federated repositories provides a file registry. Use the commands in the FileRegistryCommands command group to administer the file registry using the wsadmin tool.

If the Use global security settings option is selected for the user realm or the Global federated repositories option is selected as the realm type for the specified domain, the user and group management commands are executed on the federated repository of the admin domain. For example, if we run the createUser command for the specified domain, the user is created in the admin domain. However, configuration changes that are performed on the domain are applied to the security domain-specific configuration.

Use the following commands in the FileRegistryCommands group to modify the federated repository file registry:

• addFileRegistryAccount command
• changeFileRegistryAccountPassword command

addFileRegistryAccount command

The addFileRegistryAccount command adds an account to the file registry. We must save the configuration changes after running this command to save the new account to the master repository.

Target object: None

Required parameters:

-userId

ID of the user to add to the file registry. (String, required)

-password

Password of the user to add to the file registry. (String, required)

Optional parameters:

-securityDomainName

Name that uniquely identifies the security domain. If not specified, the command uses the global federated repository. (String, optional)

-parent

Parent of the entity. (String, optional)

.

Return value.

This command returns a message that indicates that the command ran successfully, as the following example displays:

'CWWIM4544I Account newAcct(uid=newAcct,o=defaultWIMFileBasedRealm) is stored in the file registry in the temporary workspace. We must use the "$AdminConfig save" 
command to save it in the master repository.'

Batch mode example usage

• Use Jython string:

  AdminTask.addFileRegistryAccount('[-userId newAcct -password new22password]')
  

Interactive mode example usage

• Use Jython string:

  AdminTask.addFileRegistryAccount(['-userId', 'newAcct', '-password', 'new22password'])
  

changeFileRegistryAccountPassword command

The changeFileRegistryAccountPassword changes the password for the file registry account.

Target object: None.

Required parameters:

-userId

User ID of interest. (String, required)

-password

New password. (String, required)

Optional parameters:

-securityDomainName

Name that uniquely identifies the security domain. If not specified, the command uses the global federated repository. (String, optional)

-uniqueName

Fully-qualified unique name of the administrator. (String, optional)

Return value.

This command returns a message that indicates that the command ran successfully, as the following example displays:

'CWWIM4545I The password is changed for newAcct(uid=newAcct,o=defaultWIMFileBasedRealm)
in the file registry in the temporary workspace. We must use the "$AdminConfig save" 
command to save it in the master repository.'

Batch mode example usage

• Use Jython string:

  AdminTask.changeFileRegistryAccountPassword('[-userId newAcct -password newPassword -uniqueName
  uid=newAcct,o=defaultWIMFileBasedRealm]')
  

Interactive mode example usage

• Use Jython string:

  AdminTask.changeFileRegistryAccountPassword(['-userId', 'newAcct', '-password', 'newPassword',
  '-uniqueName', 'uid=newAcct,o=defaultWIMFileBasedRealm'])
  

Related:

Federated repositories

Configure a single built-in, file-based repository in a new configuration under federated repositories using wsadmin

Set up an entry mapping repository, a property extension repository, or a custom registry database repository using wsadmin commands

IdMgrConfig

IdMgrRepositoryConfig