Siebel Application Deployment Manager Guide > Deploying an ADM Package > Administering the ADM Deployment Execution >

Reviewing an ADM Deployment's Status


This topic describes the Application Deployment Manager (ADM) command-line interface commands that provide a status of the ADM deployment at either the server, group, or unit level or provides feedback on the history of the deployment.

The following topics describe the various status reporting commands of the ADM command-line interface:

Reviewing the Status of an ADM Deployment Session

This command or combination of commands provides feedback on the progress of the ADM deployment session at various levels.

To review the status summary of an ADM deployment session

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name status 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 displays a summary of the deployment status of a package.

To review the status detail of an ADM deployment session

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name status_detail username password package_name

    This command displays the following deployment status details of a package:

    • Package name
    • Siebel Enterprise Server name
    • Session number
    • Session status
    • Session execution status
    • Total number of units
    • Total units completed
    • Total units not started
    • Total units failed
    • Total units running

To review the errors encountered during an ADM deployment session

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name status_error username password package_name

    This command displays the error status of the package.

To review the history of deployment sessions based on an ADM package

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name history username password package_name

    This command displays the history of all the commands run on that particular package during that particular session.

Creating an ADM Deployment Report

This command creates a report, in the form of an HTML file, detailing the performance of the ADM deployment session, including success or failure information for each database unit.

To create an ADM deployment session report

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name report 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.

The ADM framework has several logging features that document the ADM deployment process in case of incorrect deployment or other issues. For more information on troubleshooting or logging, see ADM Logging Capabilities and Troubleshooting.

Creating a Destination Map for File Directories

This command creates a report that lists the files that are deployed to the target environment. It also lists the server to which each files was deployed. The default filename for this report is mapfile.xml, which is located in the Siebel_Management_Server_Root\log directory. The filename and location can be changed by modifying the value of the ADM_MAP_FILE parameter in the deploy.bat file.

This command uses several switches, as described in Table 10. To modify the switches, edit the deploy.bat file.

Table 10. Switches Used While Creating a Destination Map
Switch
Description
Mandatory or Optional

-f

Function, uses genmap as its value.

 

Mandatory

-a

All, lists all files that are deployed (including those that failed).

 

Optional

-filename

Filename, specifies XML output filename. Default filename is mapfile.xml.

Mandatory

-p

Package, specifies the package name.

Mandatory

-en

Enterprise name, specifies the Siebel Enterprise Server name.

Mandatory

To create a destination map of only those files that are successfully deployed

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name genmap 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.

To create a destination map of all files that are deployed (including those that failed)

  • At the ADM command-line prompt, enter:

    deploy_enterprise_name genmap_all 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.
Siebel Application Deployment Manager Guide Copyright © 2007, Oracle. All rights reserved.