+

Search Tips   |   Advanced Search

Task webdav-deploy-zip-file

Use this configuration task to manage theme artifacts and to deploy iWidgets. This task uploads archive or compressed files to portal WebDAV folders. Address the target folder by using a corresponding DAV URI, for example:

By default, this task replaces the referenced target folder by the extracted contents of the referenced archive or compressed file. As a result, files or folders that are contained in the referenced WebDAV folder are deleted before the new content is added. To avoid this behavior and merge the contents, set the optional UpdateMode parameter to the value merge. If you add this setting, the task merges the contents of the archive or compressed file into the content that exists at the target URI.

For a portal cluster installation, start the task on the primary node only. Starting the task on a secondary node has no effect.

If the WebDAV folder referenced by the target URI does not exist yet, the task creates it. Make sure to have a trailing slash (/) at the end of the target URI.

Start this task as part of the ConfigEngine script file as follows:

Mandatory parameters to be specified on the command line or in the file wkplc.properties:

    WasUserid

    The WebSphere Application Server user ID.

    WasPassword

    The WebSphere Application Server password.

    PortalAdminId

    The HCL WebSphere Portal administrator user ID.

    PortalAdminPwd

    The HCL WebSphere Portal administrator password.

Mandatory parameters to be specified on the command line only:

    TargetURI

    The URI of the WebDAV folder where we want the archive or compressed file to be extracted.

    Path parameter:

    use only one of the following two path parameters. They are mutually exclusive:

      ZipFilePath

      The file system path to the archive or compressed file. Do not use this parameter in combination with the parameter ZipFileClassPath.

      ZipFileClassPath

      The Java class path to the archive or compressed file. Do not use this parameter in combination with the parameter ZipFilePath.

Optional parameters to be specified on the command line only:

    UpdateMode (=replace)

    The default value for this parameter is replace. To merge the content of the archive or compressed file with the content that exists at the target URI, set this parameter to the value merge. In this case files that do not yet exist are created, existing files are updated, and no files are deleted.

    VirtualPortalContext

    VirtualPortalHost

    Use one of these two parameters to identify the virtual portal. Only pages that are contained in the specified virtual portal are refreshed. If you omit this parameter, by default no virtual portal page layout is refreshed.

Example:

We can upload the file foo.zip to the public folder of the file store by using either one of the following options:

  • Copy the file foo.zip to the portal class path, for example AppServer/lib/ext.

  • Copy the file myWidget.zip to the temporary directory /tmp on the portal server node.

  • Run the configuration task webdav-deploy-zip-file as follows: 

      ./ConfigEngine.sh webdav-deploy-zip-file 
     -DTargetURI=dav:fs-type1/iwidgets/myWidget/ 
     -DZipFilePath=/tmp/myWidget.zip

Parent topic: Use WebDAV with HCL WebSphere Portal