FileRegistryCommands (AdminTask)

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

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 you 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

Add an account to the file registry. Save changes after running to save the new account to the master file registry.xml.

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	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.

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

Batch mode example

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

Interactive mode

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

changeFileRegistryAccountPassword command

Change 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.'

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

Interactive mode

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

Related concepts

Federated repositories

Related tasks

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 (AdminTask)

IdMgrRepositoryConfig (AdminTask)