Skip to Content

How to change the client in SAP XI/PI

Sometimes we must to change the SAP installation client. Some components in SAP PI/XI need to have this parameter correctly defined for work in design time.


To accomplish this, it’s necessary to make some adjustments in Exchange Profile, Config Tool and UME.


These adjustments will apply to Integration Server and Integration Builder.


Adjustments in Exchange Profile


   Parameters option


       In the parameters option it’s necessary to change the next parameters:


  • ( Connection Folder )
  • ( Connection Folder )
  • ( Integration Builder Folder )
  • ( Runtime Workbench Folder )

       In all parameters you must to enter the new client code for SAP PI.

       You can make the adjustments faster if you go to the Search options and enter the parameters names in the Name textbox.


    Connection option


         Change the client parameter and enter the password for PILDUSER. Click in SET button to finish.


Note: For implements these adjustments you must to have the required roles in Exchange Profile.


Config Tool Adjustments


          Open Config Tool and go to Services option. The parameter ume.r3.connection.mster.client must to be changed to the client specified.




In User Management option into the J2EE server, go to Configuration Option,then you can to modify the ABAP system Configuration. Once you have made the changes, you must to save the parameters and click Test Connection.




  UME Roles:




Changes in runtime


 Now I’m talking about the changes that we must to apply for the Integration Server can process messages.


1.        Configure the client as Integration Server.


   The new client is configured as application system or not yet configured status, now it’s time to change this value and change it for it be integration server.

   Go to  sxmb_adm transaction and click in Integration Engine Configuration Data. Finally, click Edit option menu and choose change global configuration data.





2.        Global configuration for BPM.


 Next, we must to configure the logical connections in TA SM59. We have to create a logical connection with named WORKFLOW_LOCAL_XXX (X is the new client number). You can test the logical destination clicking Test Connection Button.




3.        JCO Provider


  In this point we will learn how to change the JCO Provider to connect with a new client.

  Firstly, open Visual Administrator tool and choose JCO Provider Option. There are some logical connections to SAP R3. In all logical connections you must to change the client parameter with the new value.





<4.        Automatic Workflow Customizing


Finally we have to perform a new Automatic Workflow Customizing. For do it, go to SWF_XI_CUSTOMIZING transaction and push F9 button.



Finally it’s necessary restarting the SAP J2EE server.

There are a SAP Note(940309) for SAP Netweaver 2004s that it’s useful for standards installations.

You must be Logged on to comment or reply to a post.
  • Hi Carlos,

    I change the default client from 001 to xxx according to SAP Note(940309).

    Also I have to do some additonal steps, that are not mentioned in your blog and in SAP Note(940309). This steps are:
    1)Autocustomizing of workflow
    2)Re-acivating IPs

    But still I have some problems. Some of IPs, that works in 001 client, now fails. I see that it fails on send step with transport acknowledgement. When I switch off transport ack. it become work fine, but I need this ack. in IPs.

    Do you know how to fix it?


    • Hi All,

        Firstly I would like to thank all for your comments.

        I know that in this post are not included the complete steps for change the client. Especially all steps to configure the client in Runtime. These steps are written in SAP Note.

        I had written this post for grouping several steps that it has not been included in the SAP Notes and I think they are specially interesting for us.

        I will complete this post the next week and I will talking about the configuration in runtime.

      Best Regards