Deploy Application Package (deploy) Utility

Deploys a package to Unwired Server with the administration client APIs.

Syntax

deploy [deploy-options]

Parameters

  • deploy-options – uses these option to deploy and configure the package:
    Option Description
    -d domain Specifies the domain to which the package belongs.
    -dcf descriptorFile (Optional) Specifies the descriptor file for the package.
    -dm deploymentMode Sets the deployment mode. The mode determines how deployment handles the objects in a deployment unit and package. Allowed values are:
    • UPDATE – updates the target package with updated objects. After deployment, objects in the server's package with the same name as those being deployed are updated.
    • NOCLOBBER – deploys the package only if there are no objects in the target server's package that have the same name as any of those objects being deployed.
    • REPLACE – replaces any of the target objects with those in the package. After deployment, the servers package contains only those objects being deployed.
    • VERIFY – do not deploy package. Only return errors, if any. Used to determine the results of the UPDATE deploy mode.
    -file deploymentUnitFileName Defines the file name of the deployment unit. For example, MyDeployUnit.xml.
    -rm roleMapping
    Defines the role mapping for the package. Accepted values are:
    • role1=AUTO – the logical role defined in the package.
    • role2=SUPAdmin,SUPUser – the physical roles defined in the security provider.

    The role mapping -rm role1,role2 maps the logical roles of the package to the physical roles in the server.
    -sc securityConfig Defines the security configuration for the package. Select an existing security configuration from the domain to which the package will be deployed.
    -sl Enables silent mode, which disables all user interactive questions during package deployment. During silent mode, the default values for each option are used. This mode is mainly used when writing a batch executing file. For example, the command line deploy -file deployunit.xml -sl deploys the package to the default domain with a deploy mode of UPDATE and a sync mode of REPLICATION, without asking for user confirmation.
    -sm syncMode Defines the synchronization mode for the package; either MBS for messaging-based synchronization, or REPLICATION for replication-based synchronization.

Examples

  • Basic Example – This command updates an existing deployment unit called samples/uep/deployment/customer_list_unit.xml. The batch file uses default values for all other command line options: 
    deploy   -file samples/uep/deployment/customer_list_unit.xml -dm UPDATE -sl
Parent topic: Package Administration Utilities