# How to setup NWDI with CM Services and CTS+ for Process Orchestration

Challenge

At one of our customer we had to set up SAP Process Orchestration together with CTS+ for transporting both PI/SLD and BPM objects and together with NWDI for storing and administering the sources and builds. Target was to use CM Services instead of CMS.

I was looking for a proper guide, however was only successful to find the following good blog from Unfortunately this blog was only covering the PI/SLD part of Process Orchestration:

http://scn.sap.com/community/process-orchestration/blog/2013/05/26/part-1-cts-configuration-for-process-orchestration-pipo-and-aex-731-java-only-stack

Now, the challenge was how to also cover the setup for BPM. Therefor I decided to write this guide to give an overview about all required steps to get this whole thing running.

Basic Strategies for BPM transports

Basically there are two options available how BPM processes can be transported in the landscape by using CTS+:

• Source Transport (Granularity Options: Activity or SCA)
• Deployable Transport (SCAs)

The decision for transporting sources or deployables does not have any influence on what has to be configured for the development system in STMS.

The only difference is the required settings in the CM Services UI for export mode (see screenshot below and refer to the CM services guide for further details (http://scn.sap.com/docs/DOC-16163). Advantage of the “Source Export” mode is that you can transport either sources based on activities (changed source code) or on SCAs. Both is possible. In case of mode “Deployable Export” only SCAs can be deployed and the setup of a development configuration is only required for the development system. A detailed explanation can be found in the CM services guide mentioned before.

Activity Based Transports

In our given customer project we have decided to go with the option “source export” . This decision requires that a rebuild of the sources has to be done for every system involved in the landscape (i.e. development, user-acceptance and production system).

The transport of activities is triggered directly from within the SAP NetWeaver Developer Studio via the Transport View in the Development Configuration Perspective of the NWDS. When releasing an activity the sources are exported and attached to a transport request in CTS+. The file format of the attached activity package is called *.dip (Development Infrastructure Package). Transporting sources through the system landscape requires a development configuration (with DTR workspaces and CBS buildspace) for each target system that is part of the transport route in your landscape. The import is started from the import queue of the target system on the CTS+ system. Compared to the transport of deployable units the import process for sources triggers a rebuild within each CBS buildspace.

To ensure a new build in each system, a development configuration needs to exist for every system. This means that during the creation of the TMS settings always a development configuration needs to be created. Whenever an import is started, a re-build is triggered for the SDAs which contain the changed source files and for all dependent SDAs. The sources are integrated into the respective DTR workspaces.

Main characteristics for activity-based transports:

• Each system configured in TMS (i.e. development, test and production) needs to have a development configuration
• Each system has a Java URL assigned since each system acts as a deploy target
• Workspaces in DTR and Buildspace in CBS are created for each system
• The name of the buildspace in CBS is the same as the SID of a system in TMS

Setup Overview

Important:

It is NOT recommended by SAP to have NWDI installed on the same machine as PO or Enterprise Portal (update of one usage type requires also the update of the other usage type). Unfortunately the setup at our customer is not the recommended one, since NWDI is currently on the same machine as PO dev. Therefore the guide below describes the setup based on this assumption. I added a remark in brackets where not the PO development system should be added, but rather the NWDI system on a separate machine

1. PO Development System Settings

1.1 Transport Settings

Important: This guide does not cover the setup of CTS+. In our case the Solution Manager ABAP stack (system-ID DS1, as seen in the descriptions below) was the system hosting the transport landscape (CTS+ system).

1. Start transaction STMS in Solution Manager (or in any other ABAP stack hosting the CTS+ system) and goto “System Overview”

2. Create a new “Non-ABAP System”:

3. During creation, the following information needs to be provided:

• System: Here, the development PO runtime system which should be attached to NWDI and CTS+ needs to be entered. In our case system-id was DI1
• Communication System: Here, the system needs to be added which acts as CTS+ system. In our case this was the Solution Manager (DS1)
• Development Infrastructure: This checkbox needs to be checked to ensure that a development configuration is created for the development PO system. Button SLD allows entering the URL to the SLD.
• Source System Settings: This activates the transport organizer to create transport requests for this system. This needs to be done for each system for which exports should be done (usually only required for the PO development system).
• Target System Settings: Here the PO development runtime system currently configured needs to be entered. The PO development hostname needs to be entered and the following methods need to be chosen:
• XI/PI: For the transports of PI objects (ESR and ID objects)
• SLD: For the transport of SLD objects in the landscape
• DC (Deploy Controller): This is required to ensure that a runtime system is created in the development configuration in NWDI later. This is needed for the transport of BPM processes.

4. When a non-ABAP system is saved the first time with a development configuration (“Create Development Configuration” is checked) additional data is required. In this case the following popup windows will appear:

• System Landscape Directory: Here the URL of the SLD used by NWDI has to be entered
• Set User and Password for DI SLD: Here the user of the CM Services needs to be entered which is used to communicate with the SLD entered above. This user is usually NWDI_CMSADM.
• Set User and Password for DI Service: Here the user of the CM Services needs to be entered which is used to communication with DTR/CBS. This user is usually NWDI_CMSADM.

6. After the settings are saved, the user for the XI/PI deployment needs to be entered. In our case user NWDI_CMSADM was used.

IMPORTANT:

• Please be aware of SAP Note 1688705 for the SDM/DC user and connection settings!
• Also make sure that user NWDI_CMSADM has user group “SAP_SLD_ADMINISTRATOR” assigned in IDM. Otherwise the connection to the SLD will not work properly

7. After the changes are saved and distributed, the browser with the NWDI configuration opens automatically. Here you need to enter a user which has appropriate rights to change NWDI configuration.

1.2 Creation of a development configuration

1. After login, the development configuration has automatically been created as type “CTS System”:

2. Goto the “Local Settings” tab and enter the following values:

Important: In our case this was the PO development system where also NWDI was installed!

This is not recommended by SAP, see comment above

Important: In our case this was the PO development system where also NWDI was installed!

This is not recommended by SAP, see comment above

• Transport Settings: Choose “Source Export” with “Software Components” and “Activities” checked.
• Export Destination: sap.com/com.sap.tc.di.CTSserver

The Runtime System has automatically been set based on the checked DC (Deploy Controller) method in the STMS settings (see above) and cannot be  changed here in edit mode. This would require the change of the TMS settings and a recreation of the development configuration.

3. To add the required software components to the configuration, go to tab Software Component Definition -> Add SC

4. The “Add Software Components” window appears. If the required SWC is not available in the SLD yet, the “Create New Software Component” wizard can be started.

5. Create the required SCs in SLD and assign those to the Development Configuration.

6. Save the Development Configuration.

1.3 Adaption of the Transport Settings

After the creation of the development configuration, the transport settings in STMS for the development PO system need to be changed in the CTS+ system (in our case this was DS1).

1. Start transaction STMS -> System Overview. Double-Click on the PO development system.

2. Goto tab “Transport Tool -> Change mode

3. Perform the following steps:

– Change the value of parameter DEPLOY_WEB_SERVICE from value CTSDEPLOY to CTSDEPLOY_DI

– Remove parameter DEPLOY_DATA_SHARE

– Add parameter CTS_FILE_PROVIDER_URI with value jco:destination=NWDI_TRANS,buffersize=100000

– Add parameter NON_ABAP_WBO_INBOX with value /usr/sap/trans/EPS/in

4. Make a test of the configuration afterwards. All statuses need to be green:

2. PO User-Acceptance System Settings

2.1 Transport Settings

1. Start transaction STMS and goto System Overview. Create a new system with the following settings:

• System: Here, the PO user acceptance runtime system which should be attached to NWDI and CTS+ needs to be entered.
• Communication System: Here, the system needs to be added which acts as CTS+ system (DS1 in our case).
• Development Infrastructure:
This checkbox needs to be checked to ensure that a development configuration is created for the PO user acceptance system.
• Source System Settings:This activates the transport organizer to create transport requests for this system. Since no transports are exported from the PO user acceptance system this needs to be left unchecked (check is only required for the development system).
• Target System Settings:Here the PO user acceptamce hostname currently configured needs to be entered. The method DC and XI/PI needs to be chosen. SLD was not chosen in our case since the PO user-acceptance system was using the same SLD as the PO development system and therefore no SLD transports were required.

2. Enter all required users as done for the PO development system setup in STMS.

3. After saving, again automatically the browser for NWDI is opened. As for the setup for the development system, enter the login and password. The development configuration for the PO user-acceptance system is automatically created.

4. Goto Edit mode of the PO user-acceptance configuration and select the checkbox “Copy Definition From:” and select the PO development system. This copies all the local settings and software components definitions from the already existing PO development system configuration.

5. Change the settings back in STMS as follows:

3. Add the required SWCVs to the Development Configuration

For each type of development different Software Components are required. A set of the required SWCVs for each development type can be found in SAP Note 1572743.

For BPM processes the following SCs are required:

COMP_BUILDT

BPEM-BUILDT

BPEM-CONTENT

BPEM-COLLAB

BPEM-FACADE (for BPM public API usage)

BPEM_MM

CU-BASE-JAVA

CU-BASE-WD

DATA-MAPPING

ECM-CORE

ESCONF_BUILDT

ESMP_BUILDT

FP-INFRA

FRAMEWORK

MOIN_BUILDT

SAP_BUILDT

SERVICE-COMP

WD-RUNTIME

3.1 Dowload of required SCA files from SAP Marketplace

For each of the above listed SCs an SCA-file needs to be deployed to the PO system. If some of the SCAs are missing, those can be downloaded from the SAP Marketplace. To do this follows the steps below:

1. Goto SAP Marketplace -> Software Dowloads -> Search for Support Packages and Patches and enter the name of the SCA file you are looking for:

2. Download the appropriate SCA file according to the used PO version:

2. Select the PO development system from the system list. A list of all software components and its versions on the runtime system and the selected development configuration is shown:

3. Click on the Next button

4. Enter the inbox path to which the SCA files have been uploaded in step 3.1 (standard path is /usr/sap/trans/EPS/in). In this path all downloaded SCAs need to be placed which are required for a specific development. Then click on the Next button:

5. An overview of all available SCAs in the entered inbox folder is shown:

6. Now Select “Import Archives” as action wherever possible and select the version of the downloaded SCA.

7. Afterwards an overview is displayed:

8. Select Synchronize at the bottom of the list:

9. Wait till the synchronization is finished.

Closing Words

After completion of the above configuration steps also for all the other systems in the landscape, the development process should be business as usual:

• Configure the NWDS to connect properly to NWDI
• Import the development configuration of the PO development and finally start developing

Please let me know in case of any errors, additional required steps to be described or any other comments.

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

great blog, thank you for sharing! 😉

Best Regards,

Ervin

• Congratulations on the blog.

Very well detailed.

• Hello Harald,

can you explain the settings of NWDI_TRANS

in tp parameter CTS_FILE_PROVIDER_URI

Best Regards

Peter

• Hello Harald,

is this another RFC than "sap.com/com.sap.tc.di/CTSserver" ?

I have CTS+ on Solution Manager and NWDI separated from POD and POQ.

Is this NWDI_TRANS RFC to go from NWDI->CTS+ or from NWDI -> POQ ?

Thank you for your help 🙂

Best Regards

Peter

• Former Member Post author

Hi Peter,

NWDI_TRANS is to go from NWDI to CTS+.

Best Regards

Harald

• Hi Harald,

Thank you for your blog and details steps.

As per note 1361909 and How to setup CM Services guide, and below is landscape setup we have done configuration

1) Solution Manager 7.1-Configured as Domain Controller and Central SLD eg SID=SOL

2.) NW 7.3 JAVA with usage type DI Installed - CM Services and NWDI eg SID=CMS

3.) Runtime Systems, EP Netweaver 7.3 SP07, 3 systems EPD,EPQ,EPP.

Below are some doubts.

1.) When I add EPD,EPQ and EPP as non-ABAP Systems in domain controller in SOL system, for which systems "Development Configuration" is it required on all systems or only for EPD.'

2.) Transport settings for EPD,EPQ & EPP. for which system  "Source Export" and "Deployable Export" please correct below information.

a.) Source Export for EPD

b.) Deployable Export for EPQ, EPP

As per recommendation CMS system will not be added in DOmain controller as non-ABAP system.

3.) Can i user CMS system as upload system.

Please provide me your email id, if required i will send the document of all step i have performed.

Regards

KSK

• Former Member Post author

Hi KSK,

Are you talking about an Portal or PO system?

1) Development configuration is needed for all systems to which you want to deploy your Java developments and to which you want to transport the developments. As far as I undrestand these are EPD, EPQ and EPP in your case.

2) Correct for EPD. When you do the copying as I described above for Q and P all settings are copied from EPD. That should be fine.

3) You don't need an upload system anymore when you use CM Services. That was only needed with CMS.

Just write me a message on SCN.

Best Regards

Harald

• Hi Harald,

Thanks for information. Its Portal System. We have another customer where we need to implement for PO system in April 2014, your blog is really helpful for PO system & on complete setup.

Regards

KSK

• Former Member Post author

Hi KSK,

I am happy to help. Just let me know if you have any questions.

BR

Harald

• Hi Harald,

I have added Portal system in to Domain controller in solution manager, when i click on Development configuration. SOA picks hostname twice from logical port CTSCONFIG

• Hi Harald,

From above screenshot.

for SOAMANAGER - for added logical port "Transport setting"

Transport Binding

url Access Path : http://<hostname>:port of CM Services System

Computer name of access url : Hostname of CM Service system

Port of url access : port of CM Services.

Regards

KSK

• Former Member Post author

Hi KSK,

Please find below the config for Enterprise Portal:

Hope it helps.

Best Regards

Harald

• Hi Harald,

I was able to add the systems, but when i click on "Development configuration" provided error pops up.

I have checked above settings as per your screens, all are fine. Still issue is same.

When i login to domain controller and click on development system " Development configuration" pick hostname twice this when i have changed the CTSCONFIG value in soamanger, it is picking the changed value.

As per my screenhsot Transport binding url and computer name url access values from are giving conflict, rest of all setting are fine.

Can you share what values are provided for CO_TDIDICONFIUGRATION_SERVICE proxy class for CTSCONFIG logical port transport setting.

Regards

KSK

• Former Member Post author

The logical port CTSDEPLOY has to be created in your TMS system using transaction LPCONFIG (ABAP stack). Did you do this? We have no CTSCONFIG port.

• Hi Harald,

I was able to fix the issue, CTSDEPLOY_DI has to be Web service in Transport tool Tab.

Since CM service - NWDI is being used.

When we added non-abap system in domain controller, and we can see "Development configuration" icon, It should load the Development configuration screen of CM Service system where we can see the runtime system entries.

1.) Registry of DI_Config service and done in SLD - where we can view these entries in SLD

2.) Can we manually update the entries if Development configuration doesn't loads the runtime system entries from Domain controller to CM Service system.

attached is screen,

Regards

KSK

/
• Former Member Post author

No you cannot manually change the information about the runtime systems. This is automatically set based on the STMS settings. Please check my descriptions above:

"DC (Deploy Controller): This is required to ensure that a runtime system is created in the development configuration in NWDI later. This is needed for the transport of BPM processes."

But for Portal you are anyways using SDM, not DC as far as I remember.

BR

Harald

• Hi Harald,

For portal system, I am selecting the "DC" in STMS when we add non-abap system.

I have seen some permissions on trans directory /usr/sap/trans/data, checking on this

Regards

ksk

/
• Former Member Post author

Ok...Did you update the Development Configuration via STMS menu entry after selection of the DC deployment method? So the runtime system is missing in your Dev. Config?

• Yes Harald, tried to update the development configuration via stms->goto menu, it fails.

It is not able to register in SLD.

Error is " Unable to register DI Config Service "NWDI_Config" in landscape directory

Regards

ksk

• Former Member Post author

Is the SLD connection working properly from your ABAP TMS system to your central SLD? Are all technical systems which are involved in your setup registered properly in SLD?

• Hello Harald,

Apologies for late response,

Still facing the issue, "Unable to register DI config Service "NWDI_Config" in landscape directory. Check SLD connection, everything looks good, even there are no duplication entries in content maintenance.

Regards

Suresh Kumar K

• Hello Harald,

is usage of NWDI a requirement for PO BPM development?

We are currently running PI (with CTS+ for transports) and BPM (with NWDI tracks) separately and are evaluating the move to a consolidated PO environment. Since our NWDI release is old and gave us a lot of trouble in the past we would like to move away from it. Isn't it possible to build BPM developments on the PO-DEV instance and transport directly with CTS+ to PO-QAS and PO-PRD systems? Can't I manage source code in a separate repository (e.g. Git)? What do I still need NWDI for?

Best regards,

Ulf

• Former Member Post author

Hello Ulf,

As far as I know you could use it without NWDI. Then all your sources are stored locally on your PC and you can deploy to the runtime systems directly via the settings in NWDS. However this is not recommended, since there is no central DTR and no central build via CBS. This is all very errorneous.

Also I don't think that transport directly via CTS+ is possible since you need to have a transportable file format for your developments, like SCA or DIP. This is only available when using NWDI.

Best Regards

Harald

• Hi Harald,

Thank you very much for this very helpful blog. Without it except the How to setup CM Services, difficult to find complete documentation like it.

I have a question regarding the fact we have in our PO landscape non central adapter engines :

- DO1, IO1, VO1 and PO1 are Central PO Systems

- DO2, IO2, VO2 and PO2 are non-central adapter engine for AEX

- DO3 ... can appear in future

Globally, we want to develop

- adapter modules that must be deployed on both xO1 and xO2 landscapes

- BPM and BRM objects that must only be deployed on xO1 landscape

We have started our design using 3 NWDI SWC :

- 1 for AEX

- 1 for BPM

- 1 for BRM

We would like to know what are your recommendations about transport route(s ?) that must be configured in our Solman 7.1 CTS+ system ?

Thank you very much for your help,

Jean-Charles CARRET

• Former Member Post author

Hi Jean-Charles,

Thanks a lot!

Regarding your questions: I guess D01 is development, I01 is integration, V01 is testing or similar and P01 is Production? The de-central adapter engines are connected to the central ones, right? How do you do the development and for what exactly do you need the de-central adapter engines?

You could also create a discussion in the NWDI forum. Then it would be a bit easier to talk about your topic.

Best Regards

Harald

• Hi Harald,

I confirm the following:

- DO1/DO2 is development, IO1/IO2 is integration, VO1/VO2 is for user acceptance tests and P01/PO2 is Production.

- our de-central AEs xO2 are registered and connected to the corresponding central PO system xO1.

Our non central engine (one per environment today but potentially more tomorrow) have following main targets :

- secure critical flows regarding others with high volume

We have some technical adapter modules that can be seen as reusable tools and we need to deploy them on all adapter engines (central and non central ones).

We have also other java developments linked with BPM/BRM that need only to be deployed on central instance.

The idea is just to understand the way to define transport routes to handle these particula cases with all best practices.

Thanks a lot,

Jean-Charles

• Former Member Post author

Hi Jean-Charles,

I understand that you are using a distributed PI installation, like below:

Since you still use a central adapter engine on each stage with several de-central engines,

it is usually recommended to just setup a standard transport route for your 4 stages:

Dev, Integration, User-Acceptance and Prod. Reason is that you only select the according de-central adapter engine in the communication channel of the integration scenario. The decentral engines therefore do not need to be part of a separate transport route.

For a detailed description and more detailed information please refer to the following document:

Best Regards

Harald

/
• Harald,

I agree with your answer if we speak about PO classic development (Design and Configuration) that are managed centrally in ESR and ID. In this case the standard route is sufficient.

But concerning Adapter Modules java objects, they need to be deployed on all instances including SAP PO Central systems and additional Adapter Engine systems.

That is for this kind of transports I want to use CTS+ coupled with NWDI and I'm wondering how to setup route.

DO1 > IO1 > VO1 > PO1

but how to deploy objects on DO2 ... PO2 ?

Jean-Charles

• Former Member Post author

In this case it would make sense to set up an additional transport route parallel to the standard transport route to ensure that all the deploy objects also reach the de-central engines.

DO1 > IO1 > VO1 > PO1

DO1 > DO2 > IO2 > VO2 > PO2

Transport Layers and Transport Routes (SAP Library - Change and Transport System - Overview (BC-CTS))

However I would have to check the possibilities of TMS in detail too. But I think this could be a good starting point for you.

BR

Harald

• Thank you very much Harald for all help brought.

I will start with your advise and I will see how to handle the fact that for some SWC, this second line must also be used and for others, it must not be.

Happy to have exchanged with you.

Jean-Charles

• Former Member Post author

Hi Jean-Charles,

Hopefully my comments were helpful. Let me know how you solved the problem.

Best Regards

Harald

• Hi Harald ,

Hope you are doing fine . I am following your document to configure CM services in NWDI with cts+ option and our Solman as DC for our PI 7.31 landscape .

I have created my PI Development system exactly how it was mentioned in your blog . When i have saved it ,i even got the logon screen for NWDI and i have entered our administrator username and password .That is when i see the strange error as it is unable to create the system in NWDI .Kindly suggest your inputs on this .

I have also pasted the configuration for your reference .

• Former Member Post author

Hi,

just saw your question today. Have you been able to solve it?

Best Regards

Harald

• Hi Harald,

I am stuck at section 1.1 Transport Settings point 6. In STMS, i created DEV system as shown by you and selected the SLD created in NWDI system. But when i save the configuration, i get following error:

"Unable to register DI Config Service "DCS_DIConf"

in landscape directory on "http://sapcs-dev-

[DICONF_REGISTERDICONFIG]: User credentials are

invalid or

Also when i got the Pop-up of NWDI logon screen, when i login, i see error:

 DI Configuration Service is not configured yet. [DICONF_DINOTCONFIGURED]

 Development configuration "DPI" does not exist

I checked the user "NWDI_CMSADM" has proper authorization and can access SLD/NWA on NWDI instance.

Thanks

Vik

• Former Member Post author

Hi Vik,

Do you have created the logical port CTSDEPLOY_DI on the CTS system?

BR

H.

• Hi Herald,

I am having issue with  "Software Component Definition" which i added from DEV PO system. Import was successful but i do not see all dependencies imported. For example when i goto SLD for this component i see dependencies list, but same dependencies are missing in NWDI.

How do i bring all the dependencies?

Thanks

Vik

• Hi Herald,

Is this document applicable for configuring CTS+ on PO 7.4(Java) with NWDI system(ABAP) as Domain controller, was the procedure varies in my case,

Note : Our NWDI ABAP system is 7.0 SP12 and Java is NW 7.4 will it cause any inconsistencies.

Thanks

Shaik

• Dear Harald,

When I try to complete point 3.2.3 pressing Next button I received 400 error session not found.

Thanks a lot,

Alexander

• Just want to share on one common issue at step 3, SCA files sync is that usually it throws 400 time out error.

Fix is increase/apply profile parameter :

icm/server_port_0 = PROT=HTTP,PORT=5$(SAPSYSTEM)00,TIMEOUT=600,PROCTIMEOUT=3600 icm/server_port_1 = PROT=P4,PORT=5$(SAPSYSTEM)04

icm/server_port_2 = PROT=IIOP,PORT=5\$(SAPSYSTEM)07

https://wiki.scn.sap.com/wiki/display/Basis/Timeout+Options+for+ICM

2439370 - How to stop HTTP access to the J2ee NetWeaver application server

• Hello,

Same issue for me (400   Session Not Found) in step 3 (synchronize).

I added the above parameters (icm/server_port_....) but same problem.

Is there someone who resolve this ?

Jean-Philippe

• Hi, thanks for this nice blog.

I was able to do everything like described here except the synchronization for the SC WD-RUNTIME. I was not able to select “Import Archives” for this particular SC. It looks like the system was not able to find the correct input file in …\EPS\in (although it was present).

Any clue?

Wilbert

• Hi Wilbert,

It might be because the SC version is same in Runtime and NWDI Buildspace. Do you see any difference in the versions.

Regards,

Lok

• Yes, there was a difference.

The issue has been solved.

Wilbert