80 lines
5.8 KiB
HTML
80 lines
5.8 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
|
|
|
|
<title>Manage substitution variables with the administrative console</title>
|
|
</head>
|
|
|
|
<BODY>
|
|
<!-- Java sync-link -->
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
|
|
|
<h3><a name="acvar"></a>Manage substitution variables with the administrative console</h3>
|
|
|
|
|
|
<p>In WebSphere Application Server - Express, you can use substitution variables to represent values in configuration files. For example, the variable LOG_ROOT represents the value /QIBM/UserData/WebASE51/ASE/<em>instance</em>/logs, where <em>instance</em> is the name of your instance. To change the location of the log files for your instance, change the value of the LOG_ROOT variable to the new path.</p>
|
|
|
|
<ul>
|
|
<li><p>You can define variables for the cell, node, and server scopes. A variable applies to all configuration files in the scope for which it is defined. For example, WebSphere Application Server - Express defines the APP_INSTALL_ROOT variable for the node scope. The value defined for the node applies to all application servers within that node. If variables in multiple scopes have the same name, the variable with the narrowest scope takes precedence. For example, if you have two application servers, called myServer1 and myServer2, you can define APP_INSTALL_ROOT at the server level for each application server. If you define a separate APP_INSTALL_ROOT variable for myserver1, but not for myServer2, this is how WebSphere Application Server resolves the values:</p>
|
|
<ol>
|
|
<li>For myServer1, configuration files use the value defined for the server scope.</li>
|
|
<li>For myServer2, APP_INSTALL_ROOT is not defined for the server scope. As a result, configuration files for myServer2 use the value defined for the node scope.</li>
|
|
</ol><p></p></li>
|
|
<li><p>You can also use WebSphere variables to modify the daemon configuration. To designate a variable specifically for a daemon, append a server custom property onto a daemon tag. Specify DAEMON_<em>server_custom_property</em> in the <strong>Name</strong> field. For example, if you specify DAEMON_ras_trace_outputlocation in the <strong>Name</strong> field and SYSOUT in the <strong>Value</strong> field, that daemon's trace output is directed to SYSPRINT.</p></li>
|
|
<li><p>WebSphere variables support substitution. You can use a variable name as part of the value of another variable. For example, if you specify ${<em>variable_name</em>} in the <strong>Name</strong> field, the value of <em>variable_name</em> is the name of the new variable. For example ${JAVA_HOME} creates a WebSphere variable with a name that is equal to the Java home directory.</p></li>
|
|
<li><p>WebSphere Application Server uses internal variables. The application server uses these variables for its own purposes. The prefixes for internal variables are WAS_DAEMON_<em>server custom property</em>, WAS_DAEMON_ONLY_<em>server custom property</em>, and WAS_SERVER_ONLY_<em>server custom property</em>. Variables that include these prefixes are reserved for use by the server runtime. Do not modify these variables.</p></li>
|
|
</ul>
|
|
|
|
<p>For instructions on adminstering substitution variables, see these sections:</p>
|
|
<ul>
|
|
<li><a href="#create">Create substitution variables</a></li>
|
|
<li><a href="#modify">Modify substitution variables</a></li>
|
|
<li><a href="#remove">Remove substitution variables</a></li>
|
|
</ul>
|
|
|
|
<p><strong><a name="create"></a>Create substitution variables</strong></p>
|
|
|
|
<p>To add a new substitution variable, follow these steps:</p>
|
|
|
|
<ol>
|
|
<li><a href="acstart.htm">Start the WebSphere administrative console</a>.</li>
|
|
<li>In the topology tree, expand <strong>Environment</strong> and click <strong>Manage WebSphere Variables</strong>.</li>
|
|
<li>On the <strong>WebSphere Variables</strong> page, specify the scope for which you want to define the variable and click <strong>Apply</strong>.</li>
|
|
<li>Click <strong>New</strong>.</li>
|
|
<li>Specify a name and value for the variable.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
<li><a href="acsave.htm">Save the configuration</a>.</li>
|
|
</ol>
|
|
|
|
<p><strong><a name="modify"></a>Modify substitution variables</strong></p>
|
|
|
|
<p>To modify a substitution variable, follow these steps:</p>
|
|
|
|
<ol>
|
|
<li><a href="acstart.htm">Start the WebSphere administrative console</a>.</li>
|
|
<li>In the topology tree, expand <strong>Environment</strong> and click <strong>Manage WebSphere Variables</strong>.</li>
|
|
<li>On the <strong>WebSphere Variables</strong> page, specify the scope that contains the variable that you want to modify and click <strong>Apply</strong>.</li>
|
|
<li>Click the name of the variable that you want to modify.</li>
|
|
<li>Make your changes.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
<li><a href="acsave.htm">Save the configuration</a>.</li>
|
|
</ol>
|
|
|
|
<p><strong><a name="remove"></a>Remove substitution variables</strong></p>
|
|
|
|
<p>To remove a substitution variable, follow these steps:</p>
|
|
|
|
<ol>
|
|
<li><a href="acstart.htm">Start the WebSphere administrative console</a>.</li>
|
|
<li>In the topology tree, expand <strong>Environment</strong> and click <strong>Manage WebSphere Variables</strong>.</li>
|
|
<li>On the <strong>WebSphere Variables</strong> page, specify the scope that contains the variable that you want to remove and click <strong>Apply</strong>.</li>
|
|
<li>Select the checkbox for the variable that you want to remove.</li>
|
|
<li>Click <strong>Delete</strong>.</li>
|
|
<li><a href="acsave.htm">Save the configuration</a>.</li>
|
|
</ol>
|
|
|
|
<p>You can also use wsadmin to manage substitution variables for your appliation server instance. See <a href="wsavar.htm">Use wsadmin to manage substitution variables</a> for information.</p>
|
|
</body>
|
|
</html> |