Bookshelf Home | Contents | Index | PDF     

Siebel Application Deployment Manager Guide > Deploying an ADM Package >

Deploying and Activating an ADM Package

Deploying and activating an Application Deployment Manager (ADM) package is a step in Process of Deploying an ADM Package. This task represents the migration and activation of the customizations for use in the target environment. This task uses the ADM command-line interface program. For information on this tool, see About the ADM Command-Line Interface Syntax.

Perform the commands in the following tasks to deploy and activate an ADM package:

  1. Creating an ADM Deployment Session
  2. Validating an ADM Deployment Environment
  3. Deploying an ADM Deployment Session
  4. Activating an ADM Deployment Session
  5. (Optional) Deploying and Activating an ADM Deployment Session

Several optional command-line flags further define the deployment and activation activities and are described in Table 8.

Table 8. Optional Command-Line Flags While Deploying and Activating ADM Packages
Flag
Description

-async

Performs the command in asynchronous mode. The copy command returns immediately after issuing the command, but the actual deployment runs in the background. To check the status of the deployment, use the status_detail command. For more information on this command, see Reviewing an ADM Deployment's Status.

-activateonly

Specifies that this package is for activation only.

-ignore_validation_errors

Ignores validation errors output and continues the command.

-syncstatus

Updates the status of the deployment execution if any system errors occur that cause the status reporting on the ADM framework to lose the connection with the target Siebel Enterprise Server.

-t

Acts as a category filter on the ADM package when used with the arguments file, database, or repository.

-fileservers

Deploys the package to only a subset of Siebel Servers within any Siebel Enterprise Server when used with a staged deployment on file servers. Takes the agent name, defined in the enterprise profile, as the argument.

 

Additionally, there are several administrative commands that might be necessary to run during the deployment task, including starting and stopping the deployment, restoring the previous application customizations, and reviewing deployment status and reports. For more information on these commands, see Administering the ADM Deployment Execution.

Creating an ADM Deployment Session

This command creates an ADM deployment session record, which represents the application customizations that are ready for migration based on the ADM package and enterprise profile referenced at that particular time.

To create an ADM deployment session

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name create username password package_name

    where:

    • enterprise_name is the name of the Siebel Enterprise Server.
    • username is the Siebel user name.
    • password is the Siebel password.
    • package_name is the name of the XML ADM package file.

      This command can also use the following optional flags: -activateonly and -ignore _validation_errors. For more information on these flags, see Table 8.

Validating an ADM Deployment Environment

This command validates the run-time deployment environment by checking the following:

  • The schema version of the source environment (source of files) is compatible with the target environment (major schema version must match).
  • The ADM agents designated to receive the commands are online.
  • The Siebel Servers in the Siebel Enterprise Server referenced in the profile are online.

    NOTE:  The ADMProc server component must be enabled and running on each Siebel Server.

To validate an ADM deployment environment

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name validate username password package_name

    where:

    enterprise_name is the variable for the name of the Siebel Enterprise Server.

    username is the variable for Siebel user name.

    password is the variable for Siebel password.

    package_name is the variable for the name of the XML ADM package file.

    Only errors are returned to the command-line interface.

Deploying an ADM Deployment Session

This command updates the target environment with the application customizations defined by the ADM package and represented by the previously created deployment session.

NOTE:  To redeploy the same ADM package, you must acknowledge that session and create a new session to deploy the ADM data. For information on these tasks, see Acknowledging an ADM Deployment and Creating an ADM Deployment Session.

To deploy an ADM deployment session

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name copy username password package_name

    where:

    • enterprise_name is the name of the Siebel Enterprise Server.
    • username is the Siebel user name.
    • password is the Siebel password.
    • package_name is the name of the XML ADM package file.

      This command can also use the following optional flags: -t, -fileserver, -async, and -ignore _validation_errors. For more information on these flags, see Table 8.

Activating an ADM Deployment Session

This command activates, if possible, the new application customizations in the target environment.

To activate an ADM deployment session

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name activate username password package_name

    where:

    • enterprise_name is the name of the Siebel Enterprise Server.
    • username is the Siebel user name.
    • password is the Siebel password.
    • package_name is the name of the XML ADM package file.

      This command can also use the following optional flags: -t, -fileserver, -async, and -ignore _validation_errors. For more information on these flags, see Table 8.

Deploying and Activating an ADM Deployment Session

This combination command can be used as an alternative to running the deploy (copy) and activate commands separately. It updates the target environment with the application customizations defined by the ADM package and represented by the previously created deployment session. This command also activates, if possible, the new application customizations in the target environment.

To deploy and activate an ADM deployment session

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name copy_activate username password package_name

    where:

    • enterprise_name is the name of the Siebel Enterprise Server.
    • username is the Siebel user name.
    • password is the Siebel password.
    • package_name is the name of the XML ADM package file.

      This command can also use the following optional flags: -t, -fileserver, -async, and -ignore _validation_errors. For more information on these flags, see Table 8.

  
Siebel Application Deployment Manager Guide Copyright © 2007, Oracle. All rights reserved.