After a PI installation you have to configure your system. This is a
mandatory post installation step called "Running the Configuration
Wizard".
Before running the Wizard, it is recommended to update
the following Java Software Components (SCs) to the highest available
Support Package and Patch Level:
Life Cycle Management:
LM CONFIGURATION (LMCFG)
LM CONFIGURATION WIZARD (LMCTC)
Process Integration:
MESSAGING SYSTEM SERVICE (MESSAGING)
XI ADAPTER FRAMEWORK (SAPXIAF)
XI TOOLS (SAPXITOOL)
PI GUI (SAPXIGUI, only 7.11)
PI GUILIB (SAPXIGUILIB, since 7.30)
ESR (SAPXIESR)
The ABAP stack must have the same Support Package level as Java.
This Wizard Template is available since Release 7.10.
A
prerequisite to run the Wizard is that the system was installed with
the PI Installer (SAPInst). All PI services must be up and running.
For further information about the Configuration Wizard, see the following collective notes:
SAP note 0923359 - Collective Note: Configuration Wizard (Release 7.0x)
SAP note 1107808 - Collective Note: Configuration Wizard (Release 7.1x)
SAP note 1362909 - Collective Note: Configuration Wizard (Release 7.3x)
SAP note 1286428 - Configuration Wizard: PI Wizard Templates overview (Releases 7.1 and higher).
SolutionTo
run the CTC Wizard, start the SAP NetWeaver Administrator and navigate
to "Configuration Management --> Scenarios --> Configuration
Wizard". Depending on your release do the following:
Releases 7.10 / 7.11:
Select in the drop down list "Initial Configuration" or "All Configuration tasks -> NetWeaver initial setup".
Releases 7.30 / 7.31 and higher:
Click
on link "Functional Unit Configuration UI". Select Functional Unit "SAP
NetWeaver Process Integration (PI)". All required Functional Units are
selected automatically. Press button "Enable automatically" to start the
CTC Wizard. Pay attention to FAQ 1e and 1f.
FAQs:
Questions and AnswersQuestion 1: It is a prerequisite that 'all PI services must be up and running'. How can I check this?
Answer:
Log on to NetWeaver Administrator and navigate to "Operation Management
-> Systems -> Start and Stop" and select "Java JEE Services".
Filter for Services with name "XPI". All of them must be started.
Question 1a: How can I check whether installation and configuration was successful?
Answer:
With 7.10 SP7 and higher you can execute the "PI Self Test for
NetWeaver" CTC Wizard template. See note 1286149 how to do that.
Question 1b: Can I execute the configuration steps manually? Where is this described?
Answer:
Yes. This is described in the online documentation. For <your
release> select "PI/Mobile/IdM 7.1" or "7.0(2004s)" or "2004".
http://help.sap.com/
-> SAP NetWeaver
-> SAP NetWeaver <your release>
-> <your language>
-> SAP NetWeaver Process Integration Library
-> Administrator's Guide
-> Configuration of SAP NetWeaver
-> Configuration Wizard
-> Wizard-Based Configuration
-> Usage Type Process Integration (PI)
For Release 7.3:
http://help.sap.com/saphelp_nw73/helpdata/en/57/f47fd4fe534a1a948476afb65dd983/content.htm
Question 1c: Where do I find the log files?
Answer:
Start the NetWeaver Administrator and navigate to "Configuration
Management --> Scenarios --> Configuration Wizard" and select in
the drop down list "History of executed configuration tasks". You can
download the protocol there. Attach this zip file an OSS ticket in case
of deeper problems.
Question 1d: Is it mandatory to apply the
highest available Support Package after a new installation (before
running the CTC Wizard)?
Answer: Yes. Typically the installation
is shipped with SP0. Before running any CTC configuration task, you have
to update to the latest (currently) available Support Package.
Especially in Release 7.3 this can lead to problems.
Question 1e: How can I restart the CTC Setup from the Functional Unit UI?
Answer:
Select Functional Unit "SAP NetWeaver Process Integration (PI)" and
press "Disable". Refresh the screen after that. Select the Functional
Unit again and press "Enable automatically". Pay attention to FAQ 3.
Question 1f: Functional Unit "SAP NetWeaver Process Integration (PI)" has status "Running" and cannot be changed. What can I do?
Answer:
Select in the drop-down menu of the Configuration Wizard UI (NWA -->
Configuration Management --> Scenarios --> Configuration Wizard)
entry 'Running Configuration Tasks'. Check whether another session is
already running. Cancel or take over this session. If there is no entry,
disable Function Unit "SAP NetWeaver Process Integration (PI)" directly
in the Function Unit UI by pressing the "Disable" button. Restart from
there.
Question 2: Does CTC support the usage of a remote SLD?
Answer:
Yes, a remote SLD is supported. See note 954820 regarding the supported
release dependencies. Pay attention to questions (2a)-(2d).
Question 2a: Do I have to execute any manual steps to run my PI system against a remote (central) SLD?
Answer:
Yes. You have to create the PI Service users PIAFUSER, PIRWBUSER,
PIISUSER, PIDIRUSER, PIREPUSER and PIAPPLUSER on the remote SLD manually
and assign role/group SAP_SLD_CONFIGURATOR to them. To make the names
unique, it is recommended to add the SID of the system, which connects,
to the user name, e.g. PIAFUSER<SID>. Note that length of user
names is restricted to 12 characters for an ABAP UME. Therefore you may
also use the following short user names (which are also used as default
names since 7.30):
PIAF<SID>, PIRWB<SID>, PIIS<SID>, PIDIR<SID>, PIREP<SID> and PIAPPL<SID>
See
notes 768148 and 939592 for further information (e.g. LDAP) and
question (2b). For security reasons remote SLD user creation is on
purpose not automated via the PI CTC Wizard.
Question 2b: I want to connect several PI systems to a central SLD. Must all PI service users have same name/password?
Answer:
No. It is recommended to change the usernames of the PI service users
in a way that they are unique in the landscape, e.g. by adding the SAP
system ID (SID). See note 999962 how to do that.
Question 2c:
During setup of the remote SLD I am asked for the password of users
SLD_DS_<SID> and SLD_CL_<SID>, where SID is my local SID and
not the one of the remote system. What do I have to enter here?
Answer:
You have to change the user name into SLD_DS_<SID_remoteSLD> and
SLD_CL_<SID_remoteSLD>. The input screen displays the local SID as
default value, which is not correct in this context. You have to enter
the SID of the remote SLD. The Wizard checks the user credentials when
you press 'next'. Pay attention that for SLD Host and Port also the
remote SLD's values have to be entered. See question (2d) regarding the
Gateway configuration.
Question 2d: During setup of the remote SLD I am asked for the "Bridge Gateway Instance ID". What do I have to enter here?
Answer:
You have to enter the 2-digit instance number of the gateway instance.
It is assumed that it runs on the remote SLD host. The Gateway is used
by the SLD Data Supplier Configuration (RZ70). Pay attention to note
1172161 how your SLD Gateway must be configured, especially if your SLD
runs on WebAS Java (without ABAP stack). On plain AS Java systems the
Gateway runs on the SCS instance whereas on double stack systems usually
the central instance (CI) is used.
Example: SLD on double stack C11 with CI on 00 and SCS on 01
SLD HTTP Host = <hostname>
SLD HTTP Host = 50000
Bridge Gateway InstanceID = 00
Data Supplier User = SLD_DS_C11
SLD Client User = SLD_CL_C11
Example: SLD on WebAS Java C11 with CI on 00 and SCS instance on 01.
SLD HTTP Host = <hostname>
SLD HTTP Host = 50000
Bridge Gateway InstanceID = 01
Data Supplier User = SLD_DS_C11
SLD Client User = SLD_CL_C11
Question 2e: How can I check whether the SLD Self Registration of the PI components was successful?
Answer:
Start the SLD, navigate to "Technical Systems" and select in the drop
down list "Process Integration". There must be 6 entries for your new PI
system. On a central SLD you may filter for the DB Host name:
Adapter Engine on <db_host>
Domain <db_host>
Integration Directory on <db_host>
Integration Repository on <db_host>
Integration Server on <db_host>
RWB on <db_host>
Question 2f: I am running NetWeaver PI 7.1. Can I connect it to a SLD with Release 7.0?
Answer:
Yes. See SAP note 954820 regarding SLD compatibility and known
incompatibilities. Note that you have to update your SLD "Component
Repository Content" (CR Content), which is release independent. See SAP
note 669669 for details.
Question 2g: My local SLD is not using the default HTTP port. The initial setup fails. What can I do?
Answer: Select "remote" SLD during the initial setup of the functional unit SLD and enter the respective port.
Question 3: Can I re-execute the "NetWeaver initial setup" template?
Answer:
Yes. Pay attention that not all configuration steps are really
re-executed in this case, for example the SLD and ESR Content import. If
you have already done manual configuration changes, be aware that they
might be overwritten.
Question 3a: I cannot execute the
"NetWeaver initial setup" template on a Business by Design (ByD) system.
When I select the drop down list 'All configuration tasks', a task
"NetWeaver initial setup" is not displayed. Is this correct?
Answer:
Yes. The "NetWeaver initial setup" template is only executed on
NetWeaver systems. ByD systems have own configuration templates, which
call the PI initial configuration on their own.
Question 4: I want to run my Integration Server not in the default client 001, but in a different one. Is this automated?
Answer: Yes. Since Release / Support Package
SAP NetWeaver 7.10 SP08
SAP NetWeaver 7.11 SP01, Patch Level 02 of Software Component "LM CONFIGURATION" (LMCFG01P Patch 02)
SAP NetWeaver 7.30
this
is fully automated. Prerequisite is that you have manually performed a
client copy and changed the ABAP UME to the new client. This must have
been done before (!) the CTC Wizard is executed. See questions (4a) and
(4b) how to do that. For lower Support Packages this is different: There
you have to execute first the CTC Wizard on default client 001 and
after that the client copy. Further manual steps are required. See note
1115280 how to proceed in that case.
Question 4a: How can I change the UME Client in a 7.1 System?
Answer: Please refer to the online documentation:
http://help.sap.com/saphelp_nwpi71/helpdata/en/43/03e11edc6a6e99e10000000a11466f/frameset.htm
Question 4b: Which source client and profile do I have to use for a client copy?
Answer: You have two options:
copy client 001 (transaction SCCL) and use profile "SAP_UCUS"
copy client 000 with profile "SAP_UCUS" and after that client 001 with
profile "SAP_USER". The later is required to insure that j2ee_admin and
SAPJSF user have correct role assignment in the new client.
Further
details about the copy process are described in the installation guide
(post installation step "Performing the Client Copy").
Question 4c: Can I change the Integration Server client for a PI system that already runs on client 001?
Answer:
For already running, productive systems this is not supported. On
freshly installed systems you can change the default client. This is
also possible if you have already executed the PI initial setup Wizards
accidentally on client 001. To do so the following steps have to be
executed:
Make a client copy (see FAQ 4b).
Change the UME client (see FAQ 4a).
On the old client (001): Start transaction 'SXMB_ADM --> Integration
Engine Configuration' and change the 'Role of Business System' back to
'Application System' or 'Not Yet Configured'.
Logon to the
SLD (can be remote or local). Navigate to 'Technical Systems -->
Technical System Types' and delete the respective 'AS Java' and 'AS
ABAP' entities.
Navigate to 'Technical Systems --> Process Integration' and delete the respective XI domain.
Navigate from the SLD start page to 'Business Systems' and delete Business System INTEGRATION_SERVER_<SID>.
Reboot the double stack system.
Execute the Initial Setup again.
Question 5: Are there additional steps required to configure a "High Availability" setup?
Answer: Yes. See note 1052984 how to do that.
Question 6: Are there Demo Scenarios available for PI?
Answer: Yes, there are "Simple Use Case" and "Demo Example" scenarios for PI available in SDN:
https://www.sdn.sap.com/irj/sdn/go/portal/prtroot/docs/library/uuid/
b030691f-8b8b-2a10-5d94-8dd064dc2aa7
https://www.sdn.sap.com/irj/sdn/go/portal/prtroot/docs/library/uuid/
00de46da-8b8b-2a10-a1a0-c328b2034b5e
Question 7: Do you provide a "Trouble Shooting Guide" for PI?
Answer: Yes. See note 1060264 how to find this guide.
Question 8: The Configuration steps
'Configures the Product of the Technical System in the SLD' (sub step 'Configure product and component SAP_BASIS')
'Configures the Integration Server in the SLD'
fail with error message:
"Error: ABAP technical system '<SID> on <DB host>\<SID>' not found."
This happens on a Microsoft SQL Server.
Answer:
This problem is described in note 1237816. Please adjust the
"j2ee/dbhost" profile parameter as described there and restart the CTC
Wizard.
Question 9: I want to connect a Business Suite system with an XI/PI system. Are there any configuration templates available?
Answer: Yes, please refer to note 1178800.
Question
10: On "Business By Design" (ByD) Systems the PI CTC Wizard creates a
Logical Web Service Port. How can I check whether the creation was
successful?
Answer: Logon to clients 001 and 002 and start
transaction SRT_TOOLS. Select "Display Web Service Runtime Configuration
in Current Client" and mark the radio button "Web Service Consumer". In
section "Search by Proxy Name and Logical Port" search with input field
"Proxy Name" for "CO_THIRDPARTY_INT_SCNRIO_OUT".
Question 11:
After the initial setup I receive the error message "Unable to log on to
system xxx in language yyy with user PIRWBUSER" in the Runtime
Workbench (RWB). Why this?
Answer: The logon language yyy is not
activated in the ABAP system. Start transaction I18N and activate the
language. Language activation is a separate post installation task that
should have been executed before the CTC initial setup.
Question
12: I execute the "PI initial setup" CTC Wizard and get an error in step
"Create Company Address in client 000". What to do?
Answer: See
SAP note 1476425. Very likely your ABAP Administrator doesn't exist in
client 000, has a different password or is locked.
Question 13: Why does the PI Initial Setup not set fully qualified host names (FQHN) by default?
Answer:
This is implemented with Release 7.30 SP1 and higher. See SAP note
1476359 for further information. For lower Releases you can use the PI
Full Qualified Host Name CTC Wizard (see SAP note 1320707) to set FQHN
afterwards.
Question 14: Does the PI Initial Setup configure SSO?
Answer:
It configures "Java --> Java" SSO, but not "Java --> ABAP" and
"ABAP --> Java" SSO. The latter is required if you e.g. call ABAP
transaction SXMB_IFR. To configure these directions between the stacks
you have to execute Configuration Task "PI SSO Configuration". See SAP
note 1473556 for details about this CTC Template.
Question 15: I install my PI system in a federated landscape. Are there any release dependencies?
Answer: Yes. The general rule is that your PI hub should have the highest release. See SAP note 1043047 for details.
Question 16: Does the PI NetWeaver Initial Setup configure SSL/HTTPS?
Answer: No. Your AS Java system must first be configured to support HTTPS/SSL. After that Exchange Profile property
com.sap.aii.connect.secure_connections = messaging
has to be set. For further information access the SAP Library:
Release 7.10:
http://help.sap.com/saphelp_nwpi71/helpdata/en/e8/1f1041a0f6f16fe10000000a1550b0/frameset.htm
Release 7.11:
http://help.sap.com/saphelp_nwpi711/helpdata/en/48/a9bb457e28674be10000000a421937/frameset.htm
Release 7.30
http://help.sap.com/saphelp_nw73/helpdata/en/48/a9bb457e28674be10000000a421937/frameset.htm
Question
17: Step "Executing BAPI SWF_XI_BPM_AUTO_CUSTOMIZE" fails with message:
"Error: BAPIRET2 SWF_XI_ADAPTER Error 203 Error in
BPM-Autocustomizing". What can I do?
Answer: See SAP note 1580460.
Question
18: Step "Imports the master XML" fails with message "Error: Profile
locked by another local session, please retry later". What can I do?
Answer: See SAP note 1602945. You have to to deploy the latest available Patches of the Software Components:
J2EE ENGINE LM-CORE (LM-CORE)
MESSAGING SYSTEM SERVICE (MESSAGING)
XI TOOLS (SAPXITOOL)
XI ADAPTER FRAMEWORK (SAPXIAF)
ESR (SAPXIESR)
Question 19: Can I execute the "PI Initial Setup" after a System Copy?
Answer:
Yes. If you work with Release 7.3 you have to use the "Functional Unit
UI" (http://<host>:<port>/sld/fun). Pay in that case
attention to 'disable' the following FUNs before enabling "SAP NetWeaver
Process Integration (PI)" again:
"System Landscape Directory"
"Java Foundation"
"SAP NetWeaver Process Integration (PI)"
All three Functional Units have to be enabled from scratch.
