2.6 Managing Custom Post-conversion Actions

To automate specific post-conversion tasks on your target, you can include a custom action, such as a batch file, a shell script, or a program executable, in your conversion job. At the end of the conversion process, Portability Suite uploads the specified action, along with its dependencies, to the target and executes it.

Custom post-conversion actions are supported for the following job types:

For the capability to select a post-conversion action to run as part of a conversion job, you must first save the action and its dependencies in a dedicated directory and add it to the Portability Suite Server’s library. The maximum size of the directory must not exceed 64 MB. For information about raising this limit, see Increasing the Size Limit on Post-conversion Actions Uploaded to Portability Suite Server in your Configuration Guide.

Use the following procedure for adding a post-conversion action to the Portability Suite Server’s library of custom actions.

  1. Create the action, test it on a sample workload, and save it together with its dependencies in a directory that the Portability Suite Server can access.

    Take special care when developing post-conversion actions for Linux and Solaris workloads, which allow different characters in file names and support different ACL (Access Control List) permissions. For these operating systems, amalgamate the action’s directory structure into a single file. See Knowledge Base Article 21121.

  2. In the Portability Suite Client, click Tools > Manage Actions.

  3. Click Add. The Add Action window opens:

  4. In the Add Action window, type a name for your custom action, select the target operating system type, then browse to and select the directory that contains the required action with its dependencies.

    Portability Suite populates the list with the contents of the selected folder.

  5. In the File Name column, select the required executable, then click Set.

  6. In the Default Options section, specify any required command line arguments and an execution timeout, then click OK.

    Portability Suite packages and uploads the library.

The action is now available for selection in conversion jobs. See Including a Custom Post-conversion Action in a Conversion Job.