GET A Create Form For This WTC Local Tux Dom Collection
/management/weblogic/{version}/edit/WTCServers/{name}/WTCLocalTuxDomCreateForm
This resource returns a pre-populated WTC local tux dom model that can be customized then posted (using the POST method) to the WTCLocalTuxDoms collection resource to create a new WTC local 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 local tux dom.
This method can return the following links:
- rel=create uri=/management/weblogic/{version}/edit/WTCServers/{name}/WTCLocalTuxDoms
The collection resource for this create form resource.
object
-
accessPoint(optional):
string
Default Value:
myLAP
The unique name used to identify this local 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:
myLAPId
The connection principal name used to identify this local Tuxedo access point when attempting to establish a session connection with remote Tuxedo access points.
Note: The AccessPointId must match the corresponding DOMAINID in the *DM_REMOTE_DOMAINS section of your Tuxedo DMCONFIG file.
Constraints
- legal null
-
blockTime(optional):
integer(int64)
Minimum Value:
0
Maximum Value:2147483647
Default Value:60
The maximum number of seconds this local Tuxedo access point allows for a blocking call.
Range of Values: Between
and a positive 32 bit integer.
-
cmpLimit(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:2147483647
The compression threshold this local Tuxedo access point uses when sending data to a remote 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:
ON_DEMAND
Allowed Values:[ "ON_DEMAND", "ON_STARTUP", "INCOMING_ONLY" ]
The conditions under which this local Tuxedo access point establishes a session connection with a remote Tuxedo access point.
The connection policies 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 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 values 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.
-
connPrincipalName(optional):
string
The principal name used to verify the identity of this domain when establishing a connection to another domain.
Note: This parameter only applies to domains of type TDOMAIN that are running Oracle Tuxedo 7.1 or later software. If not specified, the connection principal name defaults to the AccessPointID for this
domain.ConnPrincipalName
Note: ConnPrincipalName is not supported in this release.
-
dynamicallyCreated(optional):
boolean
Read Only:
true
Default Value:false
Return whether the MBean was created dynamically or is persisted to config.xml
-
id(optional):
integer(int64)
Read Only:
true
Return the unique id of this MBean instance
-
identityKeyStoreFileName(optional):
string
Default Value:
oracle.doceng.json.BetterJsonNull@28718b36
The path and file name of the identity keystore.
The path name must either be absolute or relative to where the server was booted. The identity key store file name is only used if KeystoreLocation is "Custom Stores".
-
identityKeyStorePassPhrase(optional):
string(password)
The custom identity keystore's passphrase. If empty or null, then the keystore will be opened without a passphrase.
This attribute is only used if KeyStores is "Custom Stores".
When you get the value of this attribute, WebLogic Server does the following:
Retrieves the value of the
IdentityKeyStorePassPhraseEncrypted
attribute.Decrypts the value and returns the unencrypted password as a String.
When you set the value of this attribute, WebLogic Server does the following:
Encrypts the value.
Sets the value of the
CustomIdentityKeyStorePassPhraseEncrypted
attribute to the encrypted value.
Using this attribute (
CustomIdentityKeyStorePassPhrase
) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.Instead of using this attribute, use
CustomIdentityKeyStorePassPhraseEncrypted
-
interoperate(optional):
string
Default Value:
No
Allowed Values:[ "Yes", "No" ]
Specifies whether this local Tuxedo access point interoperates with remote Tuxedo access points that are based upon Tuxedo release 6.5. If this value is set to
Yes
, the local Tuxedo access point interoperates with a Tuxedo 6.5 domain. -
keepAlive(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:0
Return value tells whether this local Tuxedo access point is configured with Application Level Keep Alive, and it maximum idle time value before wait timer start ticking.
-
keepAliveWait(optional):
integer(int32)
Minimum Value:
0
Maximum Value:2147483647
Default Value:0
Return value that tells whether this local Tuxedo access point requires the acknowledgement of Application Level Keep Alive, and how long it will wait without receiving acknowledgement before declare the connection is inaccessible.
-
keyStoresLocation(optional):
string
Default Value:
Custom Stores
Allowed Values:[ "WLS Stores", "Custom Stores" ]
Provides the configuration rule to be used for finding Local Access Point's identity key store and trust key store. In plain text, it contains information on where the identity key store and trust key store are configured. When KeyStoreLocation is configured with
WLS Store
, WTC uses configuration information from the WLS Key Stores configuration. Otherwise, it uses the key stores information configured in the Local Access Point. -
maxEncryptBits(optional):
string
Default Value:
128
Allowed Values:[ "0", "40", "56", "128", "256" ]
The maximum encryption key length (in bits) this local Tuxedo access point uses when establishing a session connection. A value of
indicates no encryption is used.
Value Restrictions:
The MaxEncryptBits value must be greater than or equal to the MinEncrypBits value.
A MaxEncryptBits of
40
can be used only with domains running Tuxedo 7.1 or higher.
Constraints
- secure default : "128"
-
maxRetries(optional):
integer(int64)
Minimum Value:
0
Maximum Value:9.223372036854776E18
Default Value:9.223372036854776E18
The maximum number of times that this local Tuxedo access point tries to establish a session connection to remote Tuxedo access points. Use this value only when Connection Policy is set to
ON_STARTUP
Range of Values: Between
and a positive 64 bit integer.
Note: Use the minimum value 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", "256" ]
The minimum encryption key length (in bits) this local 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:8901
The network address and port number of this local 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.
-
privateKeyAlias(optional):
string
Default Value:
oracle.doceng.json.BetterJsonNull@44616d14
The string alias used to store and retrieve the Local Tuxedo access point's private key in the keystore. This private key is associated with the Local Tuxedo access point's digital certificate.
-
privateKeyPassPhrase(optional):
string(password)
The passphrase used to retrieve the server's private key from the keystore. This passphrase is assigned to the private key when it is generated.
When you get the value of this attribute, WebLogic Server does the following:
Retrieves the value of the
PrivateKeyPassPhraseEncrypted
attribute.Decrypts the value and returns the unencrypted passphrase as a String.
When you set the value of this attribute, WebLogic Server does the following:
Encrypts the value.
Sets the value of the
PrivateKeyPassPhraseEncrypted
attribute to the encrypted value.
Using this attribute (
PrivateKeyPassPhrase
) is a potential security risk because the String object (which contains the unencrypted passphrase) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.Instead of using this attribute, use
getPrivateKeyPassPhraseEncrypted
-
retryInterval(optional):
integer(int64)
Minimum Value:
0
Maximum Value:2147483647
Default Value:60
The number of seconds that this local Tuxedo access point waits between automatic connection attempts to remote Tuxedo access points. Use this value only when Connection Policy is set to
ON_STARTUP
Range of Values: Between 0 and a positive 32-bit integer.
-
security(optional):
string
Default Value:
NONE
Allowed Values:[ "NONE", "APP_PW", "DM_PW" ]
The type of application security enforced.
The types of security are:
NONE: No security is used.
APP_PW: Password security is enforced when a connection is established from a remote domain. The application password is defined in the WTCResourcesMBean.
DM_PW: Domain password security is enforced when a connection is established from a remote domain. The domain password is defined in the WTCPasswordsMBean.
Constraints
- secure default : "DM_PW"
-
SSLProtocolVersion(optional):
string
Default Value:
TLSv1.2
Allowed Values:[ "TLSv1.0", "TLSv1.1", "TLSv1.2" ]
The protocol version of the SSL connection this local access point uses when establishing a SSL connection.
Value Restrictions:
TLSv1.0
TLSv1.1
TLSv1.2
-
tags(optional):
array Items
Title:
Items
Return all tags on this Configuration MBean
-
trustKeyStoreFileName(optional):
string
Default Value:
oracle.doceng.json.BetterJsonNull@21f8c21
The path and file name of the trust keystore.
The path name must either be absolute or relative to where the server was booted. This file name is only used if KeyStores is "Custom Stores".
-
trustKeyStorePassPhrase(optional):
string(password)
The trust keystore's passphrase. If empty or null, then the keystore will be opened without a passphrase.
This attribute is only used if KeyStores is "Custom Stores".
When you get the value of this attribute, WebLogic Server does the following:
Retrieves the value of the
TrustKeyStorePassPhraseEncrypted
attribute.Decrypts the value and returns the unencrypted password as a String.
When you set the value of this attribute, WebLogic Server does the following:
Encrypts the value.
Sets the value of the
TrustKeyStorePassPhraseEncrypted
attribute to the encrypted value.
Using this attribute (
TrustKeyStorePassPhrase
) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.Instead of using this attribute, use
TrustKeyStorePassPhraseEncrypted
-
type(optional):
string
Read Only:
true
Returns the type of the MBean.
Constraints
- unharvestable
-
useSSL(optional):
string
Default Value:
Off
Allowed Values:[ "Off", "TwoWay", "OneWay" ]
Specifies if the connection initiated or accepted by this Local Tuxedo access point uses SSL on top of its transport layer. Values are:
Off: SSL not used.
TwoWay: Mutual Authentication with SSL required.
OneWay: Server Authentication with SSL required.
Note: If SDP transport is configured for this access point, the configured value of this attribute is ignored and
off
is used.