9 Using WLST Commands with Oracle Managed File Transfer
Learn how to use the WLST (Oracle WebLogic Scripting Tool) commands that perform Oracle Managed File Transfer (MFT) operations.
This chapter includes the following sections:
For more detailed descriptions and examples of the MFT WLST commands, see the Oracle Managed File Transfer Custom WLST Commands in WLST Command Reference for SOA Suite.
9.1 Running WLST Commands
Before you can run WLST commands, you must start WLST and connect to the Oracle WebLogic Server Managed Server dedicated to Oracle Managed File Transfer.
The steps for this process are:
9.2 MFT WLST Command Summary
Use WLST (Oracle WebLogic Scripting Tool) commands to perform various Oracle Managed File Transfer operations.
Table 9-1 summarizes the MFT WLST commands. It is intended as a quick reference and not as a complete description of each command. For a complete description of these commands, see Oracle Managed File Transfer Custom WLST Commands in WLST Command Reference for SOA Suite.
Table 9-1 MFT WLST Command Summary
Command | Shortcut | Syntax | Description |
---|---|---|---|
|
|
bulkDeployArtifact('TRANSFER|SOURCE|TARGET',
'artifact_names', 'comment')
|
Deploys a comma-separated list of source, transfer, or target artifacts or * for all. A comment is optional. |
|
N/A |
createMftCredential(password, key)
|
Creates the credential for |
|
|
deleteArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name')
|
Deletes a source, transfer, or target artifact. |
|
|
deleteArtifactDeployment('TRANSFER|SOURCE|TARGET',
'artifact_name', 'label')
|
Deletes an undeployed source, transfer, or target
artifact. Also use to delete old configuration history. Use Show
Deployment Details on the Deployment tab to view the
|
|
|
deployArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name', 'comment')
|
Deploys a source, transfer, or target artifact. A comment is optional. |
|
|
disableArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name', 'comment')
|
Disables a deployed and previously enabled source, transfer, or target artifact. A comment is optional. |
|
|
enableArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name', 'comment')
|
Enables a deployed and previously disabled source, transfer, or target artifact. A comment is optional. |
|
|
exportDeployedArtifact('artifact_type','artifact_name',label,'archive_file_path', generate_config_plan, long_format)
|
Exports a deployed source, transfer, or target artifact
to a ZIP file. Use Show Deployment Details on the Deployment
tab to view the
|
|
|
isArtifactInMDS('TRANSFER|SOURCE|TARGET',
'artifact_name')
|
Checks whether a source, transfer, or target artifact
exists in the MDS (Metadata Store) and returns |
|
|
undeployArtifact('TRANSFER|SOURCE|TARGET',
'artifact_name', 'comment')
|
Undeploys a source, transfer, or target artifact without deleting it from the configuration. A comment is optional. |
|
|
exportMetadata('archive_file', generate_config_plan, long_format)
|
Exports the entire MFT configuration, excluding passwords, to a ZIP file. If you are connecting to WLST remotely, the ZIP file is created on the remote server.
|
|
|
exportTransferMetadata('archive_file', 'transfer_name', generate_config_plan, long_format)
|
Exports a transfer artifact and related metadata to a ZIP file. If you are connecting to WLST remotely, the ZIP file is created on the remote server.
|
|
|
importMetadata('archive_file', generate_config_plan, previewMode)
|
Imports a previously exported MFT configuration from a ZIP file.
|
|
|
resetMetadata('preserve_preferences')
|
Resets the MFT configuration, deleting all artifacts and resetting all administrative settings to their defaults. Example:
|
|
|
deleteCSFKey('SSH|PGP|PEM', 'PRIVATE|PUBLIC',
'alias') Foot 1 |
Deletes a key alias from the MFT keystore. Example:
|
|
|
exportCSFKey('SSH|PGP|PEM', 'PRIVATE|PUBLIC',
'zip_file_path') Foot 1 |
Exports keys from the MFT keystore to a zip file containing the keys. Example:
Unzip the file to extract the keys. |
|
|
generateKeys('SSH|PGP', 'password',
'key_file_path')
|
Generates keys and saves them to one or more key files. The key type is RSA and the key size is 1024 bits. The private key password is optional. For SSH, the path must include the key file name. For PGP, two files are generated under the specified path: the
To generate a private RSA key of PEM format, which is used to
connect to Oracle Cloud Infrastructure when the OCI Storage Cloud Service
type is selected as a source or target, you cannot use the Oracle Managed
File Transfer console or the WSLT Example:
|
|
|
importCSFKey('SSH|PGP|PEM', 'PRIVATE|PUBLIC', 'alias', 'key_file_path') Foot 1 |
Imports a key to the MFT keystore from a key file and creates an alias. Example:
Before you can use the OCI Storage Cloud Service type as a source or target, you must import RSA key of PEM format to connect to Oracle Cloud Infrastructure.Foot 1 Example:
|
|
|
listCSFKeyAliases('SSH|PGP|PEM', 'PRIVATE|PUBLIC', 'alias') Foot 1 |
Lists key aliases in the MFT keystore. Example:
|
|
|
updateCSFKey('SSH|PGP|PEM', 'PRIVATE|PUBLIC', 'alias',
'key_file_path') Foot 1 |
Deletes a key alias from the MFT keystore and generates a new key file. Example:
|
|
|
getSourceDeploymentHistory('source_name')
|
Returns the deployment history of a source artifact. |
|
|
getTargetDeploymentHistory('target_name')
|
Returns the deployment history of a target artifact. |
|
|
getTransferDeploymentHistory('transfer_name')
|
Returns the deployment history of a transfer artifact. |
|
|
getTransferInfo('transfer_name', 'label')
|
Returns information about a transfer artifact. Use
Show Deployment Details on the Deployment tab to view the
|
|
|
pauseTransfer('instance_id', 'comment')
|
Pauses an in-progress transfer. Open the Advanced section of the target report to view the instance ID. For information about the target report, see Interpreting Source, Transfer, and Target Reports. A comment is optional. |
|
|
resubmit('resubmit_type', 'instance_id', 'comment', 'IsSync')
|
Resubmits a transfer. The
For information about the target report, see Interpreting Source, Transfer, and Target Reports. A comment is optional. Example:
|
|
|
resubmitMessages(resubmit_type, state, artifact_name, start_date, end_date, chunk_size, chunk_delay, ignore_ids, comments, preview_mode) |
Resubmits transfers in bulk. The For more information, see Bulk Resubmit. |
|
|
resumeTransfer('instance_id', 'comment')
|
Resumes a paused transfer. Open the Advanced section of the target report to view the instance ID. For information about the target report, see Interpreting Source, Transfer, and Target Reports. A comment is optional. |
|
|
configureHomeDir('directory_path', 'user_name')
|
Assigns the specified directory to the user as home directory where that user is located on login to embedded servers. |
|
|
grantPermissionToDirectory('directory_path',
'principal_name', 'principal_type',
'permissions', 'server_type', 'include_subfolder')
|
Grants permission to an embedded server directory. Users and groups can be assigned a set of permissions to an existing directory on an embedded server. |
|
|
listAllPermissions(principal_name, server_types)
|
Lists all permissions available for a given principal and server type. The server type can be FTP or sFTP. For example: wls:/mydomain/serverConfig>
listAllPermissions("weblogic","FTP") |
|
|
createArtifacts('xml_file_fath', previewMode, updateIfExists)
|
Creates Artifacts from an input xml file containing artifact definition. |
|
|
revokePermissionForDirectory('directory_path',
'principal_name', 'principal_type', 'permissions',
'server_type', 'include_subfolder')
|
Revokes a set of permissions from an embedded server directory. |
|
|
startEmbeddedServer('FTP|FTPS|SFTP')
|
Starts an embedded FTP, FTPS (FTP over SSL), or sFTP (SSH-FTP) server that was stopped. |
|
|
stopEmbeddedServer('FTP|FTPS|SFTP')
|
Stops an embedded FTP, FTPS (FTP over SSL), or sFTP (SSH-FTP) server that is running. |
|
|
updatePorts('server_instance_name',
'FTP|FTPS|SFTP', 'port')
|
Updates the port for an embedded FTP, FTPS (FTP over SSL), or sFTP (SSH-FTP) server, which is a service of an Oracle WebLogic Server managed server dedicated to MFT. |
|
|
createCallouts('def_file_path')
|
Creates callouts based on an XML file that defines them. |
|
|
deleteCallout('callout_name')
|
Deletes a callout. |
|
|
listCallouts()
|
Lists callouts. |
|
|
updateCallouts('def_file_path')
|
Updates callouts with the same names based on an XML file that defines them. |
|
|
addContactToNotification('event',
'Email|PHONE|FAX|SMS', 'value')
|
Adds a contact to a specific event notification. The
The |
|
|
createContact('Email|PHONE|FAX|SMS', 'value')
|
Creates a contact for event notifications. The
|
|
|
deleteContact('Email|PHONE|FAX|SMS', 'value')
|
Deletes a contact. The |
|
|
listContacts('Email|PHONE|FAX|SMS')
|
Lists contacts. |
|
|
removeContactFromNotification('event',
'Email|PHONE|FAX|SMS', 'value')
|
Removes a contact from a specific event notification.
The The |
|
|
updateEvent('event', 'enabled')
|
Enables or disables a specific event notification. Set
The |
|
|
archiveInstanceData(archiveFileName='filename',
startDate='date', endDate='date',
batchId='batchId', status='C|F|A|*',
testMode='TRUE|FALSE', comments='text',
runInSync='FALSE|TRUE',
fsArchiveFolderPath='path')
|
Archives runtime instances to a |
|
|
restoreInstanceData(archiveFilePath='path',
fileNamePrefix='prefix', fsFolderPath='path',
runInSync='FALSE|TRUE')
|
Restores previously archived runtime instances. The
|
|
|
archivePayloads(batchId='batchId',
archivePath='path', runInSync='FALSE|TRUE')
|
Archives payloads corresponding to runtime instances to
|
|
|
restorePayloadsByName(fileNames='filename',
folderPath='path', runInSync='FALSE|TRUE')
|
Restores previously archived payloads by file name. The
|
|
|
restorePayloadsByPrefix(fileNamePrefix='prefix',
folderPath='path', runInSync='FALSE|TRUE')
|
Restores previously archived payloads by file name
prefix. The |
|
|
purgeInstanceData(startDate='date',
endDate='date', batchId='batchId',
status='C|F|A|*', testMode='TRUE|FALSE',
comments='text', runInSync='FALSE|TRUE',
runPayloadPurge='FALSE|TRUE', transfer_names, names_delimiter)
|
Purges runtime instances. All arguments are optional.
Dates are in |
|
|
purgePayloads(batchId='batchId',
detailedAudit='TRUE|FALSE',
runInSync='FALSE|TRUE')
|
Purges payloads corresponding to runtime instances. The
|
|
|
createUserContact(user_name, delivery_channel)
|
Create a new user contact, which can be used for event notification. .
|
|
|
createUserGroupContact(user_group_name,delivery_channel)
|
Create a new user group contact, which can be used for event notification.
|
|
|
addUserContactToNotification(event, user_name, delivery_channel)
|
Add user contact for notification event. Event values:
Note: Before adding an internal contact make sure that the email address/contact number is present in the user setting. |
|
|
addUserGroupContactToNotification(event, user_name, delivery_channel)
|
Add user group contact for notification event. Event values:
|
|
|
deleteUserContact(user_name, delivery_channel)
|
Delete an existing user contact. Note: If the contact is in use (assigned to an event), the user will get an error message.
|
|
|
deleteUserGroupContact(user_group_name,delivery_channel)
|
Delete an existing user group contact. Note: If the contact is in use (assigned to an event), the user will get an error message.
|
|
|
removeUserContactFromNotification(event, user_name, delivery_channel)
|
Remove the given user contact from the notification event. Event values:
|
|
|
removeUserGroupContactFromNotification(event, user_group_name, delivery_channel)
|
Remove the given user group contact from the notification event. Event values:
|
triggerEvent |
trgEvt |
triggerEvent('source_name',
'properties') |
Trigger an Event on JCA/OCS/RIDC sources to initiate the
file transfer.
|
updateTriggerEventStatus |
updTrgEvtSt |
updateTriggerEventStatus(status, source_name, event_session_id)
|
Update the TriggerEvent status of the
specified event_session_id .
If no
|
activatePurgeSchedule |
actPurgeSch |
activatePurgeSchedule(schedule_name)
|
Activate a purge schedule. Provide the purge schedule
name to activate. Default schedule_name is the
default purge schedule. If no purge schedule name is provided, the
command will activate the default purge schedule. Only one purge
schedule can be activated using this command.
|
deactivatePurgeSchedule |
deactPurgeSch |
deactivatePurgeSchedule(schedule_name)
|
Deactivate a purge schedule. Provide the purge schedule
name to deactivate it. Default schedule_name is
the default purge schedule. If no purge schedule name is provided, the
command will deactivate the default purge schedule. Only one purge
schedule can be deactivated using this command.
|
modifyPurgeSchedule |
modifyPurgeSch |
modifyPurgeSchedule(start_date, end_date, schedule_time, frequency, retention_period, status, transfer_names, names_delimiter, include, comment)
|
Modify an existing purge schedule.
retention_period values are any non-negative
number, status values are
COMPLETED and/or FAILED ,
transfer_names can be Transfer names
whose instances need to be purged,
names_delimiter is a single character
string, include values are TRUE
or FALSE , comment value is any
string.
|
updateAppProperties |
updAppPrt |
updateAppProperties('properties_name_value_pair', 'delimiter')
|
Update Application properties of MFT. The supported
properties are Server, HA, Performance and Advanced properties. Allows
to update more than one property at a time where property is a
name/value pair, name is the property name and value is the property
value and each separated by a delimiter. Supported parameters are:
physicalstoragedirectory: String - Directory
Path, calloutdirectory : String - Directory
Path, storeonlinepayload : String - {fileSystem,
database}, storereferencepayload : Boolean -
true/false, generatechecksum : Boolean -
true/false, sourceprocessors : Number - non zero,
non negative number, instanceprocessors : Number - non
zero, non negative number,targetprocessors : Number -
non zero, non negative number, controldirectory : String
- Directory Path,inbounddatasource : String - MFT Data
Source Name, outbounddatasource : String - MFT Data
Source Name, internaladdress : String - IP Address of
Load Balancer (LB), internalFTPS : Number - Port number
of FTPS in LB, internalSFTP : Number - Port number of
SFTP in LB, internalFTP : Number - Port number of FTP in
LB, externaladdress : String - IP Address of
LB, externalFTPS : Number - Port number of FTPS in
LB, externalSFTP : Number - Port number of SFTP in
LB, externalFTP : Number - Port number of FTP in
LB.
|
updateSFTPServer |
updSFTPSvr |
updateSFTPServer('enable_SFTP', 'key_alias', 'private_key_password')
|
Used to enable/disable the Embedded SFTP Server. To
enable SFTP server, SSH key alias name is mandatory along with the
optional private key password. If the key is not password protected,
then private key password is not required. To disable, both key alias
and password are not required. Supported parameters are:
enable_SFTP : Boolean to enable/disable
SFTP, key_alias : SSH private key alias,
private_key_password : Optional password of the SSH
private key.
|
Footnote 1
An RSA key of PEM format is used to connect to Oracle Cloud Infrastructure when the OCI Storage Cloud Service type is selected as a source or target.
For an RSA key of PEM format, only PRIVATE
is
valid.
The OCI Storage Cloud Service type and the PEM key format is available in 12c (12.2.1.4) only if you have installed patch 32395225. Sign in to My Oracle Support and search for the patch number to locate and download the patch.