DEPLOY Command

  • Article

AC DEPLOY allows you to manage deployment tasks associated with a cluster. You can deploy applications from a cluster controller or cluster member. AC DEPLOY allows you to:

  • Deploy Application Center applications.

  • List deployments.

  • Synchronize a cluster.

  • Enable or disable automatic synchronization to specific cluster members.

  • Terminate a deployment job.

Usage

The following lines illustrate the different ways of using the AC DEPLOY command:

   
AC DEPLOY   /START
            [/DEPNAME:depname]
            [/SOURCE:sourcename
            /SOURCEUSER:username /SOURCEPASSWORD:*|pwd]
            [/TARGETS:targetname1[,...]
            /TARGETUSER:username /TARGETPASSWORD:*|pwd]
            [/APPNAME:appname1[,...] | /APPGUID:appguid1[,...]]
            [/NOACL]
            [/COMPLUS]
            [/WAIT] 
    
AC DEPLOY   /LISTDEPLOYMENTS
            [/SOURCE:sourcename]
            [/SOURCEUSER:username /SOURCEPASSWORD:*|pwd]

AC DEPLOY   /TERMINATE
            {/JOBID:jobid | /DEPNAME:depname}
            [/SOURCE:sourcename
            /SOURCEUSER:username /SOURCEPASSWORD:*|pwd]

AC DEPLOY   /ENABLESYNC
            [/SOURCE:sourcename
            /SOURCEUSER:username /SOURCEPASSWORD:*|pwd]

AC DEPLOY   /DISABLESYNC
            [/SOURCE:sourcename
            /SOURCEUSER:username /SOURCEPASSWORD:*|pwd]

AC DEPLOY   /STATUS[:All]
            [/SOURCE:sourcename
            /SOURCEUSER:username /SOURCEPASSWORD:*|pwd]

Parameters

Parameter

Description

/START

Starts the deployment job.

/DEPNAME:depname

Specifies a friendly name for the deployment.

/SOURCE:sourcename

Specifies the source (the cluster controller or cluster member) for deployment. Also specifies the member on which to enable or disable automatic synchronization or obtain status. If you want to authenticate on the source computer, use the /SOURCEUSER and /SOURCEPASSWORD options with /SOURCE. If omitted, the source is assumed to be the local computer.

/SOURCEUSER:username

Specifies the user name to use for credentials when authenticating on the source computer, which can be supplied as "domain\username".

/SOURCEPASSWORD:*|pwd

Specifies the password to use for credentials when authenticating on the source computer.

/TARGETS:targetname1[,...]

Specifies a list of targets on which to deploy the specified applications.

Bb687319.note(en-us,TechNet.10).gif Note   If this parameter is omitted, the application will be deployed to the members of the source cluster.

/TARGETUSER:username

Specifies the user name to use for credentials when authenticating on the target computer, which can be supplied as "domain\username".

/TARGETPASSWORD:*|pwd

Specifies the password to use for credentials when authenticating on the target computer.

/APPNAME:appname1[,...]

Specifies a list of applications to deploy (by application name). If no applications are specified, the command will deploy all applications from the source.

/APPGUID:appguid1[,...]

Specifies a list of applications to deploy (by application GUID). If no applications are specified, the command will deploy all applications from the source.

/NOACL

Specifies that Access Control Lists (ACLs) should not be deployed. ACLs are deployed by default.

Bb687319.note(en-us,TechNet.10).gif Note   ACLs are not deployed on partitions that do not support ACLs (for example, FAT), or in non-domain configurations.

/COMPLUS

Specifies that COM+ applications should be deployed as part of the deployment job.

/WAIT

Indicates that the deployment should happen synchronously; that is, the command should not return until the deployment is complete. The default behavior is asynchronously; that is, the command returns immediately.

/LISTDEPLOYMENTS

Lists the current ongoing deployment jobs and their identifiers, which have been started on the source computer.

/TERMINATE

Terminates the deployment job. This parameter requires execution confirmation.

/JOBID:jobid

Specifies the job identifier of the deployment job to terminate. This parameter requires execution confirmation.

/ENABLESYNC

Turns on synchronization for the specified cluster member. This places it in the synchronization loop. This parameter is not allowed if the cluster controller is specified as the source.

/DISABLESYNC

Turns off synchronization for the specified cluster member, taking it out of the synchronization loop. This parameter is not allowed if the cluster controller is specified as the source. This parameter requires execution confirmation.

/STATUS[:All]

Displays the current deployment-related status information. If :All is specified, status is given for all members.

Samples

The following example shows how to deploy applications app1, app2, and app3 from controller0 to server1 and server2.

AC DEPLOY /START /SOURCE:controller0 /TARGETS:server1,server2 
/APPNAME:app1,app2,app3 /SOURCEUSER:dba018 /SOURCEPASSWORD:********
/TARGETUSER:dba018 /TARGETPASSWORD:**********

Did you find this information useful? Please send your suggestions and comments about the documentation to acdocs@microsoft.com.