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.
Before you can run WLST commands, you must start WLST and connect to the Oracle WebLogic Server managed server dedicated to Oracle MFT.
The steps for this process are:
Use the WLST (Oracle WebLogic Scripting Tool) commands that 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. |
|
createMftCredential(password, key) |
Create the credential for mftapp. Enter the password for which credential needs to be created and the key for the credential. |
|
|
|
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. 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('<ArtifactType>','<ArtifactName>',<Label>,'<ArchiveFilePath>',generateConfigPlan, longFormat) |
Exports a deployed source, transfer, or target artifact to a ZIP file. Use Show Deployment Details on the Deployment tab to view the GenerateConfigPlan(optional, default false): Indicates whether to generate the mftConfig XML. Config plan is generated in same folder where archive file is generated. LongFormat(optional, default false): If "true", most of the attributes will be included in the config plan xml; otherwise, only the key attributes will be listed in the config plan XML. |
|
|
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('<ArchiveFile>', generateConfigPlan, longFormat)
|
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. GenerateConfigPlan(optional, default false): Indicates whether to generate the mftConfig XML. Config plan is generated in same folder where archive file is generated. LongFormat(optional, default false): If "true", most of the attributes will be included in the config plan xml; otherwise, only the key attributes will be listed in the config plan XML. |
|
|
exportTransferMetadata('<ArchiveFile>', '<TransferName>', generateConfigPlan, longFormat ) |
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. GenerateConfigPlan(optional, default false): Indicates whether to generate the mftConfig XML. Config plan is generated in same folder where archive file is generated. LongFormat(optional, default false): If "true", most of the attributes will be included in the config plan xml; otherwise, only the key attributes will be listed in the config plan XML. |
|
|
importMetadata('<ArchiveFile>',<MftConfigPlanXML>, previewMode)
|
Imports a previously exported MFT configuration from a ZIP file. GenerateConfigPlan(optional, default false): Indicates whether to generate the mftConfig XML. Config plan is generated in same folder where archive file is generated. |
|
|
resetMetadata('preserve_preferences')
|
Resets the MFT configuration, deleting all artifacts and resetting all administrative settings to their defaults, while preserving user preferences if optional |
|
|
deleteCSFKey('SSH|PGP', 'PRIVATE|PUBLIC', 'alias')
|
Deletes a key alias from the MFT keystore. |
|
|
exportCSFKey('SSH|PGP', 'PRIVATE|PUBLIC',
'key_file_path')
|
Exports keys from the MFT keystore to a key file. |
|
|
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 For additional key generation options that are not supported by |
|
|
importCSFKey('SSH|PGP', 'PRIVATE|PUBLIC', 'alias', 'key_file_path') |
Imports a key to the MFT keystore from a key file and creates an alias. |
|
|
listCSFKeyAliases('SSH|PGP', 'PRIVATE|PUBLIC',
'alias')
|
Lists key aliases in the MFT keystore. |
|
|
updateCSFKey('SSH|PGP', 'PRIVATE|PUBLIC', 'alias', 'key_file_path') |
Deletes a key alias from the MFT keystore and generates a new key file. |
|
|
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_ids', 'comment') |
Resubmits a transfer. The |
|
|
resubmitMessages(<ResubmitType>, <state>, <artifactName>, <startDate>, <endDate>, <chunkSize>, <chunkDelay>, <ignoreIds>, <comments>, <previewMode>) |
Bulk resubmits of transfers. The ResubmitType is the type of artifact for which resubmit is invoked. Possible values are source, transfer_instance, target, target_instance. State (optional) includes Active, Failed or Completed. The start/end dates enable you to resubmit all failed messages within a specified date range. When the command is run in preview mode, it lists the count of messages that will be resubmitted for given criteria. |
|
|
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(principalName,serverTypes) |
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('<xmlFilePath>',previewMode,updateIfExists)
|
Create 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', <transferNames>, <namesDelimiter>) |
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(<userName>,<deliveryChannel>) |
Create a new user contact, which can be used for event notification. . deliveryChannel (optional): possible values Email/SMS. If not specified, it will use the user preferred delivery channel configured in the weblogic user. |
|
|
createUserGroupContact(<userGroupName>,<deliveryChannel>) |
Create a new user group contact, which can be used for event notification. deliveryChannel (optional): possible values Email/SMS. If not specified, it will use the user preferred delivery channel configured in the weblogic user. |
|
|
addUserContactToNotification(<Event>, <userName>, <deliveryChannel>) |
Add user contact for notification event. Event values: deliveryChannel (optional): possible values Email/SMS Note: Before adding an internal contact make sure that the email address/contact number is present in the user setting. |
|
|
addUserGroupContactToNotification(<Event>, <userGroupName>, <deliveryChannel>) |
Add user group contact for notification event. Event values: deliveryChannel (optional): possible values Email/SMS |
|
|
deleteUserContact(<userName>,<deliveryChannel>) |
Delete an existing user contact. Note: If the contact is in use (assigned to an event), the user will get an error message. |
|
|
deleteUserGroupContact(<userGroupName>,<deliveryChannel>) |
Delete an existing user groupcontact. Note: If the contact is in use (assigned to an event), the user will get an error message. |
|
|
removeUserContactFromNotification(<Event>, <userName>, <deliveryChannel>) |
Remove the given user contact from the notification event. Event values: deliveryChannel (optional): possible values Email/SMS |
|
|
removeUserGroupContactFromNotification(<Event>, <userGroupName>, <deliveryChannel>) |
Remove the given user group contact from the notification event. Event values:
|
triggerEvent |
trgEvt |
triggerEvent('<sourceName>', '<properties>') |
Trigger an Event on JCA/OCS/RIDC sources to initiate the file transfer.
Supported parameters: |
updateTriggerEventStatus |
updTrgEvtSt |
updateTriggerEventStatus(<status>, <sourceName>, <eventSessionId>) |
Update the TriggerEvent status of the eventSessionId provided.
If no |
activatePurgeSchedule |
actPurgeSch |
activatePurgeSchedule(schedule_name) |
Used to activate a purge schedule. Provide the purge schedule name to activate. Default scheduleName 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 |
<scheduleName> |
Used to deactivate a purge schedule. Provide the purge schedule name to deactivate it. Default scheduleName 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(<startDate>, <endDate>, <scheduleTime>, <frequency>, <retentionPeriod>, <status>, <transferNames>, <namesDelimiter>, <include>, <comment>) |
Used to modify an existing purge schedule.
retentionPeriod values are any non-negative number, status values are Completed and/or Failed, transferNames can be Transfer names whose instances need to be purged, namesDelimiter value is single character string, include values are True or False, comment value is any string. |
updateAppProperties |
updAppPrt |
updateAppProperties('<propertiesNameValuePair>', '<delimeter>') |
Used to update Application properties of MFT system. 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('<enableSFTP>', '<keyAlias>', '<privateKeyPassword>') |
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: enableSFTP : Boolean to enable/disable SFTP, keyAlias : SSH private key alias, privateKeyPassword : Optional password of the SSH private key. |
Note:
MFT WLST command shortcuts are shorthand aliases for the MFT WLST commands. These can be substituted for the full command names if preferred. There is no difference in the command behavior between using the full command names or the shortcut command names.