9 Uninstalling Oracle AIA

This chapter discusses how to uninstall the Oracle Application Integration Architecture (Oracle AIA) pre-built integrations.

About Uninstalling Pre-Built Integrations

Uninstalling Oracle AIA involves the following tasks:

  1. Back up the Oracle AIA home directory and any customized Oracle AIA artifacts in the enterprise object library. This includes customizations to:

    • Enterprise Business Objects (EBOs), including custom XSD files in the following directories:

      • Install_home/comms_home/source/soainfra/apps/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/EBO/

      • Install_home/comms_home/source/soainfra/apps/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Industry/Industry_Name/Custom/EBO

    • Extensible style sheet language transformations (XSLTs)

    • Enterprise Business Services (EBS) Web Service Definition Language (WSDL)

    • Any EBS with custom routing rules

    • The AIAConfigurationProperties.xml file.

  2. Undeploying pre-built integrations using scripted undeployment plans. See "Undeploying Pre-Built Integrations".

  3. Uninstalling Oracle AIA.

    Uninstalling Oracle AIA removes everything in the Oracle AIA home directory. Although you can undeploy an individual pre-built integration from the server, you cannot uninstall an individual pre-built integration option. You uninstall all pre-built integration options together.

  4. Cleaning the environment. See "Cleaning the Environment".

  5. Verifying the uninstallation. See "Verifying Uninstallation".

Undeploying Pre-Built Integrations

To undeploy a pre-built integration from the server:

  1. Navigate to the following directory:

    Install_home/comms_home/bin

  2. Run one of the following commands:

    • On UNIX:

      source commsenv.sh
      
    • On Windows:

      source commsenv.bat
      

    This command sources the aiaenv script and sets the COMMS_HOME environment variable to Install_home/comms_home.

  3. Navigate to the following directory:

    Install_home/comms_home/pips/Communications

  4. Run one of the commands listed in Table 9-1, depending on your platform and the pre-built integration you are undeploying.

    Table 9-1 Pre-Built Integration Undeployment Commands

    Pre-Built Integration Platform Command

    Order to Cash

    UNIX

    Order to Cash base:

    sh $COMMS_HOME/pips/Communications/O2CBase/Deployments/undeployO2CBase.sh
    

    Order to Cash for Siebel CRM:

    sh $COMMS_HOME/pips/Communications/Deployments/O2CSiebel/undeployO2CSiebel.sh
    

    Order to Cash for BRM:

    sh $COMMS_HOME/pips/Communications/O2CBRM/Deployments/undeployO2CBRM.sh
    

    Order to Cash for OSM:

    sh $COMMS_HOME/pips/Communications/O2COSM/Deployments/undeployO2COSM.sh
    

    Order to Cash

    Windows

    Order to Cash base:

    %COMMS_HOME%\pips\Communications\O2CBase\Deployments\undeployO2CBase.bat
    

    Order to Cash for Siebel CRM:

    %COMMS_HOME%\pips\Communications\O2CSiebel\Deployments\undeployO2CSiebel.bat
    

    Order to Cash for BRM:

    %COMMS_HOME%\pips\Communications\O2CBRM\Deployments\undeployO2CBRM.bat
    

    Order to Cash for OSM:

    %COMMS_HOME%\pips\Communications\O2COSM\Deployments\undeployO2COSM.bat
    

    Agent Assisted Billing Care

    UNIX

    sh $COMMS_HOME/pips/Communications/AABC/DeploymentPlans/undeployAABC.sh
    

    Agent Assisted Billing Care

    Windows

    %COMMS_HOME%\pips\Communications\AABC\DeploymentPlans\undeployAABC.bat
    

    Product MDM

    UNIX

    Product Master Data Management Base:

    sh $COMMS_HOME/pips/MDMProductPIM/DeploymentPlans/undeployPIM.sh
    

    Product Master Data Management for Siebel CRM:

    sh $COMMS_HOME/pips/MDMProductSiebel/DeploymentPlans/undeploySiebel.sh
    

    Product Master Data Management for BRM:

    sh $COMMS_HOME/pips/MDMProductBRM/DeploymentPlans/undeployMDMProductBRM.sh
    

    Product Master Data Management for PDC:

    sh $COMMS_HOME/pips/MDMProductPDC/DeploymentPlans/undeployMDMProductPDC.sh
    

    Product Master Data Management for Design Studio:

    sh $COMMS_HOME/pips/MDMProductDS/DeploymentPlans/undeployDS.sh
    

    Product Master Data Management Routing Rules:

    sh $COMMS_HOME/pips/MDMProduct/DeploymentPlans/undeployEBS.sh
    

    Product MDM

    Windows

    Product Master Data Management Base:

    %COMMS_HOME%\pips\MDMProductPIM\DeploymentPlans\undeployPIM.bat
    

    Product Master Data Management for Siebel CRM:

    %COMMS_HOME%\pips\MDMProductSiebel\DeploymentPlans\undeploySiebel.bat
    

    Product Master Data Management for BRM:

    %COMMS_HOME%\pips\MDMProductBRM\DeploymentPlans\undeployMDMProductBRM.bat
    

    Product Master Data Management for PDC:

    %COMMS_HOME%\pips\MDMProductPDC\DeploymentPlans\undeployMDMProductPDC.bat
    

    Product Master Data Management for Design Studio:

    s%COMMS_HOME%\pips\MDMProductDS\DeploymentPlans\undeployDS.bat
    

    Product Master Data Management Routing Rules:

    %COMMS_HOME%\pips\MDMProduct\DeploymentPlans\undeployEBS.bat
    

    A message showing uninstallation progress appears. A success message is displayed when uninstallation is complete.

  5. Restart the server.

  6. Uninstall Oracle AIA following the instructions in the "Uninstalling Oracle AIA".

Uninstalling Oracle AIA

To uninstall Oracle AIA:

  1. Navigate to the following directory:

    Install_home/oui/bin

  2. Run one of the following commands:

    • On UNIX:

      sh deinstall.sh
      
    • On Windows:

      deinstall.cmd
      

    The Welcome screen of the Oracle AIA Uninstaller appears.

  3. Review list of components to be uninstalled and click Next.

    The Uninstallation Summary screen appears.

  4. Review the home directory that will be cleared and the log file location and click Uninstall.

    The Uninstallation Progress screen appears.

  5. Wait for the progress bar to reach 100% and click Next.

    The Uninstallation Complete screen appears.

  6. Review the information and click Finish.

  7. Clean the environment as described in "Cleaning the Environment".

Note:

The Uninstaller does not list which pre-built integration options are uninstalled on the Uninstallation Summary or Uninstallation Complete screens.

All options are uninstalled.

Cleaning the Environment

Cleaning the environment involves the following tasks:

  1. Removing Oracle AIA Artifacts from the WebLogic Server

  2. Deleting Oracle AIA Files

  3. Deleting Oracle AIA Metadata

  4. Deleting Oracle AIA Security Policies

Note:

If you plan to reinstall Oracle AIA, you must use a newly-created domain. Do not reuse a domain from which Oracle AIA was uninstalled.

Removing Oracle AIA Artifacts from the WebLogic Server

To remove Oracle AIA artifacts from the WebLogic server:

  1. Log in to the Oracle WebLogic Server Administration Console.

  2. From the Domain Structure panel, select Deployments.

    The Summary of Deployments page appears.

  3. If any Oracle AIA deployments appear, such as AIAHomeApp, select the check box beside the deployment and click Delete.

  4. From the Domain Structure panel, expand Services and select Data Sources.

  5. If any Oracle AIA data sources appear, such as AIADataSourceDS, select the check box beside the data source and click Delete.

  6. From the Domain Structure panel, expand Services, expand Messaging, and select JMS Modules.

  7. If any Oracle AIA JMS modules appear, such as AIAJMSModule, select the check box beside the module and click Delete.

  8. From the Domain Structure panel, select Security Realms.

  9. From the list of security realms, select myrealm.

  10. Select the Users and Groups tab.

  11. Select the check box beside any Oracle AIA users, such as AIAIntegrationAdmin, and click Delete.

  12. Select the Groups tab.

  13. Select the check box beside any Oracle AIA groups and click Delete. The default Oracle AIA groups to delete include the following:

    • AIAApplicationUser

    • AIAMappingCustomizer

    • AIAResubmissionAdmin

  14. Shut down the managed server on which Oracle AIA is deployed.

  15. Shut down the administration server for the cluster.

    After shutting down the administration server, the Administration Console is no longer available.

  16. Start the administration server for the cluster.

    See Oracle Fusion Middleware Administering Server Startup and Shutdown for Oracle WebLogic Server for information about how to start the administration server using a script, a Java command, or WebLogic Scripting Tool.

  17. Log in to the WebLogic Server Administration Console.

  18. From the Change Center panel, select View changes and restarts.

  19. Select any changes in the table and click Activate Changes.

  20. Restart the managed server.

Deleting Oracle AIA Files

To delete any remaining Oracle AIA files:

  1. On the system where you uninstalled Oracle AIA, navigate to the domain_home directory.

  2. Delete the edit.lok file.

  3. Navigate to the domain_home/pending directory.

  4. Delete all files in this directory.

  5. Restart the managed server from which you undeployed the prebuilt integrations.

  6. Navigate to the Oracle AIA home directory and delete any remaining files.

Deleting Oracle AIA Metadata

To delete the Oracle AIA metadata:

  1. Navigate to the SOA_home/common/bin directory.

  2. From the command line, run one of the following commands:

    • On Linux:

      wlst.sh
      
    • On Windows:

      wlst.cmd
      

    The WebLogic Scripting Tool (WLST) starts.

  3. Run the following command:

    connect('username', 'password', 'server:port')
    

    where:

    • username and password are the user name and password for the WebLogic Server administration user

    • server and port are the address and port of the managed server to which Oracle AIA was deployed

    WSLT connects to the managed server.

  4. Run the following command:

    domainConfig()
    

    WLST navigates to the domainConfig directory of the domain.

  5. Run the following command:

    deleteMetadata(application='soa-infra', server='server', docs='/apps/AIAMetaData/**')
    

    where server is the SOA server or managed server to which Oracle AIA was deployed.

    WSLT deletes the Oracle AIA metadata from the server.

For more information about WLST commands, see Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

Deleting Oracle AIA Security Policies

To delete Oracle AIA security policies:

  1. Log in to Oracle Enterprise Manager Fusion Middleware Control.

  2. Expand WebLogic Domain.

  3. Right-click the node for your SOA domain.

  4. Select Web Services then select WSM Policies.

  5. Select the following policies and click Delete.

    • oracle/aia_wss_saml_or_username_token_service_policy_OPT_ON

    • oracle/aia_wss_saml_or_username_or_http_token_serivce_policy_OPT_ON

    • oracle/aia_wss10_saml_token_client_policy_OPT_ON

Verifying Uninstallation

To verify uninstallation:

  1. Log in to Oracle Enterprise Manager Fusion Middleware Control.

  2. In the Target Navigation pane, expand the SOA folder, then soa-infra, then default.

  3. Verify that no Oracle AIA composites appear.