Application Integration (On-Premises) : Administering the Software AG Infrastructure : Setting Up Security : Create or Edit Internal User Repository Files
Create or Edit 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. Start the tool using the appropriate command below.
System
Command
Windows
internaluserrepo.bat [-f file] [-c] [-d | -e] user_Id [-p password]
UNIX
./internaluserrepo.sh [-f file] [-c] [-d | -e] user_Id [-p password]
The arguments for the command are described below.
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 user_Id
Deletes the credentials for the specified user from the file.
-e user_Id
Change the password for the specified user ID.
user_Id
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.
If the command fails, the tool returns the appropriate exit code.
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 © 2015- 2017 Software AG, Darmstadt, Germany. (Innovation Release)

Product LogoContact Support   |   Community   |   Feedback