File transfer
The restConnector-2.0
feature includes the FileTransfer
and FileService
MBeans. The FileTransfer
MBean supports delete,
upload, and download operations to and from a running Liberty server. The FileService
MBean provides access to directory lists and file metadata, and it also provides archive operations
such as create and expand.
The FileTransfer
and FileService
MBeans are useful for carrying
out remote operations on Liberty, such as
updating the configuration or installing an application. A configuration update can be performed
remotely by uploading an updated server.xml file for the target Liberty server. An application can be installed
by uploading both the application archive and an updated server.xml file or
simply by uploading the application archive to the monitored dropins folder.
The FileTransfer
MBean includes configurable read and write lists so that you
can control the directories that can be read or written when using the FileTransfer
MBean.
See the section on the FileTransfer
MBean in List of provided MBeans for information on how to configure the restConnector-2.0
feature
and control the FileTransfer
MBean read and write lists.
The uploadFile
method from FileTransfer
contains a boolean
called "expandOnCompletion
" that allows a user to upload and expand the archive
with a single MBean invocation. A directory is created with the same name as the archive on the
target path and the FileService
MBean is automatically invoked to expand the
archive.
Example: A call to uploadFile
with parameters
{"C:/temp/myArchive.zip", "${server.output.dir}/myArchive.zip", true}
will result
in a myArchive.zip directory under ${server.output.dir}
that
contains the extracted contents of the archive being created.