Skip to Content

I often receive questions from both customers and consultants experiencing similar issues with the Enterprise Services Repository (ESR) and Services Registry (SR). This blog aims to point out some of the common issues encountered with the ESR/SR and provide you with a list of solutions.   After working with the ESR/SR for some time now I have come to the conclusion that there are only a handful of problems that people encounter. My goal is that this blog will equip you with the answers and help you get the ESR/SR up and running in your environment and make you look like a hero.


Please note that this blog should not be used as a replacement for the CE master installation and upgrade guides.


First let me prefix the discussion by saying that this blog only deals with the ESR and SR as it relates to the Netweaver Composition Environment CE SP3 and SP4.  Keep in mind that for SP3 and SP4 the ESR comes bundled as a separate installation – it is not part of the basic CE installation. Starting with SP5 the ESR will be fully integrated and part of the CE installation.

As a introduction let me set the stage by briefly mentioning the differences between the ESR and the SR. The ESR contains the metadata of your enterprise services, the meta data consists of artifacts like process component models, service interfaces, operations, message types and data types. All of the meta data is manipulated through a modeling tool that is referred to as the Enterprise Services Builder (ESB). Keep in mind that the ESR contains only unimplemented services that do not have endpoints. This is where the Services Registry comes into play. Once the enterprise service is implemented in either a ABAP or Java system it can then be published to the SR with an endpoint and made publicly available to anyone that would like to consume that enterprise service. 

With that said let’s jump into the details with a quick re-cap of the 3 vital configuration steps that need to be completed after the ESR is installed. They are the SLD, SR and ESR configuration wizards found within the Netweaver Administrator (NWA > Configuration Management > Scenarios > Configuration Wizard). The wizards will do the initial setup of the mentioned components so that you do not have to do it manually. Without first running these wizards you will be really disappointed with the product as you will have a hard time getting everything to work properly.

The following is a list of common issues that you may encounter.

1) ESR Configuration Wizard fails (Issue valid for SP3 & SP4)

The configuration wizard fails near the end when trying to import XI content with the following error message.  “Connection to system Integration Builder using application CMS-Transport lost”

  • When asked how to proceed select “Skip step” and wait for the wizard to finish.
  • Refer to note 1004684 to increase the timeout and maxlocks settings then proceed to execute the Wizard again.  If you continue to encounter the same error or if you are not able to execute the Wizard again proceed with the following manual steps. 
  • Simply import the XI objects manually through the Enterprise Services Builder (ESB).
  • Once logged into the ESB (http://servername:port/rep > Enterprise Services Builder), from the tools menu select > Import Design Objects > Client
  • Then point to this directory where the file is located \usr\sap\CE1\SYS\global\xi\content\XI7_1_SAP_BASIS.tpz
  • Proceed to Import the file. Be patient as this may take some time. 

XI content is not delivered in the standard SAP patches format but rather in an archive (.tpz) like all other XI content. Here is location where to download XI content for the ESR: Service Market place > Software Download > Download > Support Packages and Patches > Enter by Application Group > Netweaver > SAP Netweaver > SAP Netweaver CE 7.1 > ESR FOR SAP NETWEAVER CE 7.1 > XI CONTENT SAP_BASIS 7.10


2) ESR Configuration Wizard fails (Issue valid for SP4)

The configuration wizard fails near the end with the following error message: not found. 

  • When asked how to proceed select “Skip step” and wait for the wizard to finish.
  • Refer to note 1144861.
  • Although the Configuration Wizard cannot trigger the import of the XI content, you can still import the XI content manually.
  • Proceed to import the XI content as discussed in issue 1, however please make sure to import the SP4 Basis content objects.
  • Download the SP4 (XI CONTENT SAP_BASIS) from Service Market Place, unzip the file and import the .tpz file into the ESB as described in issue 1 & 7


3) Enterprise Services do not get published to the Services Registry (Issue valid for SP3 and SP4)

After creating a public restriction within (NWA > SOA Management > Business Administration > Public Restrictions)  the services do not appear within the Services Registry. 

  • Check the ServiceRegistrySi port setting, the port is automatically set to 50100. Change the setting to reflect your java node port. Also select basic authentication and supply a valid username and password. NWA > SOA Management > Business Administration > Web Service Administration > Select Proxy Definition Name > Click Go. Select ServiceRegistrySi > Click on the Configuration Tab > Click on the Logical Ports Tab > Select ServicesRegistrySiPort > Click Edit to change the WS Endpoint URL field.
  • Verify that the enterprise service is started. NWA > Configuration Management > Infrastructure > Application Modules > Start & Stop Java EE Applications
  • If you cannot find the service verify that the enterprise service is deployed within the Web Services Navigator. (http://servername:port/wsnavigator)
  • If the enterprise service is not deployed proceed to deploy it again.

Please note the 5 minute window before services will appear in the Services Registry. 


4) Enterprise Services Builder startup fails (Issue valid for SP3 and SP4)

You cannot start or load the ESB Java Web Start client application; after you click on the link you get one of the following error: “Unable to launch ESR”, or “Checking for updates”, or, “An error occurred while launching/running the application“, or “JAR Resources in JNLP File are not signed by same Certificate”

Quick fix temporary Solution
  • Remove any ESB client applications from within Web Start.
  • For Windows open Java Web Start. You can use this short cut: Start > Run (and type) javaws (or javaws -viewer for JRE 1.6x+)
  • Remove all/any ESR Web Start Applications
Permanent Solution
  • Open the default ESR start page located at http://servername:port/rep
  • Click on the Administration link in the right top corner and logon
  • Select Java Web Start Administration
  • Click on the second option “Restore Archives and Generate Signature”
  • Then click on the JNLP File Url Link (Actually make sure you click the Execute link)
  • Wait 10-20 minutes for the JAR files to re-generate 


5) Enterprise Services Builder displays an error message – BASIS Missing (Issue valid for SP3 and SP4)

Just before the ESB loads you may see an warning: “system does not contain software component version SAP Basis 710 (SAP_BASIS_710_Missing)”.

  • Perform manual XI import as discussed in issue 1 for SP3/4.
  • Perform manual XI import as discussed in issue 8 for SP4.


6) ESR Modeler does not add any operations to the Service Interface (Issue valid for SP3)

You model your business process and drag operation elements into the modeler. Unfortunately when you view your service interface the operations are not there.  You may also encounter an error message when trying to double click on each assignment within the model.

This is a known issue with SP3 – unfortunately you cannot create operations from within the modeler. This issue is solved in SP4

  • The work around is to manually re-create the operations within the Service Interface.
  • Or if you are on SP4 simply download this file (SAPBASIS Content for SP4) from service marketplace.
  • Then unzip the file and import the .tpz file into the ESB as described in issue 1. 


7) SP4 XI Basis objects are missing (Issue valid for SP4)

After performing the SP4 Upgrade the XI Basis Objects still shows SP3 in the ESB

  • Download the SP4 Basis content (XI CONTENT SAP_BASIS) from service marketplace
  • Unzip the file and import the .tpz file into the ESB as described in issue 1 


8) Cannot create ESR models as model types are missing (Issue valid for SP3 and SP4)

Within the ESB when trying to create a model the model types drop down list is empty, for example the SAP Procomp model is not present.

  • Import the XI Basis objects as described in issue 1, depending on your SP level please import the correct XI CONTENT SAP_BASIS file.


9) Enterprise Services Builder fails to connect to SLD (Issue valid for SP3 and SP4)

When browsing the SLD from within the ESB you get an authorization exception error

  • Check user permissions for user ESRSLD, the user needs to have 2 roles assigned: SAP_XI_IR_SERV_USER & SAP_SLD_CONFIGURATOR


10) Fail to see local development objects from outside of ESR (Issue valid for SP3 and SP4)

You created a local component that contains your model and service interfaces using the ESB. When trying to query the ESR from either the ABAP workbench or Netweaver Developer Studio you do not see your Service Interfaces.

Local development objects are not visible to the outside world. Rather add your model to a software component that resides within the SLD. 

  • Create a software component in the SLD.
  • Then within the ESB > from the Object menu select > New > Work areas > Software Component > Import from SLD > Display > Select your Software Component.

Please remember that you might have to clear the SLD cache from within the ESB if you do not see your software component.    


11) ESR and SLD configuration templates options are missing in the Netweaver Administrator (Issue valid for SP4)

You do not see the options to execute either the SLD or ESR configuration wizards.

  • Refer to this SAP note: 1119841 
  • Also verify that the Usage Type for the ESR is available on your system by going to this URL: http://server:port/utl/UsageTypesInfo. There should be a table entry for the ESR.
  • If not then proceed to install the ESR (obtained by downloading from Service Market place > Software Download > Download > Support Packages and Patches > Enter by Application Group > Netweaver > SAP Netweaver > SAP Netweaver CE 7.1 > ESR FOR SAP NETWEAVER CE 7.1 > ESR 7.10)
  • Once that is done verify that you have the latest LMCFG SCA file deployed, if not proceed to download and deploy the latest LMCFG SCA file from Service Market place as described in the note 1119841. Once this file is deployed the configuration options for the SLD and ESR can be seen within the Configuration Wizard.


12) Enterprise Services Builder startup fails (Issue valid for SP4) 

You get the following error message when trying to load the ESB: Unable to read configuration data (ExchangeProfile/

  • Download latest SP4 patches from Service Marketplace. Specifically make sure that you have the latest ESP_FRAMEWORK and ES UDDI SCA files. (Service Market place > Software Download > Download > Support Packages and Patches > Enter by Application Group > Netweaver > SAP Netweaver > SAP Netweaver CE 7.1 > Entry by Component > (Composite Applications & Java Application Server)
  • If this is a development server, make sure the CE_Complete_Stack_development_full template is active.  NWA > Configuration Management > Infrastructure > Java System Properties
  • You can change the template within the Config tool. File > Change System Template.
13) Importing XI Objects manually into the ESR fails (Issue valid for SP3 & SP4) 

When trying to load XI Objects manually into the ESR using the ESB you see this error: Too many locks

  • Refer to note 1004684 to increase the maximum locks database settings. 
To report this post you need to login first.


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

  1. Jian Yang
    Please forgive my ignorance. We’re operating PI 7.0 right now and thinking about upgrading to PI 7.1 later this year once it is released to the general public. Is ESR/SR part of PI 7.1 or it is a differnt component which can be installed standalone on CE 7.1? What is the relationship between ESR/SR and PI 7.1?


    1. Werner Steyn Post author
      The ESR/SR is available in 2 offerings; currently part of the Netweaver Composition Environment (CE) and also in PI 7.1. The recommendation is to have one ESR/SR – either on CE or on PI but not on both. For existing PI customers it makes more sense to upgrade to PI 7.1 to use the ESR/SR, and then simply have the Netweaver CE Composition Environment interact with the ESR/SR on PI. For customers that do not have PI at the moment and would like to start modeling point to point services the suggestion is to use the ESR/SR that is available with the Netweaver Composition Environment (CE). Once these customers have PI 7.1 in their landscape they can always transfer all their services within the CE ESR to the PI ESR and then rely completely on PI ESR for all service enablement needs.

      For any PI 7.1 upgrade questions please refer to the SAP Netweaver PI forum.

  2. Jiannan Che
    This is very helpful information.  Hope I had seen this earlier. 

    I am playing with the ESR 7.10 SP04 in CE 7.10 SP04.  Right now I am experiencing the same problem as described under point 6.  I tried to search for the “SP04 XI Content for SAP BASIS 7.10” patch in swdc but not finding it.  Is this patch for PI 7.10 ramp-up customer only?  t would be great if you can provide some more detail about this download.  Thanks.


    1. Werner Steyn Post author
      Location to download XI Basis Objects for CE ESR:

      Service Marketplace > Software Download > Download > Support Packages and Patches > Enter by Application Group > SAP Netweaver > SAP Netweaver > SAP Netweaver CE 7.1 > ESR FOR SAP Netweaver CE 7.1 > XI Content SAP Basis 7.10 > Database independent. Then download the Support package “?? XI CONTENT for SAP_BASIS 7.10” for your particular service pack.

      The file that you download is actually a zip file (SAPBASIS7*.ZIP), extract the file and manually import the .TPZ file into the ESB.

      1. Jiannan Che
        I have checked that location but did not find the file you mentioned.  So I re-imported the file “XI7_1_SAP_BASIS.tpz” came with ESR 7.1 SP4.  It did not fix the problem as mentioned in point 6.

        I did found another file “XI CONTENT NW DEMO 7.10” in the location you mentioned.  The file name is “NWDEMO71004_0-20002428.ZIP”.  Downloaded it and imported it.  Still the problem is not fixed. 

        Any other idea?

        1. Werner Steyn Post author
          Hello Jiannan,
          It might be easier just to search for the following SP4 file “SAPBASIS71004_0-20000889.ZIP”. Once you have the file please remember to extract the ZIP file and manually import the .TPZ file into the ESB.
          Regards, Werner
          1. Jiannan Che
            Hi Werner,

            I just searched in SWDC using the file name “SAPBASIS71004_0-20000889.ZIP”.  Nothing was found.  Is it because my account authorization?  I am using my S account from the SDN Subscription.

            This is weird.  Any other idea?


  3. Sipu Gakhar

    Really nice blog.

    Can you please help me to understand the relation between ESR and enhancement package on ERP. Does it contain the implementation of same services which are defined by SAP(ES Bundles). Does ESR ship with the services contains in ES Bundles or it doesn’t contain any data.


    1. Werner Steyn Post author
      Hello Piyush,

      For the most prominent business scenarios, SAP is in the process of defining and implementing enterprise services. The delivery happens via the enterprise services bundles (ES bundles) as part of the SAP Enhancement Packages. ES bundles are not a product that you install per se; rather it represents an abstract collection of enterprise services and related documentation grouped by a SAP business scenario. The only relation between the ESR and Enhancement packages is the fact that the meta-data for services within ES Bundles are stored within the ESR. The ESR does not contain the implementation but only the metadata. Since the ESR does not ship with specific services, you must import the services interfaces depending on the specific ES bundles and business scenario. Once imported the enterprise services can be used to extend ERP functionality by creating composite applications using SAP NetWeaver’s enterprise services development and modeling tools.

      Regards, Werner

    2. Sipu Gakhar
      Hi Werner,

      Thanks for your response.

      Still One more doubt. If I have applied the EHP on my ERP , then also I can create my composite applications .

      ESR is only to view the meta data of the services and also to extend or create new services.

      There is no relation of ESR with respect to consumption of services.

      Please correct me if I am wrong regarding the above mentioned concepts.


      1. Werner Steyn Post author
        Hello Piyash,

        Your assumptions are correct. The ESR is only a design time tool and repository for metadata that is not used or accessed in production. You will also not really be consuming services in the ESR but rather providing an implementation for the service. On the other hand the Services Registry is used for the consumption of services.

        Regards, Werner

  4. Daniel Sacco
    Hi Werner,

    As your blog helped me a lot to get my “CE Trial” to work (items 1 and 4), I would like to collaborate with a tip.

    I had an NameNotFoundException while trying to deploy Entity beans to the server that said “Object not found in lookup of JPA_DEFAULT”. In the forum thread EntityManager injection fails I found that “JPA_DEFAULT… is usually not present in the system”. As mentioned in the thread, I hadn’t specified the name of the data source in my persistence.xml so the server tried to use JPA_DEFAULT which wasn’t defined.

    Solution: Define the Data Source Alias.
    In SAP NetWeaver Administrator go to Configuration Management -> Infrastructure -> Application Resources, then select Create New Resource -> New JBCD DataSource Alias. Enter “SAP/JPA_DEFAULT” as DataSource Alias Name, select a DataSource Name
    (in my case SAPCE1DB), save and finally restart the server.

    More information on Java Persistence is available in the PDF “Getting Started with Java Persistence API and SAP JPA 1.0”

    Hope this helps other people.


  5. Pavani Kumari Kokkiragedda

    this is a very nice blog and can u help me in my problem??

    I have PI 7.1 installed and have SAP BASIS in ESB. When i did configuration, I have come across aproblem with WS adapter saying that the service interface( which is XI 3.0 compatable Flight seat availability) cannot be supported by WS adapter. Is there any thing esle to be looked in while configuration or is it due to installation problems? Or is it any way concerned with configuration only??

    Please guide me I m not able to proceed further due to this issue. I need to solve this urgently.


  6. Brian Fernandes

    When I publish my services I get the following error      “Error retrieving Services Registry (SR) version information”

    What could be the cause of this error.

  7. Tim Schneider
    Although I followed the steps and I cleared the Java Web Start caches in the file system as well, I’ve got the message:

    Ressource konnte nicht geladen werden: http://:/rep/repository/ (resource couldn’t be loaded).
    (Detail: HTTP-404-Error)

    I am using Java 1.5.0_12.

    Any Idea?

  8. Daniel Lippmann

    We’re encountering the problem that Enterprise Services Builder can’t be started, when we try to start “Restore Archives and Generate New Signature”, nothing seems to happen.

    Any suggestions? Should I try to redeploy XI SCAs?


Leave a Reply