Software AG Product Suite 10.4 | Setting Up Security | Creating or Editing Internal User Repository Files
 
Creating or Editing Internal User Repository Files
You can create or edit internal user repository files that contain user names and encrypted passwords using the Security Infrastructure Internal User Repository Command Line Tool. Files created with the Internal User Repository Command Line tool can be used with the InternalLoginModule.
Open a command window and go to the Software AG_directory /common/bin directory. To start the tool, use the appropriate command for your operating system from the table below.
System
Command
Windows
internaluserrepo.bat [-f file] [-c] [-p password] [-d|-e] userId
UNIX
./internaluserrepo.sh [-f file] [-c] [-p password] [-d|-e] userId
The following table describes the arguments for the command.
Argument
Description
-h
Print guidelines for using the tool.
-c
Create or edit a text repository file. To create a file named users.txt in the Software AG_directory /common/bin directory, specify -c but not -f. To create a file with a specific name and location, or to modify an existing file, specify - c and -f.
-f file
Location and name of the file to create or modify.
-d userId
Deletes the credentials for the specified user from the file.
-e userId
Change the password for the specified user ID.
userId
If you have a users.txt file in the Software AG_directory /common/bin directory, use this argument without -d or -e to add a new user to the file. User names can contain up to 128 digits, Latin letters, and the characters ! ( ) - . ? [ ] _ ~.
-p password
Password for the specified user ID. Passwords can contain up to 128 digits, Latin letters, and the characters ! ( ) - . ? [ ] _ ~. If you do not specify this argument, the tool will prompt for the password.
The following table describes the appropriate exit code if the command fails.
Exit Code
Description
-1
User ID specified on -e argument not found in the repository file.
1
Password is not set. Specify a password.
2
User ID is too long.
3
User ID contains an invalid character.
4
Password contains an invalid character.
5
Password is too long.
6
Repository file lists more than one version.
7
Repository file lists a version in an unknown format.
8
Repository file does not list any version.
9
User does not have permissions required to create of modify the repository file.
10
User ID not specified on the command.
11
Specified parameters conflict or are invalid.
Copyright © 1999-2019 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release