InfoCenter Home >
6: Administer applications >
6.6: Tools and resources quick reference >
6.6.46: Administering WebSphere administrative servers (overview) >
6.6.46.0: Administrative server configuration file properties
6.6.46.0: Administrative server configuration file properties
The admin.config file is located in:
product_installation_root/bin/admin.config
Directives in admin.config are similar to their counterparts
on the Java command line for the administrative
server. The command line argument name is appended to a
standard package name for the administrative server. For example,
the command line argument:
-lsdPort
becomes
com.ibm.ejs.sm.adminServer.lsdPort
in admin.config.
Some admin.config file properties are platform specific.
Review your admin.config file to see which properties appear in your installation.
Click any property in the table for a description of that property.
Platform specific properties are identified by an icon.
Administrative server and database settings
- com.ibm.ejs.sm.adminServer.adminDomain
- The logical name specified for the WebSphere administrative domain.
- com.ibm.ejs.sm.adminServer.adminDomain.bootstrap
- The description is unavailable at this time.
- com.ibm.ejs.sm.adminServer.agentMode
- Whether this administrative server should run as a full administrative server (false), or
in administrative server agent mode (true).
- com.ibm.ejs.sm.adminServer.bootstrapHost
- Fully qualified host name of the machine containing the administrative server
- com.ibm.ejs.sm.adminServer.bootstrapPort
- Port number for the administrative server. See also the information about
administering ports.
- com.ibm.ejs.sm.adminserver.classpath
- Values for the administrative server classpath, such as:
d\:/WebSphere/AppServer/properties;
d\:/WebSphere/AppServer/lib/bootstrap.jar
- com.ibm.ejs.sm.adminServer.connectionPoolsize
- The number of concurrent database connections to allow from the administrative server
to the administrative database. The default value is 5.
- com.ibm.ejs.sm.adminServer.connectionProperties
- Use this property to pass arguments into setConnectionProperties() for the WebSphere
administrative server Java process.
For example, if using Sybase as the administrative database, you can set
CHARSET_CONVERTER_CLASS=com.sybase.jdbc2.utils.TruncationConverter
to prevent exceptions such as this one when performing a dataSource.getConnection() call:
java.io.IOException: JZ0I6: An error occurred converting UNICODE to the
charset used by the server. Error message: java.io.CharConversionException:
java.io.UnsupportedEncodingException: hp-roman8
Set additional connectionProperties by specifying them using the same pattern,
separated by commas: PROPERTY_NAME=value;PROPERTY_NAME=value; ...
- com.ibm.ejs.sm.adminServer.createTables
- Whether to create the administrative database tables the next time you start the
administrative server (typically, the first time you start the administrative server
after product installation).
By default, this flag is initially set to true. The
first time you run the administrative server, the administrative server creates the
database table or tables that it needs to store administrative data. It sets this
flag to false.
See the information about administering administrative
servers for additional discussion of this setting.
In Version 3.5, this setting is called com.ibm.ejs.sm.adminServer.dbInitialized.
- com.ibm.ejs.sm.adminServer.dbdataSourceClassName
- The data source corresponding to the administrative database.
COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource
- com.ibm.ejs.sm.adminServer.dbpassword
- The password for the administrative database
- com.ibm.ejs.sm.adminServer.dbSchema
- The database schema for the administrative database
- Data source properties - com.ibm.ejs.sm.adminServer.dbUrl
- What was called com.ibm.ejs.sm.adminServer.dbUrl in Version 3.5 is replaced by
specific data source properties for each database
brand, including a dbUrl property for certain brands.
- com.ibm.ejs.sm.adminServer.dbuser
- The administrative database user ID, such as db2user
- com.ibm.ejs.sm.adminServer.diagThreadPort
- The port on which DrAdmin listens
- com.ibm.ejs.sm.adminServer.disableAutoServerStart
- Whether to disable the feature that tries to start the application servers on an administrative
node when the administrative node is started.
- true - start the administrative server, but not any of the application servers on it
- false - when the administrative server is started, try to start the application servers
whose administrative settings indicate they should be started
- com.ibm.ejs.sm.adminServer.disablePMI
- Whether to disable the performance monitoring classes, to avoid collecting
performance data when it is not needed.
- true - disable PMI classes
- false
This disablePMI setting was called disableEPM in Version 3.5.x.
- com.ibm.ejs.sm.adminServer.earFile
- The full path to a file containing configuration data for starting the administrative
server, and product in general.
-
- com.ibm.ejs.sm.adminServer.jarFile
- Paths to the JAR files required by the administrative server, such as:
product_installation_root/lib/repository.jar;
product_installation_root/lib/tasks.jar
- com.ibm.ejs.sm.adminServer.logFile
- The log files for recording administrative server events, such as:
product_installation_root/tranlog/your_server_name_tranlog1,
product_installation_root/tranlog/your_server_name_tranlog2
- com.ibm.ejs.sm.adminServer.lsdHost
- The host name of the administrative server
- com.ibm.ejs.sm.adminServer.lsdPort
- Port number for the administrative server Location Service Daemon (LSD).
See also the information about administering ports.
- com.ibm.ejs.sm.adminServer.managedServerClassPath
- Used by the application server
com.ibm.ejs.sm.adminServer.nannyPort
- The port on which the nanny process listens
com.ibm.ejs.sm.adminServer.processPriority
- Possible values are:
- 24 for Solaris
- 28 for AIX
com.ibm.ejs.sm.util.process.Nanny.adminServerJvmArgs
- JVM arguments for the nanny process
com.ibm.ejs.sm.util.process.Nanny.path
- Classpath for the nanny process, such as:
product_installation_root\bin;
product_installation_root\SQLLIB\bin;
product_installation_root\SQLLIB\\function;
product_installation_root\jdk\bin
- com.ibm.CORBA.ConfigURL
- The path to the file specifying ORB configuration values, such as:
file\:/product_installation_root/properties/sas.server.props
- com.ibm.CORBA.locaterequestTimeout=200
- The amount of time an ORB waits for the Location Service Daemon to send a reply
to a locate request that was sent by the ORB. The value 200 equals 3.2 minutes.
If your network processes slowly, specify a large value
to prevent timeouts. If you specify a value that is too small, timeouts might occur
before a response is received. Be careful in selecting a value; this property has
no recommended value. Set a value only if you suspect that the administrative
server is experiencing problems with timeouts. This property was added in
Version 4.04.
- com.ibm.websphere.preconfiguredCustomServices
- Path to a file containing definitions for
Custom Services that are to be preconfigured on every
application server defined in the domain.
- com.ibm.CORBA.requestTimeout=200
- The amount of time an ORB waits for a reply to a request. The value 200
equals 3.2 minutes. If your network processes slowly, specify a large value
to prevent timeouts. If you specify a value that is too small, timeouts might occur
before a response is received. Be careful in selecting a value; this property has
no recommended value. Set a value only if you suspect that the administrative
server is experiencing problems with timeouts. This property was added in
Version 4.04.
- com.ibm.CORBA.ServerSocketQueueDepth
-
The ServerSocket maximum queue
depth. Specify an integer greater than 50. Values less than 50 or invalid
integer values will cause a warning to be logged to the message file and the
default value of 50 to be used.
This property allows the ServerSocket maximum queue depth to be increased beyond
its default value of 50. The default value is according to the JDK122
javadoc for java.net.ServerSocket.
The ServerSocket queue is where
incoming socket connection requests from clients are held until the server can
accept the request. When the queue becomes full, other open socket requests from
clients are rejected with a java.net.ConnectException. This exception will be
returned to the client application. If clients are receiving java.net.ConnectExceptions,
it is an indication that you should consider increasing the queue depth.
Note, some operating systems impose other limitations on the server socket
queue depth. Become familiar with the guidelines imposed by your operating system.
Setting this property to a value beyond the platform-imposed limitation will
likely not have any effect.
- install.initial.config
- If set to true, attempts to create the default resources (such as the default application
server) the next time you start the product administrative server.
For Version 4.0, you need to set both this setting and com.ibm.ejs.adminServer.createTables to
true if you have dropped your WebSphere administrative database tables and need to create them again. This
is a change from Version 3.5, in which you needed only to reset this setting. See the information
about administrative servers for more information.
- server.root
- See the installation root reference for the default values.
- com.ibm.ejs.sm.adminServer.seriousEventLogSize
- The number of entries to record in the serious events log. Allowing the log to grow too large
can affect performance negatively. The default value is 1000 entries.
com.ibm.ejs.sm.util.process.Nanny.errtraceFile
- The trace file for the nanny process, such as:
product_installation_root\logs\adminserver_stderr.log
- com.ibm.ejs.sm.adminServer.qualifyHomeName
- This value can be:
- install.initial.config.file
- The full path to the property file defining the default configuration, such as:
product_installation_root/properties/initial_setup.config
- com.ibm.ejs.sm.adminServer.traceString
- The trace specification for the administrative server. See the trace property
reference for a description.
- com.ibm.ejs.sm.adminServer.traceOutput
- The trace output file for the administrative server. See the trace property
reference for a description.
com.ibm.ejs.sm.util.process.Nanny.traceFile
- The trace file for the nanny process, such as:
product_installation_root/logs/nanny.trace
com.ibm.ejs.sm.util.process.Nanny.maxtries
- How many time the nanny process should attempt to start the administrative server before giving up.
The default is 3.
- com.ibm.ws.jdk.path
-
The path to the root directory of the JDK installed with the product, such as:
product_installation_root/jdk
- com.ibm.websphere.naming.db.retrycount
- The number of retries for naming operations that fail as a result of a stale database connection.
com.ibm.websphere.naming.db.retrycount=2 is the default. This property is valid in WebSphere Application Server Version 4.0.6 only.
- com.ibm.websphere.naming.db.retrydelay
- The amount of delay, in milliseconds, between retries for naming operations that fail as a result of a stale database connection.
com.ibm.websphere.naming.db.retrydelay=2000 is the default. This property is valid in WebSphere Application Server Version 4.0.6 only.
|
|