> Configuration Guide > Silent Mode Configurations

Configuration Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Silent Mode Configurations

This appendix provides information about silent-mode configurations.

 

Running the Configuration Wizard in Silent-Mode

You may create an XML-formatted template that contains your configuration settings and then run the configuration wizard in silent mode so that it uses the template values without requiring you to complete the GUI windows.

To run the configuration wizard in silent-mode, follow these steps:

  1. Create a XML file containing the configuration values for the WLOC component. The name of this file is arbitrary, but the examples shown below use the name silent_config_input.xml.

    2. The XML files are described in the following sections:

    Plain Agent Template XML File
    ESX Agent Template XML File
    Controller Template XML File

  2. Launch the configuration wizard by entering one of the following commands:

    3. On Windows:

    BEA_Home\WLOC_HOME\common\bin\config.cmd -mode=silent -silent_xml=<path>\silent_config_input.xml -log=silent_config.log

    On UNIX or Linux:

    BEA_Home/WLOC_HOME/common/bin/config.sh -mode=silent -silent_xml=<path>/silent_config_input.xml -log=silent_config.log -log_priority=debug

    where <path> is the fully-qualified path to the silent_config_input.xml file.

 

Plain Agent Template XML File

The following XML document can be copied and used to create a silent-mode configuration template for a plain Agent. After copying the document, you must replace the italicized values with the actual values in your environment, as described in Plain Agent Configuration Values. 

<?xml version="1.0" encoding="UTF-8"?>
<domain-template-descriptor>
<input-fields>
  <data-value name="AGENT_DIR" value="c:/bea/user_projects/agent1" />
  <data-value name="Agent.name" value="agent1" />
  <data-value name="Agent.host" value="agent.east.acme.com" />
  <data-value name="Agent.port" value="8001" />
  <data-value name="Agent.securePort" value="8002" />
  <data-value name="Agent.encryption.password" value="changeit" />
  <data-value name="Agent.useSecureConnections" value="Unsecure" />
  <data-value name="Logging.fileSeverity" value="Info" />
  <data-value name="Logging.stdoutSeverity" value="Info" />
  <data-value name="Logging.baseFileName" value="./logs/agent.log" />
  <data-value name="Logging.fileRotationDir" value="./logs/logrotdir" />
  <data-value name="Agent.internalidentity.keystorePassword" value="changeit"/>
  <data-value name="Agent.internaltrust.keystorePassword" value="changeit" />
  <data-value name="Agent.type" value="plainAgent" />
  <data-value name="PlainAgent.name" value="agent1 pool" />
  <data-value name="PlainAgent.description" value="agent1 pool" />
  <data-value name="PlainAgent.cpuCapacity" value="2000" />
  <data-value name="PlainAgent.diskCapacity" value="1024" />
  <data-value name="PlainAgent.stdoutDir" value="./managed-stdout-stderr" />
  <data-value name="PlainAgent.stderrDir" value="./managed-stdout-stderr" />
</input-fields>
</domain-template-descriptor>

Plain Agent Configuration Values

The following table describes the configuration values needed in the Plain Agent template XML file.

Table A-1 Plain Agent Configuration Values
Name
Description
Agent.name
Specify the name of the Agent. 
<data-value name="Agent.name" value="agent1" />
Agent.host
Specify the fully-qualified host name where the Agent resides. 
<data-value name="Agent.host" value="agent.east.acme.com"/>
Agent.port
Specify the Agent’s HTTP port number used when communicating with the Controller in unsecure mode. 
<data-value name="Agent.port" value="8001" />
In the unlikely event you are configuring more than one Agent on the same host, be sure that each Agent uses different port numbers.
Agent.securePort
Specify the Agent’s HTTPS port number used when communicating with the Controller in secure mode. 
<data-value name="Agent.SecurePort" value="8002" />
In the unlikely event you are configuring more than one Agent on the same host, be sure that each Agent uses different port numbers.
Agent.encryption.password
Specify a passphrase used to apply encryption beyond the Security Mode setting to encrypt certain sensitive data passed between the Controller and Agent. The password must be a minimum of 8 characters. This value will be encrypted.
<data-value name="Agent.encryption.password" value="changeit" />
If Security Mode is Unsecure, this setting will still encrypt the most sensitive data.
Agent.useSecureConnections
Specify the security mode to use for connections with the Controller.
Unsecure — sufficient for development.
Secure — should be used for production environments.
<data-value name="Agent.useSecureConnections" value="Unsecure" />
Specifying Secure mode ensures confidentiality and integrity of the communication and requires setting up trust between the Controller and the Agent. For details, see Secure Communications on page 7-4. NOTE: The Controller and all Agents must be set to the same security mode.
Logging.fileSeverity
Specify the severity level of events to log.
<data-value name="Logging.fileSeverity" value="Info" />
In the order of severity from least severe to most severe, the log levels are: TRACE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY
Severity levels are inclusive. When set to INFO, the log will include NOTICE, WARNING, ERROR, CRITICAL, ALERT, and EMERGENCY events.
Logging.stdoutSeverity
Specify the severity level of events that should be written to stdout.
<data-value name="Logging.stdoutSeverity" value="Info" />
Uses same event levels as the log file.
Logging.baseFileName
Specify the log file directory and name.
<data-value name="Logging.baseFileName" value="./logs/Agent.log" />
Logging.fileRotationDir
Specify the log rotation directory.
<data-value name="Logging.fileRotationDir" value="./logs/logrotdir" />
Agent.internalidentity.keystorePassword
Specify the passphrase for the Agent’s internal identity keystore. This value will be encrypted.
<data-value name="Agent.internalidentity.keystorePassword" value="changeit"/>
Agent.internaltrust.keystorePassword
Specify the passphrase for the Agent’s internal trust keystore. This value will be encrypted.
<data-value name="Agent.internaltrust.keystorePassword" value="changeit"/>
Agent.type
Specify plainAgent as the agent type.
<data-value name="Agent.type" value="plainAgent" />
PlainAgent.name
Name of the resource pool managed by the Agent.
<data-value name="PlainAgent.name" value="pool 1" />
PlainAgent.description
An arbitrary description of the resource pool.
<data-value name="PlainAgent.description" value="pool 1" />
PlainAgent.cpuCapacity
CPU capacity (in normalized megahertz) available to the resource pool.
<data-value name="PlainAgent.cpuCapacity" value="2000" />
PlainAgent.diskCapacity
The disk capacity available to the resource pool.
<data-value name="PlainAgent.diskCapacity" value="1024" />
PlainAgent.stdoutDir
Directory for the JVM stdout output stream.
<data-value name="PlainAgent.stdoutDir" value="./managed-stdout-stderr" />
PlainAgent.stderrDir
Directory for the JVM Stderr output stream.
<data-value name="PlainAgent.stderrDir" value="./managed-stdout-stderr" />

 

ESX Agent Template XML File

The following XML document can be copied and used to create a silent-mode configuration template for an ESX Agent. After copying the document, you must replace the italicized values with the actual values in your environment, as described in ESX Agent Configuration Values. 

<?xml version="1.0" encoding="UTF-8"?>
<domain-template-descriptor>
<input-fields>

The following elements are the same as those used for plain agents. For descriptions, see Plain Agent Configuration Values. 

  <data-value name="AGENT_DIR" value="c:bea/user_projects/agent1" />
  <data-value name="Agent.name" value="agent1" />
  <data-value name="Agent.host" value="agent.east.acme.com" />
  <data-value name="Agent.port" value="8001" />
  <data-value name="Agent.securePort" value="8002" />
  <data-value name="Agent.encryption.password" value="changeit" />
  <data-value name="Agent.useSecureConnections" value="Unsecure" />
  <data-value name="Logging.fileSeverity" value="Info" />
  <data-value name="Logging.stdoutSeverity" value="Info" />
  <data-value name="Logging.baseFileName" value="./logs/agent.log" />
  <data-value name="Logging.fileRotationDir" value="./logs/logrotdir" />
<data-value name="Agent.internalidentity.keystorePassword" value="changeit"/>
<data-value name="Agent.internaltrust.keystorePassword" value="changeit" />

The following elements are described in Table A-2. 

<data-value name="Agent.type" value="esxagent" />
<data-value name="EsxAgent.name" value="vmware-agent" />
<data-value name="EsxAgent.description" value="VMWare ESX Information" />
<data-value name="EsxAgent.vcHost" value="acme.rdd.com" />
<data-value name="EsxAgent.username" value="admin66" />
<data-value name="EsxAgent.password" value="dorwssap" />
<data-value name="EsxAgent.vmwarePool.dataCenter" value="datacenter1" />
<data-value name="EsxAgent.vmwarePool.computeResource" value="esxHost.rdd.com" />
<data-value name="EsxAgent.vmwarePool.resourcePool" value="WLOCPool1" />
<data-value name="EsxAgent.vmwarePool.description" value="WLOCPool1" />
<data-group name="vmware-networks">
<data-element name="networks">
<data-element name="VM Network">
<data-value name="ipAddresses" value="10.344.22.86,10.170.43.81"/>
<data-value name="description" value="WLOC VM Network"/>
<data-value name="gateway" value="172.18.128.1"/>
<data-value name="netMask" value="255.255.248.0"/>
<data-value name="dnsServers" value="10.40.0.86,10.40.0.87"/>
<data-value name="domainName" value="acme.com"/>
</data-element>
</data-group>
<data-element name="iso-software">
   <data-value name="name" value="WLSVE9.2.2-ISO"/>
   <data-value name="description" value="WLSVE9.2.2-ISO"/>
   <data-value name="path" value="[SAN-store] wlsve/wlsve922.iso"/>
   <data-value name="version" value="1.1"/> 
</data-element>
<data-element name="nfs-software">
   <data-value name="name" value="bea_home"/>
   <data-value name="description" value="bea_home on NFS"/>
   <data-value name="path" value="172.18.128.67:/LOC/bea/bea.home,uid=55004,gid=10000"/>
   <data-value name="mode" value="EXCLUSIVE"/> 
</data-element></data-group>
</input-fields>
</domain-template-descriptor>

ESX Agent Configuration Values

The following table describes the values needed in the ESX Agent template XML file.

 

Controller Template XML File

The following XML document can be copied and used to create a silent-mode configuration template for a Controller. After copying the document, you must replace the italicized values with the actual values in your environment, as described in Controller Configuration Values. 

<?xml version="1.0" encoding="UTF-8"?>
<!-- Silent config wizard option: -mode=silent -silent_xml=/home/me/silent.xml -->
<domain-template-descriptor> 
<input-fields> 
   <data-value name="CONTROLLER_DIR" value="c:/bea/user_projects/controller" />
   <data-value name="Controller.host" value="adminbox.east.example.com" />
   <data-value name="Controller.console.port" value="9001" />
   <data-value name="Controller.console.securePort" value="9002" />
   <data-value name="Controller.internal.port" value="9003" />
   <data-value name="Controller.internal.securePort" value="9004" />
   <data-value name="Controller.consoleMode" value="BOTH" />
   <data-value name="Controller.useSecureConnections" value="Secure" />
   <data-value name="Logging.fileSeverity" value="Info" />
   <data-value name="Logging.stdoutSeverity" value="Info" />
   <data-value name="Logging.baseFileName" value="./logs/controller.log" />
   <data-value name="Logging.fileRotationDir" value="./logs/logrotdir"/>
   <data-value name="Notification.smtp.enabled" value="true"/>
   <data-value name="Notification.smtp.toAddress" value="WLOC@acme.com"/>
   <data-value name="Notification.smtp.fromAddress" value="WLOCadmin@acme.com"/>
   <data-value name="Notification.smtp.smtpServer" value="smtpserver.acme.com" />
   <data-value name="Notification.jms.enabled" value="true"/>
   <<data-value name="Notification.jms.destinationJndiName" value="LOC_Queue_Notification" />
   <data-value name="Notification.jms.connectionFactoryJndiName" value="LOC_QueueConnectionFactory" /> 
   <data-value name="Notification.jms.jndiProperties.initialFactory" value="weblogic.jndi.WLInitialContextFactory" />
   <data-value name="Notification.jms.jndiProperties.providerUrl" value="iiop://182.76.123.21:9911"/>
   <data-value name="Notification.jms.jndiProperties.securityPrincipal" value="system"/>
   <data-value name="Notification.jms.jndiProperties.password" value="system"/>
   <data-value name="Notification.jmx.enabled" value="true"/>
   <data-value name="Notification.snmp.enabled" value="true"/>
   <data-value name="Notification.snmp.agent.host" value="acme.acme2.com"/>
   <data-value name="Notification.snmp.agent.port" value="2002"/>
   <data-value name="Notification.snmp.trapDestinations.destination.host" value="acme.acme3.com"/>
   <data-value name="Notification.snmp.trapDestinations.destination.port" value="1642"/>   
   <data-value name="Notification.snmp.agent.trapVersion" value="SNMPv2"/>
   <data-group name="agents"> 
     <data-element name="agent"> 
              <data-value name="name" value="agent1"/> 
              <data-value name="host" value="agent.east.acme.com"/> 
              <data-value name="port" value="8001"/> 
              <data-value name="secure-port" value="8002"/> 
              <data-value name="state" value="Enabled"/> 
              <data-value name="password" value="changeit"/> 
            </data-element>
   </data-group>
   <data-value name="LoginInfo.username" value="WLOCBootUser" />
   <data-value name="LoginInfo.password" value="changeit" />
   <data-value name="Controller.demoidentity.keystorePassword" value="changeit" />
   <data-value name="Controller.internalidentity.keystorePassword" value="changeit" />
   <data-value name="Controller.internaltrust.keystorePassword" value="changeit" />
   <data-value name="Controller.publicKeyFile" value=".keys/id_rsa.pub" />
   </input-fields> 
</domain-template-descriptor>

Controller Configuration Values

The following table describes the values needed in the Controller template XML file.

Table A-3 Controller Configuration Values
Name
Description
CONTROLLER_DIR
Complete path to the Controller directory. 
<data-value name="CONTROLLER_DIR" value="c:/bea/user_projects/controller" />
Controller.host
Fully-qualified host name of the Controller machine. 
<data-value name="Controller.host" value="adminbox.east.example.com" />
Controller.console.port
HTTP port for the WLOC Administration Console
<data-value name="Controller.console.port" value="9001" />
Controller.console.securePort
HTTPS port for the WLOC Administration Console.
<data-value name="Controller.console.securePort" value="9002" />
Controller.internal.port
Port used by agents for unsecure internal communication with the Controller.
<data-value name="Controller.internal.port" value="9003" />
Controller.internal.securePort
Port used by agents for secure internal communication with the Controller.
<data-value name="Controller.internal.securePort" value="9004" />
Controller.consoleMode
Enter Secure (HTTPS), Unsecure (HTTP), or Both (both HTTP & HTTPS) to specify how clients may connect to the administration console:
<data-value name="Controller.consoleMode" value="BOTH" />
Controller.useSecureConnections
Select one of the following to specify the security level to be used for internal communications between WLOC components.
Unsecure—HTTP without SSL and guarantee of confidentiality and integrity.
Secure— HTTPS providing message confidentiality and integrity.
NOTE: All Agents must use the same Security mode established on the Controller with which they communicate.
<data-value name="Controller.useSecureConnections" value="Secure" />
Logging.fileSeverity

Level of events to log. In order of severity from least to most severe, log levels are: TRACE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY

<data-value name="Logging.fileSeverity" value="Info" />
Logging.stdoutSeverity
Level of events to write to stdout. Uses same event levels as the log file.
<data-value name="Logging.stdoutSeverity" value="Info" />
Logging.baseFileName
Log file and directory relative to the Controller directory.
<data-value name="Logging.baseFileName" value="./logs/controller.log" />
Logging.fileRotationDir
Rotation directory for controller logs.
<data-value name="Logging.fileRotationDir" value="./logs/logrotdir" />
Notification.smtp.enabled
Specify true to enable SMTP notification; otherwise, specify false.
<data-value name="Notification.smtp.enabled" value="true"/>
Notification.smtp.fromAddress
E-mail address from which notifications should be sent.
<data-value name="Notification.smtp.fromAddress" value="WLOCadmin@acme.com"/>
Notification.smtp.toAddress
E-mail address to which notifications should be sent.
<data-value name="Notification.smtp.toAddress" value="WLOC@acme.com"/>
Notification.smtp.smtpServer
SMTP mail server through which to send notifications.
<data-value name="Notification.smtp.smtpServer" value="smtpserver.acme.com" />
Notification.jms.enabled
Specify true to enable JMS notification; otherwise, specify false.
<data-value name="Notification.jms.enabled" value="false"/>
Notification.jms.destinationJndiName
Destination JNDI name.
<data-value name="Notification.jms.destinationJndiName" value="LOC_Queue_Notification" />
Notification.jms.connectionFactoryJndiName
Name of the JNDI connection factory.
<data-value name="Notification.jms.connectionFactoryJndiName" value="LOC_QueueConnectionFactory" />
Notification.jms.jndiProperties.initialFactory
Fully-qualified package and class of the initial factory.
<data-value name="Notification.jms.jndiProperties.initialFactory" value="weblogic.jndi.WLInitialContextFactory" />
Notification.jms.jndiProperties.providerUrl
JNDI provider URL.
<data-value name="Notification.jms.jndiProperties.providerUrl" value="iiop://172.18.134.173:9901"/>
Notification.jms.jndiProperties.securityPrincipal
JNDI user name.
<data-value name="Notification.jms.jndiProperties.securityPrincipal" value="system"/>
Notification.jms.jndiProperties.password
JNDI user’s password.
<data-value name="Notification.jms.jndiProperties.password" value="system"/>
Notification.jmx.enabled
Specify true to enable JMX notification; otherwise, specify false.
<data-value name="Notification.jmx.enabled" value="true"/>
Notification.snmp.enabled
Specify true to enable SNMP notification; otherwise, specify false.
<data-value name="Notification.snmp.enabled" value="true"/>
Notification.snmp.agent.host
Hostname of the SNMP agent.
<data-value name="Notification.snmp.agent.host" value="acme.acme2.com"/>
Notification.snmp.agent.port
Port number of the SNMP agent.
<data-value name="Notification.snmp.agent.port" value="2002"/>
Notification.snmp.trapDestinations.destination.host
DNS name or IP address of SNMP manager machine.
<data-value name="Notification.snmp.trapDestinations.destination.host" value="acme.acme3.com"/>
Notification.snmp.trapDestinations.destination.port
Listening port of the SNMP manager.
<data-value name="Notification.snmp.trapDestinations.destination.port" value="162"/>
Notification.snmp.agent.trapVersion
SNMP version (SNMPv1 or SNMPv2)
<data-value name="Notification.snmp.agent.trapVersion" value="SNMPv2"/>
Agent Information
‘<data-element name="agent">
Use one or more instances of the XML structure below to define each Agent. This structure must be encapsulated under the <data-group name="agents"> element.
Where:
name — Agent name.
host — Fully-qualified host name or IP address of the Agent machine.
port — HTTP port on which to access the Agent.
secure_port — HTTPS port on which to access the Agent.
state — One of Enabled, Connected, or Disconnected.
password — Agent’s current passphrase. Communication between the Controller and Agent will fail unless the entry matches the Agent’s current passphrase.
Example:
<data-group name="agents">
<data-element name="agent">
    <data-value name="name" value="agent1"/>
    <data-value name="host" value="123.54.432.99"/>
   <data-value name="port" value="8001"/>
    <data-value name="secure-port" value="8002"/>
    <data-value name="state" value="Enabled"/>
    <data-value name="password" value="changeit"/>
    </data-element>
   </data-group>
LoginInfo.username
The username for logging into the Administration Console.
<data-value name="LoginInfo.username" value="WLOCBootUser" />
LoginInfo.password
The password for the above user.
<data-value name="LoginInfo.password" value="changeit" />
Controller.demoidentity.keystorePassword
The Controller identity keystore password used for connections to the console.
<data-value name="Controller.demoidentity.keystorePassword" value="changeit" />
Controller.internalidentity.keystorePassword
The Controller internal identity keystore password.
<data-value name="Controller.internalidentity.keystorePassword" value="changeit" />
Controller.internaltrust.keystorePassword
The Controller identity trust keystore password.
<data-value name="Controller.internaltrust.keystorePassword" value="changeit" />
Controller.publicKeyFile
The path and name of the SSH public key file to be passed to Agents that are creating LVM instances with SSH enabled.
<data-value name="Controller.publicKeyFile" value="C:/sshKey/id_rsa.pub" />


  Back to Top       Previous  Next