Display or modify the server features of an instance (feature)

Purpose

View, enable, or disable the server features contained in the /conf/server.xml file of an instance.

When you run tcman.sh feature with no parameters, it displays a list of the features (and their current status) that you can enable or disable. You can also display the status of a single server feature. After viewing the status of a feature, you can use tcman.sh feature to change its setting.

Syntax

tcman.sh feature [general_options] [feature_name[={on|off}]]

Parameters

general_options

Specify one or more of the general TCMAN options. Run tcman.sh help feature to see which general options are appropriate.

feature_name

Specify one of the features defined in an instance's conf/server.xml file. Running tcman.sh feature without feature_name displays a list of all the features.

Enables the named feature.

off

Disables the named feature.

Example

Display the list of server feature settings for acme1, enable AJP13 (Apache JServ Protocol. version 1.3), and verify that the feature is enabled:

$: /psc/acme1/bin/tcman.sh feature
SecurityListener=off
JMXLifecycle=off
PSCRegistry=on
HTTP=onHTTPS=on
AJP13=off
Cluster=off
UserDatabase=on
JAASRealm=off
LDAPRealm=off
PASInstrument=off
RemoteHostValve=on
RemoteAddrValve=onSingleSignOn=on
AccessLog=on
CrawlerSessionManager=on
StuckSessionValve=on

$: /psc/acme1/bin/tcman.sh feature AJP13=on

$: /psc/acme1/bin/tcman.sh feature AJP13
AJP13=on

Notes

Server features for instances are set in $CATALINA_BASE/conf/server.xml. You can change feature status by manually editing this file. However, it is safer to use tcman.sh feature to avoid corrupting the file with erroneous entries.

Run tcman.sh feature when the instance is offline.