Delete Users Command
Use the deleteusers
command to upload a JSON file containing a list of users that you want to delete from a specific server instance.
You run the utility through a launcher script, datamodel.sh
on Linux and datamodel.cmd
on Windows.
If the domain is installed in default folder then the location of the launcher script looks like the following:
Oracle_Home/user_projects/domains/Domain_Name/bitools/bin/datamodel.sh
or datamodel.cmd
on Windows
If the client install doesn't have domain names, the launcher script location is as follows:
Oracle_Home\bi\bitools\bin\datamodel.cmd
See What You Need to Know Before Using the Command and Overview of User and Application Role Commands.
Syntax
The deleteusers
command takes the following parameters:
deleteusers -T usernames.json [-L plugin list] -SI service_instance-U cred_username[-P cred_password] [-S hostname] [-N port_number] [-SSL] [-H]
Where
T
specifies the name of the JSON input file containing the users to be deleted from the server instance. See the syntax in Create a JSON Delete Users Input File for information about the correct syntax for the application role input file.
L
specifies a single plugin to run or to reverse the default plugin processing order. The plugins determine where the system applies the updates: to the repository, the Oracle BI Presentation Catalog, or both.
The following options are for L
:
-
RPD
: Specify this option to delete users in the repository, only. -
WEBCAT
: Specify this option to delete users in the Oracle BI Presentation Catalog. For example, you must use the-L WEBCAT
option when deleting users from the Oracle BI Presentation Catalog. -
WEBCAT,RPD
: Specify this option to reverse the default plugin run order. The default plugin run order is repository (RPD) and then Oracle BI Presentation Catalog (WEBCAT). -
Omit this option to run the plugins in their default order, which is repository (RPD) then Oracle BI Presentation Catalog (WEBCAT).
SI
specifies the name of the service instance.
U
specifies a valid user's name to be used for authentication.
P
specifies the password corresponding to the user's name that you specified for U
. If you don't supply the password, then you're prompted for the password when the command is run. Oracle recommends that you include a password in the command only if you're using automated scripting to run the command.
S
specifies the host name. Only include this option when you're running the command from a client installation.
N
specifies the port number. Only include this option when you're running the command from a client installation.
SSL
specifies to use SSL to connect to the Oracle WebLogic Server to run the command. Only include this option when you're running the command from a client installation.
H
displays the usage information and exits the command. Use -H
or run .sh
without any parameters to display the help content.
Example
data-model-cmd.sh deleteusers -T usernames.json -SI bi -U weblogic -P password -S server1.us.example.com -N 777 -SSL
Create a JSON Delete Users Input File
Use the following syntax to create the JSON delete users input file.
{
"Title":"Target Users",
"Users":[
{ "name":"<user1>" },
{ "name":"<user2>" },
{ "name":"<user3>" }
]
}