Skip to Content

Purpose

The purpose of this document is to list steps to undeploy Software/ Development component on NetWeaver Java release 7.0x(7.00, 7.01, 7.02).

Use Case

Custom Software/ Development components have been deployed in system. During system upgrade, SUM or other upgrade tool could not continue upgrade saying these custom Software/ Development components can not be handled by upgrade tool. Under this situation, you can follow this document to manually undeploy custom Software/ Development components before upgrading.

NOTE: Undeployment as such is not supported and should be used only in cases where the SAP Basis admin is well versed with the system landscape and the repercussions of this activity very well. If unknowingly a component is deployed, the best option would be to restore the system to the previous state it was before the deployment was triggered. Hence, you should always take a full offline backup before commencing deployment.

Step1

Check out all Development Components that belong to the Software Components that need to be undeployed together.

1. Access http://<hostname>:<port>/sap/monitoring/SystemInfo, then click link “all components…“.

2. Suppose want to undeploy Software Component DI_CBS, DI_CMS, DI_DTR.

Note: Undeployment of SAP standard Software/ Development components is very risky operation.

This document only use these Software/ Development components as example.

Please do not do such undeployment in real system.

SCA_need_undeployment.png

3. Check “Development Components” section for all entries that has “Software Component” with value DI_CBS, DI_CMS DI_DTR.

DC_of_DI_CMS.png

DC_of_DI_DTR.png

Step2
1. Create xml file to list all Development Components identified in Step1 with format like below. Make sure no extra space and exact upper/lower case.

———————————————-

<Components>

<DevelopmentComponentLine name=”dev_comp1_name” vendor=”vendor1_name”></DevelopmentComponentLine>

<DevelopmentComponentLine name=”dev_comp2_name” vendor=”vendor2_name”></DevelopmentComponentLine>

……

</Components>

———————————————

For example:

———————————————

<Components>

<DevelopmentComponentLine name=”tc.CBS.Appl” vendor=”sap.com”></DevelopmentComponentLine>

<DevelopmentComponentLine name=”tc.CBS.CommonPart” vendor=”sap.com”></DevelopmentComponentLine>

……

</Components>

——————————————-

2. Stop SDM node, then modify it to standalone mode.

/wp-content/uploads/2016/06/sdm_standalone_967074.png

3. Undeploy Development Components using command: sdm undeploy “list=<xml file location>” “undeploydb=yes”

/wp-content/uploads/2016/06/sdm_undeployment_967076.png

If undeployment successfully finished, “Return code: 0” message show up as below image.

If any error happen, error detail can be seen in newest sdmlog*.log in usr/sap/<SID>/<xx>/SDM/program/log.

/wp-content/uploads/2016/06/undeployment_ok_967077.png

4. Once undeployment successfully finished, set SDM back to integrated mode and start it manually.

/wp-content/uploads/2016/06/sdm_integrated_967078.png

/wp-content/uploads/2016/06/sdm_integrated_ok_967079.png

Step3

Access http://<hostname>:<port>/sap/monitoring/SystemInfo again, and confirm indeed Software/ Development components that want to undeployed are not show there anymore.

/wp-content/uploads/2016/06/status_after_undeployment_967085.png

Note:

For step 1, sometimes in ‘Development Components’ section there are items have ‘Software Component’ column with value like null/null, in such situation, it is not possible to identify the relationship between software component and development component. See following image as an example:

In this situation, please use following way to determine the relationship between software component and development component.

1. Start SDM GUI and log in with SDM password. If SDM password is unknown, refer to SAP KBA  1910179 – How to change password of SDM to reset it. Then click button shown in SDM Repository tab as shown in following image.

2. Right click each development component and choose option ‘Show information about SDA/SCA’. Then you will get a popup showing the development component name with ‘Name’ field and its vendor with ‘Vendor’ field. These are the information will be used when construct XML file for undeployment.

To report this post you need to login first.

3 Comments

You must be Logged on to comment or reply to a post.

  1. Tom Xing

    Hi Amy,

    Nice post!

    Follows a question 🙂

    Afaik, undeployment on AS Java is hardly suggested.

    Consider this situation: Software Component A has dependency on SC B, and nothing depends on A.

    Is there going to be an error if we undeploy B directly, while A is still in the system?

    Or is there a way to check dependency, to make the undeployment a bit “safer”?

    BR, Tom

    (0) 
    1. Amy Lv Post author

      Hi Tom,

      Good question!

      Undeployment will check dependency of Development component. For your situation, If undeploy B , error will occur saying A is not selected to undeploy. Example error log:

      —————————————————

      Info: Select development component A for undeployment

      Error: Deployment A cannot be undeployed:

      Error: Deployment B is not selected

      —————————————————

      This error log can be seen in newest sdmlog*.log in usr/sap/<SID>/<xx>/SDM/program/log

      Cheers,

      Amy

      (0) 

Leave a Reply