mpsadmconfig(1M)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | TASKS | EXAMPLES | EXIT STATUS | ATTRIBUTES | NOTES | SEE ALSO
NAME
- mpsadmconfig– configure Administration
Server
SYNOPSIS
-
/usr/sbin/mpsadmconfig [options] subcommand [args] [subcommand-args...]
DESCRIPTION
The mpsadmconfig command provides a single command-line tool to configure Administration Server.
OPTIONS
- -con[tinueOnError]
-
Finishes any remaining tasks, even when an error occurs. The default behavior is to quit when any task fails, without running the remaining tasks.
- -enc[ryption]
-
Uses encrypted HTTP (HTTPS) to connect to the server. The default protocol is HTTP.
- -h[elp] [task]
-
Displays general usage information. To display the usage information for a particular task, specify the task as the argument to -h without the leading hyphen, for example, -hrestart.
- -i[nputFile] filename
-
Reads options and tasks from the specified file. You can specify additional options on the command line. If an option is present on the command line and in the specified file, the command-line settings are used. If the -inputFile option is present in the specified file, it is ignored to prevent mpsadmconfig from reading multiple sets of options.
- -ser[ver] [host] : port
-
Connects to the server on the specified host and port. If no host is specified, the local host is used. The server port number (preceded by a colon) is required.
- -u[ser] [uid] : [pwd]
-
Connects to the server using the specified username and password. If a user name is not specified, you are prompted for the current user's password. The password appears on screen when it is typed, so if security is a concern, use the -inputFile option and list the user name and password in a file with suitable permissions. Note that if the -user option is specified, then, at a minimum, the colon must be specified. If the -user option is not specified, the user is prompted for both the user name and password.
- -verb[ose] [0-9]
-
Sets the level of screen output (9=full output, 0=no output). The default level is 5.
- -vers[ion]
-
Displays the version and copyright information.
The following options are supported:
The [options] can be specified using the terse single character form such as -u if applicable, or they can be specified using the longer but more descriptive form such as -user. The complete option name need not be specified. For example, -us will work just as well as -user. The option name must be specified so that it is not ambiguous among other [options] or the tasks described in the following section.
Note that [options] are not case sensitive. Thus, -USER and -User are both accepted as the -user option.
Multiple tasks can be run from the same invocation of mpsadmconfig. Tasks specified in an input file are run first. Tasks are run in the order specified in the input file and on the command line.
TASKS
- -countA[ccessLogEntries]
-
Counts the number of entries in the access log file. Run this task before -viewAccessLogEntries to determine the number of entries in the access log.
- -viewA[ccessLogEntries]
-
Lets you view the specified entries in the access log file.
- -countE[rrorLogEntries]
-
Counts the number of entries in the error log file. Run this task prior to -viewErrorLogEntries to determine the number of entries in the error log.
- -viewE[rrorLogEntries]
-
Lets you view the specified entries in the error log file.
- -enableE[ndUserAccess]
-
End user access to the Administration Server has been removed from Administration Server 5.2.
- -disableE[ndUserAccess]
-
End user access to the Administration Server has been removed from Administration Server 5.2.
- -getAc[cessLog]
-
Retrieves the path for the access log file for this instance of Administration Server.
- -setAc[cessLog]
-
Specifies the path for the access log file for this instance of Administration Server.
- -getAdd[ressess]
-
Lets you view the IP addresses from which connections are allowed.
- -setAdd[ressess]
-
Specifies the IP addresses from which connections are allowed.
- -getAdminUI[D]
-
Retrieves the Administration Server administrator's user name.
- -setAdminUI[D]
-
Specifies the Administration Server administrator's user name.
- -setAdminP[wd]
-
Specifies the Administration Server administrator's password.
- -getAdminUs[ers]
-
Retrieves the path of the adminusers file.
- -setAdminUs[ers]
-
Specifies the path of the adminusers file.
- -getCa[cheLifetime]
-
Displays the period of time for which a user authentication is cached.
- -setCa[cheLifetime]
-
Specifies the period of time to cache a user authentication.
- -getCl[assname]
-
Retrieves the Java classname for this instance of Administration Server.
- -setCl[assname]
-
Enables you to set a new Java classname for this instance of Administration Server.
- -getDe[faultAcceptLanguage]
-
Displays the default language for this instance of Administration Server.
- -setDe[faultAcceptLanguage]
-
Specifies the default language for this instance of Administration Server.
- -getDS[Config]
-
Retrieves the current LDAP server host, port, and base DN, and identifies whether the LDAP server is running SSL.
- -setDS[Config]
-
Specifies the LDAP server host, port, and base DN, and specifies whether the LDAP server is running SSL.
- -getE[rrorLog]
-
Retrieves the path for the server error log file.
- -setE[rrorLog]
-
Specifies the path for the server error log file.
- -getH[osts]
-
Lets you view the host names from which connections are allowed.
- -setH[osts]
-
Specifies the host names from which connections are allowed.
- -getO[neACLDir]
-
Retrieves the path for the ACL folder.
- -setO[neACLDir]
-
Specifies the path for the ACL folder.
- -getPo[rt]
-
Lets you view the port number that this instance of Administration Server is using.
- -setPo[rt]
-
Specifies the port number that this instance of Administration Server should use.
- -getSe[rverAddress]
-
Retrieves the IP address of this instance of Administration Server.
- -setSe[rverAddress]
-
Specifies the IP address that this instance of Administration Server should use.
- -getSy[ystemUser]
-
Retrieves the UNIX user name that this instance of Administration Server runs as.
- -setSy[ystemUser]
-
Specifies the UNIX user name that this instance of Administration Server should run as.
- -getU[GDSConfig]
-
Retrieves the current user and group LDAP server information, including the host, port, base DN, and authentication DN.
- -setU[GDSConfig]
-
Specifies the host, port, base DN, authentication DN, and authentication password for the instance of Directory Server containing the user and group directory. You can invoke -setUGDSConfig either with or without arguments. If you invoke this task without any arguments, the Directory Server configuration is reset to the installation defaults.
- -r[estart]
-
Restarts this instance of Administration Server.
- -st[op]
-
Stops this instance of Administration Server.
The following tasks are supported:
The task to be done can be specified using the abbreviated name such as -r for restarting the server or using the complete name -restart. The task name must be specified so that it is not ambiguous among other tasks or the [options] described previously. The task keywords are also case-insensitive, so both -RESTART and -Restart are accepted as the -restart task.
Multiple tasks can be run from the same invocation of mpsadmconfig. Tasks specified in an input file are run first. Tasks are run in the order specified in the input file and on the command line.
EXAMPLES
Example 1 Changing the port number
The following example changes the port number to 33333 and restarts Administration Server. Note that the verbose level will be set to 5.
% mpsadmconfig -server eastcoast.example.com:22222 -user phlee:password
-verbose 5 -setPort 33333 -restart
Example 2 Retrieving host information
The following example retrieves the hosts from which connections are allowed. Note that the verbose level will be set to 9.
% mpsadmconfig -server eastcoast.example.com:33333 -u phlee:password -verb 9 -geth
Example 3 Displaying the help
The following example displays the help information for restarting Administration Server.
% mpsadmconfig -h restart
EXIT STATUS
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|---|---|
| Availability | SUNWasvu |
| Stability Level | Obsolete |
NOTES
End user access has been removed from Administration Server 5.2.
SEE ALSO
mpsadmserver(1m), mpsconsole(1m), directoryserver(1m)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | TASKS | EXAMPLES | EXIT STATUS | ATTRIBUTES | NOTES | SEE ALSO
- © 2010, Oracle Corporation and/or its affiliates