bea.com | products | dev2dev | support | askBEA
 Download Docs   Site Map   Glossary 
Search
e-docs > WebLogic Server > WebLogic Server Configuration Reference > WTCRemoteTuxDom

WebLogic Server Configuration Reference

 Previous Next Contents Index View as PDF  

WTCRemoteTuxDom

Description

This interface provides access to the WTC remote Tuxedo Domain configuration attributes. The methods defined herein are applicable for WTC configuration at the WLS domain level.

Syntax

<!ELEMENT WTCRemoteTuxDom EMPTY >
<!ATTLIST WTCRemoteTuxDom
   AccessPoint                CDATA                    #REQUIRED
   AccessPointId              CDATA                    #REQUIRED
   AclPolicy                  (GLOBAL | LOCAL)         "LOCAL"
   CmpLimit                   CDATA                    "2147483647"
   ConnPrincipalName          CDATA                    #IMPLIED
   ConnectionPolicy           (ON_DEMAND | 
                               ON_STARTUP | 
                               INCOMING_ONLY | LOCAL)  "ON_DEMAND"
   CredentialPolicy           (GLOBAL | LOCAL)         "LOCAL"
   FederationName             CDATA                    #IMPLIED
   FederationURL              CDATA                    #IMPLIED
   LocalAccessPoint           CDATA                    #REQUIRED
   MaxEncryptBits             (0 | 40 | 56 | 128)      "128"
   MaxRetries                 CDATA                    "-1"
   MinEncryptBits             (0 | 40 | 56 | 128)      "0"
   NWAddr                     CDATA                    #REQUIRED
   Name                       CDATA                    #REQUIRED
   Notes                      CDATA                    #IMPLIED
   RetryInterval              CDATA                    "-1"
   TpUsrFile                  CDATA                    #IMPLIED
>

Parent Elements

The WTCRemoteTuxDom element is a child of the WTCServer element.

Attributes

Table 87-1 WTCRemoteTuxDomMBean Element Attributes

Attribute

Description

Range of Values and Default

Console Label

Access-Point

Defines a unique name within the scope of MBean types WTCLocalTuxDom and WTCRemoteTuxDom used to identify the access point or domain.


Access Point

Access-Point-Id

Defines the domain access point identifier. This identifier is unique across all local and remote domain access points.


Access Point Id

Acl-Policy

Defines the inbound access control list (ACL) policy toward requests from a remote domain.

  • If Interoperate is set to Yes, AclPolicy is ignored.

  • LOCAL: The local domain modifies the identity of service requests received from a given remote domain to the principal name specified in the local principal name for a given remote domain.

  • GLOBAL: The local domain passes the service request with no change in identity.

Default: "LOCAL"

Valid values:

  • "GLOBAL"

  • "LOCAL"

Acl Policy

Cmp-Limit

Defines the compression threshold used when sending data to a remote domain. Application buffers larger than this size are compressed.

Default: 2147483647

Minimum: 0

Maximum: 2147483647

Cmp Limit

Conn-Principal-Name

Defines the principal name used to verify the identity of this domain when establishing a connection to another domain.

  • This parameter only applies to domains of type TDOMAIN that are running BEA Tuxedo 7.1 or later software.

  • If not specified, the connection pricipal name defaults to the AccessPointID for this domain.

Note: ConnectionPrincipalName is not supported in this release.


Connection Principal Name

Connection-Policy

Defines the conditions under which a local domain tries to establish a connection to a remote domain.

  • ON_DEMAND: A connection is attempted only when requested by either a client request to a remote service or an administrative connect command.

  • ON_STARTUP: A domain gateway attempts to establish a connection with its remote domain access points at gateway server initialization time. Remote services (services advertised in JNDI by the domain gateway for this local access point) are advertised only if a connection is successfully established to that remote domain access point. If there is no active connection to a remote domain access point, then the remote services are suspended. By default, this connection policy retries failed connections every 60 seconds. Use the MaxRetry and RetryInterval attributes to specify application specific values.

  • INCOMING_ONLY: A domain gateway does not attempt an initial connection to remote domain access points at startup and remote services are initially suspended. The domain gateway is available for incoming connections from remote domain access points and remote services are advertised when the domain gateway for this local domain access point receives an incoming connection. Connection retry processing is not allowed.

Default: "ON_DEMAND"

Valid values:

  • "ON_DEMAND"

  • "ON_STARTUP"

  • "INCOMING_ONLY"

  • "LOCAL"

Connection Policy

Credential-Policy

Defines the outbound access control list (ACL) policy toward requests to a remote domain.

  • If Interoperate is set to Yes, CredentialPolicy is ignored.

  • LOCAL: The remote domain controls the identity of service requests received from the local domain to the principal name specified in the local principal name for this remote domain.

  • GLOBAL: The remote domain passes the service request with no change.

Default: "LOCAL"

Valid values:

  • "GLOBAL"

  • "LOCAL"

Credential Policy

Federation-Name

Defines the context at which to federate to a foreign name service. If omitted then the federation point is tuxedo.domains.


Federation Name

Federation-URL

Defines the URL for a foreign name service that is federated into JNDI. If omitted:

  • WebLogic Tuxedo Connector assumes there is a CosNaming server in the foreign domain.

  • WebLogic Tuxedo Connector federates to the CosNaming server using TGIOP.

WebLogic Tuxedo Connector can to federate to non-CORBA service providers.


Federation URL

Local-Access-Point

Defines the local domain name from which a remote domain is reached.


Local Access Point

Max-Encrypt-Bits

Defines the maximum encryption key length (in bits) used when establishing a network connection for a local domain.

  • A value of 0 indicates no encryption is used.

  • The value of the MaxEncryptBits attribute must be greater than or equal to the value of the MinEncrypBits attribute.

  • A MaxEncryptBits of 40 can be used only with domains running Tuxedo 7.1 or higher.

Default: "128"

Valid values:

  • "0"

  • "40"

  • "56"

  • "128"

Max Encryption Level

Max-Retries

Defines the number of times that a domain gateway tries to establish connections to remote domain access points. Use only when Connection Policy is set to ON_STARTUP.

  • Use -1 to default to the value defined by the WTCLocalTuxDomMBean MaxRetries attribute. li>Use 0 to disable the retry mechanism.

  • Use the maximum value to try until a connection is established.

Default: -1

Minimum: -1

Maximum: 9223372036854775807

Max Retries

Min-Encrypt-Bits

Defines the minimum encryption key length (in bits) used when establishing a network connection for a local domain.

  • A value of 0 indicates no encryption is used.

  • The value of the MinEncrypBits attribute must be less than or equal to the value of the MaxEncrypBits attribute.

  • A MinEncrypBits of 40 can be used only with domains running Tuxedo 7.1 or higher.

Default: "0"

Valid values:

  • "0"

  • "40"

  • "56"

  • "128"

Min Encryption Level

NWAddr

Defines the network address of the local domain gateway. Specify the TCP/IP address in one of the following formats:

  • //hostname:port_number

  • //#.#.#.#:port_number

If the hostname is used, the domain finds an address for hostname using the local name resolution facilities (usually DNS). If dotted decimal format is used, each # should be a number from 0 to 255. This dotted decimal number represents the IP address of the local machine. The port_number is the TCP port number at which the domain process listens for incoming requests.


Network Address

Name

The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.


Name

Notes

Optional information that you can include to describe this configuration.


Notes

Retry-Interval

Defines the number of seconds between automatic attempts to establish a connection to remote domain access points.

ul>

Use only when Connection Policy is set to ON_STARTUP.

Use -1 to default to the value defined by the WTCLocalTuxDomMBean RetryInterval attribute.

Default: -1

Minimum: -1

Maximum: 2147483647

Retry Interval

Tp-Usr-File

Defines the full path to user password file containing uid/gid information. This file is the same one generated by the Tuxedo tpusraddutility on the remote domain. Username, uid and gid information must be included and valid for correct authorization, authentication, and auditing.


Tp User File

 

 

Back to Top Previous Next