GET A Create Form For This WTC Remote Tux Dom Collection
/management/weblogic/{version}/edit/WTCServers/{name}/WTCRemoteTuxDomCreateForm
This resource returns a pre-populated WTC remote tux dom model that can be customized then posted (using the POST method) to the WTCRemoteTuxDoms collection resource to create a new WTC remote tux dom.
Request
-
name: string
The name property of the instance in the collection.
-
version: string
The version of the WebLogic REST interface.
-
excludeFields(optional): string
The 'excludeFields' query parameter is used to restrict which fields are returned in the response. It is a comma separated list of field names. If present, only fields whose name is not on the list will be returned. If not present, all fields are returned (unless the 'fields' query parameter is specified). Note: 'fields' must not be specified if 'excludeFields' is specified.
-
excludeLinks(optional): string
The 'excludeLinks' query parameter is used to restrict which links are returned in the response. It is a comma separated list of link relationship names. If present, only links whose relationship name is not on the list will be returned. If not present, all links are returned (unless the 'links' query parameter is specified). Note: 'links' must not be specified if 'excludeLinks' is specified.
-
fields(optional): string
The 'fields' query parameter is used to restrict which fields are returned in the response. It is a comma separated list of field names. If present, only fields with matching names are returned. If not present, all fields are returned (unless the 'excludeFields' query parameter is specified). Note: 'excludeFields' must not be specified if 'fields' is specified.
-
links(optional): string
The 'links' query parameter is used to restrict which links are returned in the response. It is a comma separated list of link relationship names. If present, only links with matching relationship names are returned. If not present, all links are returned (unless the 'excludeLinks' query parameter is specified). Note: 'excludeLinks' must not be specified if 'links' is specified.
-
Admin: basic
Type:
basic
Description:A user in the Admin security role.
-
Deployer: basic
Type:
basic
Description:A user in the Deployer security role.
-
Monitor: basic
Type:
basic
Description:A user in the Monitor security role.
-
Operator: basic
Type:
basic
Description:A user in the Operator security role.
Response
- application/json
200 Response
Returns this WTC remote tux dom.
This method can return the following links:
- rel=create uri=/management/weblogic/{version}/edit/WTCServers/{name}/WTCRemoteTuxDoms
The collection resource for this create form resource.
object
-
accessPoint(optional):
string
Default Value:
myRAP
The unique name used to identify this remote Tuxedo access point. This name should be unique for all local and remote Tuxedo access points defined within a WTC Service. This allows you to define unique configurations having the same Access Point ID.
Constraints
- legal null
-
accessPointId(optional):
string
Default Value:
myRAPId
The connection principal name used to identify this remote domain access point when attempting to establish a session connection to local Tuxedo access points. This value must be globally unique among all interconnected Tuxedo and WTC Domains.
Constraints
- legal null
-
aclPolicy(optional):
string
Default Value:
LOCAL
Allowed Values:[ "GLOBAL", "LOCAL" ]
The inbound access control list (ACL) policy toward requests from a remote Tuxedo access point.
The allowed values are:
LOCAL: The local Tuxedo access point modifies the identity of service requests received from a given remote Tuxedo access point to the principal name specified in the local principal name for a given remote Tuxedo access point.
GLOBAL: The local Tuxedo access point passes the service request with no change in identity.
Note: If Interoperate is set to Yes, AclPolicy is ignored.
-
allowAnonymous(optional):
boolean
Default Value:
false
Specifies whether the anonymous user is allowed to access remote Tuxedo services.
Note: If the anonymous user is allowed to access Tuxedo, the default AppKey will be used for
TpUsrFile
andLDAP
AppKey plug-ins. Interaction with theCustom
AppKey plug-in depends on the design of the Custom AppKey generator. -
appKey(optional):
string
Default Value:
TpUsrFile
Allowed Values:[ "TpUsrFile", "LDAP", "Custom" ]
Specifies the type of AppKey plug-in used.
The allowed values are:
TpUsrFile:
TpUsrFile
is the default plug-in. It uses an imported Tuxedo TPUSR file to provide user security information. Previous releases of WebLogic Tuxedo Connector support this option.LDAP: The
LDAP
plug-in utilizes an embedded LDAP server to provide user security information. The user record must define the Tuxedo UID and GID information in the description field. This functionality is not supported in previous releases of WebLogic Tuxedo Connector.Custom: The
Custom
plug-in provides the ability to write your own AppKey generator class to provide the security information required by Tuxedo. This functionality is not supported in previous releases of WebLogic Tuxedo Connector.
-
cmpLimit(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:2147483647
The compression threshold this remote Tuxedo access point uses when sending data to a local Tuxedo access point. Application buffers larger than this size are compressed.
Range of Values: Between
and a positive 32-bit integer.
-
connectionPolicy(optional):
string
Default Value:
LOCAL
Allowed Values:[ "ON_DEMAND", "ON_STARTUP", "INCOMING_ONLY", "LOCAL" ]
The conditions under which this remote Tuxedo access point establishes a session connection with a local Tuxedo access point.
The allowed values are:
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 Tuxedo access points at gateway server initialization time. Remote services (services advertised in JNDI by the domain gateway for this local Tuxedo access point) are advertised only if a connection is successfully established to that remote Tuxedo access point. If there is no active connection to a remote Tuxedo 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 Tuxedo access points at startup and remote services are initially suspended. The domain gateway is available for incoming connections from remote Tuxedo access points and remote services are advertised when the domain gateway for this local Tuxedo access point receives an incoming connection. Connection retry processing is not allowed.
LOCAL: Specifies that the remote domain connection policy is explicitly defaulted to the local domain ConnectionPolicy attribute value.
-
connPrincipalName(optional):
string
The principal name used to verify the identity of this remote Tuxedo access point when it establishes a session connection with a local Tuxedo access point. If not specified, the connection principal name defaults to the AccessPointID for this access point.
Note: This parameter only applies to domains of type TDOMAIN that are running Oracle Tuxedo 7.1 or later software.
Note: ConnPrincipalName is not supported in this release.
-
credentialPolicy(optional):
string
Default Value:
LOCAL
Allowed Values:[ "GLOBAL", "LOCAL" ]
The outbound access control list (ACL) policy toward requests to a remote Tuxedo access point.
The allowed values are:
LOCAL: The remote Tuxedo access point controls the identity of service requests received from the local Tuxedo access point to the principal name specified in the local principal name for this remote Tuxedo access point.
GLOBAL: The remote Tuxedo access point passes the service request with no change.
Note:If Interoperate is set to Yes, CredentialPolicy is ignored.
-
customAppKeyClass(optional):
string
The full pathname to the custom
AppKey
generator class. (This class is only relevant if you specifyCustom
as the AppKey Generator.)Note: This class is loaded at runtime if the
Custom
AppKey generator plug-in is selected. -
customAppKeyClassParam(optional):
string
The optional parameters to be used by the custom
AppKey
class at the class initialization time. This class is only relevant if you specifyCustom
as the AppKey Generator.) -
defaultAppKey(optional):
integer(int32)
Default Value:
-1
The default
AppKey
value to be used by the anonymous user and other users who are not defined in the user database if the plug-in allows them to access Tuxedo.Note: The
TpUsrFile
andLDAP
plug-ins do not allow users that are not defined in user database to access Tuxedo unless Allow Anonymous is enabled. -
dynamicallyCreated(optional):
boolean
Read Only:
true
Default Value:false
Return whether the MBean was created dynamically or is persisted to config.xml
-
federationName(optional):
string
The context at which this remote Tuxedo access point federates to a foreign name service. If omitted, the default federation point is
tuxedo.domains
-
federationURL(optional):
string
The URL for a foreign name service that is federated into JNDI.
Note: The Weblogic Tuxedo Connector can federate to non-CORBA service providers.
Note: If this value is not specified, the WebLogic Tuxedo Connector:
Assumes there is a CosNaming server in the foreign domain.
Federates to the CosNaming server using TGIOP.
-
id(optional):
integer(int64)
Read Only:
true
Return the unique id of this MBean instance
-
keepAlive(optional):
integer(int32)
Minimum Value:
-1
Maximum Value:2147483647
Default Value:0
Indicates whether this remote Tuxedo access point is configured with Application Level Keep Alive.
Greater than 0: Application Level Keep Alive is enabled and the value indicates the amount of idle time, in milliseconds rounded to the nearest second, allowed before starting the wait timer.
0: Application Level Keep Alive is not enabled for the access point.
-1: Application Level Keep Alive is enabled and indicates that the value from the local Tuxedo access point is used to indicate the amount of idle time, in milliseconds rounded to the nearest second, allowed before starting the wait timer.
-
keepAliveWait(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:0
Indicates whether this remote Tuxedo access point requires the acknowledgement of Application Level Keep Alive. If the value is:
Greater than 0: Application Level Keep Alive is enabled and the value indicates the amount of idle time, in milliseconds rounded to the nearest second, allowed before WebLogic Tuxedo Connector marks the connection as failed if the heartbeat is not acknowledged.
0: Application Level Keep Alive is not enabled for the access point but the access point acknowledges if a heartbeat is received.
-
localAccessPoint(optional):
string
Default Value:
myLAP
The local domain name from which this remote Tuxedo domain is reached.
Constraints
- legal null
-
maxEncryptBits(optional):
string
Default Value:
128
Allowed Values:[ "0", "40", "56", "128" ]
The maximum encryption key length (in bits) this remote Tuxedo access point uses when establishing a session connection. A value of
indicates no encryption is used.
Value Restrictions:
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.
-
maxRetries(optional):
integer(int64)
Minimum Value:
-1
Maximum Value:9.223372036854776E18
Default Value:-1
The maximum number of times that this remote Tuxedo access point tries to establish a session connections to local Tuxedo access points. Use only when the ConnectionPolicy value is set to
ON_STARTUP
Note: When the ConnectionPolicy value is
LOCAL
, the MaxRetries value from the local Tuxedo access point is used. When the ConnectionPolicy value isON_STARTUP
, a value of-1
indicates 9223372036854775807.Range of Values: Between
-1
and a positive 64-bit integer.Use
to disable the retry mechanism.
Use the maximum value to try until a connection is established.
-
minEncryptBits(optional):
string
Default Value:
0
Allowed Values:[ "0", "40", "56", "128" ]
The minimum encryption key length (in bits) this remote Tuxedo access point uses when establishing a session connection. A value of
indicates no encryption is used.
Value Restrictions:
The MinEncrypBits value must be less than or equal to the MaxEncrypBits value.
A MinEncrypBits value of 40 can be used only with domains running Tuxedo 7.1 or higher.
Constraints
- secure default : "40"
-
name(optional):
string
Read Only:
true
The user-specified name of this MBean instance.
This name is included as one of the key properties in the MBean's
javax.management.ObjectName
Name=user-specified-name
Constraints
- legal null
-
notes(optional):
string
Optional information that you can include to describe this configuration.
WebLogic Server saves this note in the domain's configuration file (
config.xml
) as XML PCDATA. All left angle brackets (<) are converted to the xml entity<. Carriage returns/line feeds are preserved.)>
Note: If you create or edit a note from the Administration Console, the Administration Console does not preserve carriage returns/line feeds.
-
NWAddr(optional):
string
Default Value:
//localhost:8902
The network address and port number of this remote Tuxedo access point.
Specify the address in one of the following formats:
TCP/IP address in the format
//hostname:port_number
or//#.#.#.#:port_number
SDP address in the format
sdp://hostname:port_number
orsdp://#.#.#.#:port_number
Notes:
If the hostname is used, the access point 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/SDP port number at which the access point listens for incoming requests.
If SDP format address is specified, the transport protocol for this access point is SDP instead of TCP. This feature is only available when WTC and Tuxedo domain gateway are both deployed on Oracle Exalogic platform. Requires Tuxedo 11gR1PS2 and higher.
-
retryInterval(optional):
integer(int64)
Minimum Value:
-1
Maximum Value:2147483647
Default Value:-1
The number of seconds that this remote Tuxedo access point waits between automatic connection attempts to local Tuxedo access points. Use this only when the ConnectionPolicy value is set to
ON_STARTUP
Range of Values: Between
-1
and a positive 32-bit integer.Note: When the ConnectionPolicy value is
LOCAL
, the RetryInterval value from the local Tuxedo access point is used. When the ConnectionPolicy value isON_STARTUP
, a value of-1
indicates 60. -
SSLProtocolVersion(optional):
string
Default Value:
TLSv1.2
Allowed Values:[ "TLSv1.0", "TLSv1.1", "TLSv1.2" ]
The protocol version of the SSL connection this remote access point uses when establishing a SSL connection with specific local access point.
Value Restrictions:
TLSv1.0
TLSv1.1
TLSv1.2
-
tags(optional):
array Items
Title:
Items
Return all tags on this Configuration MBean
-
tpUsrFile(optional):
string
The full path to the user password file containing UID/GID information. (This field is only relevant if you specify
TpUsrFile
as the AppKey Generator.)Note: This file is generated by the Tuxedo
tpusradd
utility on the remote Tuxedo domain specified by the remote Tuxedo access point. A copy of this file must be available in your WebLogic Tuxedo Connector environment to provide correct authorization, authentication, and auditing. -
tuxedoGidKw(optional):
string
Default Value:
TUXEDO_GID
The keyword for Tuxedo GID (Group ID) used in the
WlsUser
when using the Tuxedo migration utilitytpmigldap
. This field is only relevant if you specifyLDAP
as the AppKey Generator.)Note: The keyword is used to find Tuxedo GID in the user record in the embedded LDAP database.
-
tuxedoUidKw(optional):
string
Default Value:
TUXEDO_UID
The keyword for Tuxedo UID (User ID) used in the
WlsUser
when using the Tuxedo migration utilitytpmigldap
. This keyword is only relevant if you specifyLDAP
as the AppKey Generator.)Note: The keyword is used to find Tuxedo UID in the user record in the embedded LDAP database.
-
type(optional):
string
Read Only:
true
Returns the type of the MBean.
Constraints
- unharvestable