Configuring Server Processes with SAP NetWeaver Administrator

Objective

After completing this lesson, you will be able to maintain system properties in SAP NetWeaver Administrator

Configuration with the SAP NetWeaver Administrator

The SAP NetWeaver Administrator (NWA) is the tool for the online configuration.

System Configuration with SAP NetWeaver Administrator

Tool: Java System Properties

You can use the NWA to change and check Parameters. The NWA displays the value that is currently valid in the process. You can find these parameters in the NWA under ConfigurationInfrastructureJava System Properties or via the quick link /nwa/sys-config.

only available in English

Choose the active Template or the required Instance and then the appropriate tab pages, for example Services, if you want to view the properties of a Service. Then select the required entry. In the list of the object properties, for example of a service, the column Changeable shows whether the value can be changed online with the NWA. The push button Show/Hide Details displays further detailed information about the selected property. The current value is also shown for example if the property is calculated using a formula.

The Default value is shown in the Default Calculated Value field and the customer changes in the Custom Calculated Value field.

Note

use Show/Hide Advanced Properties to show advanced properties in the UI.

Hint

In the Service tab you can find the Service name used in the Config Tool in the field Service Component Name.

Tool: Starting and Stopping Java Instances

The tool Starting and Stopping Java Instances provides the following functions:

With the top tabs you decide what you want to manage: Java Instances, Java Service or Java Applications.

If you want to manage Java instances you have the following options:

  • Start, Stop or Restart Instances
  • Change the Number of Server Processes using the Set Node Count button
  • Enable, Disable Debugging

    Note

    When planning the number of server processes you want to have in an AS Java instance, you can allocate one of them for debugging. This means that when you start AS Java, this debuggable server process will not be operational in order to reduce the system resources consumption. When a problem appears in AS Java, you can start this server process using the SAP MC and connect to it with debugger.

    The debug server process is not included in the load balancing so end users will not experience stale requests (due to debugger breakpoints). However, you will still be able to monitor how your application/components behave in a cluster, inspect data and evaluate expressions.

By choosing the tab Java Applications among other functions you have the possibility to check which application is started on which instances or view additional information like Dependencies, Modules, Resources etc.

Tool: Java HTTP Provider Configuration – Logon Groups

A logon group is a logical separation of instances and applications. You define logon groups to determine how client requests to certain applications are load balanced when your system setup uses the SAP Web Dispatcher or a third-party hardware load balancer in front of your application servers. For example, you can define a logon group so that a certain application (such as one with high CPU usage) is accessible only on the instances running on machines equipped with extra CPU resources.

The slide shows the creaton of the Logon Group named PAS for Instance 11 and alias /sld.

Further Configuration Settings with SAP NetWeaver Administrator

Since the SAP NetWeaver Administrator (NWA) in Release 7.1x replaces the Visual Administrator from earlier releases, a variety of configuration options are integrated in the NWA. Some of these options are discussed in other units of this course. Depending on the installed product, the NWA also provides further product-specific functions along with the basic functions.

If you want to prevent access to administration URLs of the SAP NetWeaver Administrator, you have the option to filter requests for AS Java. This is done based on the central access point of a Java instance, which is the Internet Communication Manager (ICM). To do so, follow SAP Note 1451753.

Appendix: Configuration Wizard

The Configuration Wizard is integrated in the NWA and provides different configuration tasks depending on the installed product and the Support Package level. The Configuration Wizard reduces in particular the effort required initially for the configuration for certain applications directly after the installation of the system. The installation guide or the documentation of the application usually refers to the tasks to be executed in the Configuration Wizard. You can find it in the NWA under ConfigurationScenariosConfiguration Wizard.

You first select one of the executed tasks. Choose Start to start the configuration task. Here, the user is required to make entries in several steps depending on the task.

The Configuration Wizard logs the execution of tasks. If you choose History of Executed Configuration Tasks under Show and then select a task, you can display these logs using View Log.

You can execute tasks again that have already been executed using Re-execute.

Caution

If you have already made settings in the system, they are overwritten by executing a corresponding task in the Configuration Wizard. You should therefore use the Configuration Wizard only for the initial configuration of an application or a function and not during running operation.

AS Java Configuration - SAP NetWeaver Administrator

Business Example

You want to check various settings after you install an AS Java-based system and when the system is running.

Valid for this Exercise

ParameterValue
SAP ClassroomWTS
SAP System IDSMJ
Host name (FQDN)smhost.wdf.sap.corp
Operating SystemWindows
Central Services InstanceSCS90
Primary Application Server (PAS)J91
SAP NetWeaver AdministratorNWA
Java Administrator / passwordtrain-## / <your password>
Always replace ## with ...<group no.>

Task 1: Start SAP NetWeaver Administrator

Start the SAP NetWeaver Administrator (NWA) and logon with your AS Java user ID.

Note

  • General Hint: In the browser always use the start page of the SAP NetWeaver Application Server Java as the first tab.
  • From there you can call the tools you need as a new tab.
  • Once you call a function within this tool, keep it open, as you may need the tool again in one of the following steps.
  • If you receive a time out, press refresh (F5), close this tab and use the first tab to start over.

Steps

  1. Call the SAP NetWeaver Administrator (NWA) and log on.

    1. Open the Edge browser.

    2. Enter the web address for the NWA.

      URL:http://<host name>:<port>e.g.:http://smhost.wdf.sap.corp:59100

    3. On the start page choose SAP NetWeaver Administrator. (alternatively you could extend the URL by adding the alias/nwa).

    4. Log on to the NWA with your AS Java user ID and password:

      • User: train-##
      • Password: your password

Task 2: Use SAP NetWeaver Administrator and check the Memory and Application Thread Configuration.

Check the configuration settings using the SAP NetWeaver Administrator on template level.

Steps

  1. Check the value of the maxHeapSize for all instances.

    1. In the NWA, choose ConfigurationInfrastructure.

    2. Choose functionJava System Properties in the content area.

    3. In the area Templates select the existing entry, for example ZATPL_AIO.

    4. In the section Details about ZATPL_AIO switch to the tab page Memory VM Parameters.

    5. In field Name search the entry maxHeapSize and flag the corresponding row in the table.

    6. Write down the values of the following fields:

      • Default Calculated Value: ______________
      • Custom Calculated Value: ______________
    7. In section Templates expand the template node (e.g. ZATPL_AIO).

      Result

      Notice, that all AS Java instances (PAS/AAS) are listed below the template. Individual instance-specific settings are possible, if a single instance ID is selected. Here we do not select an instance ID, cause changes should be applied at template level.
    8. Ensure row ZATPL_AIOis still selected (typically colored orange)!

    9. Select the propertymaxHeapSize.

    10. Write down the following values for this parameter:

      • Default Calculated Value: ______________
      • Custom Calculated Value: ______________
    11. Select the ParameterinitialHeapSize.

    12. Press the button Show Details.

    13. Answer the following question based on the shown details:

    14. Press Hide Details.

    15. Choose Home in the standard toolbar on the upper right hand side of NWA.

  2. Check the parameter values of property MaxThreadCount as part of the Application Thread Manager on template level ZATPL_AIO.

    1. In the NWA, choose ConfigurationInfrastructure.

    2. Choose functionJava System Properties in the content area.

    3. In section Templates select ZATPL_AIO.

    4. Choose the tab Kernel.

    5. Select the entry ApplicationThreadManager

    6. Search for the entry MaxThreadCount in the list of Properties. Which value is assigned to this parameter? Note that there is a Default and a Custom value column.

    7. Write down the following values for this parameter:

      • Default Calculated Value: ______________
      • Custom Calculated Value: ______________
    8. Press the button Show Details.

    9. Read the Descriptionfor this property.

    10. Press Hide Details.

  3. Check the Thread Manager property MaxThreadCount.

    1. Still in the same User Interface in the area Details about ZATPL_AIO and with tab Kernel selected, choose the entry ThreadManager.

    2. In the area Extended Details, tab Properties, select MaxThreadCount.

    3. Select Show Details.

    4. Read the Description

    5. Press Hide Details.

  4. Optional: Check the current settings using the NWA monitoring functions.

    1. Within the NWA use the search field on the top right hand side and enter: Monitor Browser.

    2. Press Go

    3. In the resulting list press on the entry Monitor Browser.

    4. On the window History Reports: Monitor Browser on tab Monitor Browser in section Monitoring Listchoose the selector of field Show with value Inactive/Not used.

    5. In the content area filter by Name with the search term Application Thread.

    6. Select the Line: /Kernel/Application Threads Pool/Max Thread Pool Size.

    7. At the bottom in the area Monitor Configuration press the button Activate.

    8. There is a confirmation message visible below the title of the application History Reports: Monitor Browser: "Changes were successfully saved".

    9. On top, in field Show select Active/Used.

    10. In the content area filter by Name with the search term Application Thread.

    11. Select the entry/Kernel/Application Threads Pool/Max Thread Pool Size.

    12. In the middle of the screen in area Monitor Details for: Max Thread pool Size you should now find the Current Value of this metric.

      Note

      You should see now the following information:

      Server Node IDCurrent Value
      11<no.>360
      12<no.>300

Task 3: Optional: Use SAP NetWeaver Administrator to check Server processes .

You want to check an additional server process to the instance 12.Once you change the setting restart the instance mentioned in the tasks. Use the tool of your choice to restart the instance.

In TADM10 Landscape this exercise will not work. We keep it for the participants as a reference.

Steps

  1. Within the NWA use the Start & StopWork Center to set the node count of instance 12 to 2 and restart this instance.

    1. Within the NWA navigate to the tab OperationsStart & Stop

    2. Choose the tab Java Instances (default).

    3. Select the line 12 (Instance ID 12<no.>)

    4. In section Instances select the push-button Set Node Count

    5. Provide the value In the pop-up:

      • Enter Number of Nodes: 2
    6. Press Save.

    7. In the pop-up Confirmation "Node count change requires instance restart. Restart instance 12 (Instance ID12<no.> at host epdhost?"select Restart.

    8. A further authentication with title OS Credentials should take place and is required to proceed. Enter the following data into the fields of the request:

      • User name: epdadm
      • Password: Master10
    9. Press OK.

      Note

      If you are logged on to the instance 11 you can observe the shutdown and start-up progress. If you are logged on to instance 12 you will receive an error message.

    10. Wait until the restart is finished or jump to the next Task and check the result of this task later.

Task 4: Optional: Use SAP NetWeaver Administrator and check Filter Rules.

Change the configuration settings using the NWA. In this task we focus on filter rules, which can be used to start/stop/disable services and/or applications for the startup routine. Once you change the setting restart the instance mentioned in the tasks. Use the tool of your choice to restart the instance.

In TADM10 Landscape this exercise will not work. We keep it for the participants as a reference.

Steps

  1. Check the status of the applications tc~sld~wd* in NWA.

    1. Within the NWA navigate to the Work Center Operations , then Work Set Systems and choose function Start & Stop.

    2. Choose the tab Java Applications

    3. Within the section Application List enter in the Filterfield in column Name the following string: tc~sld~wd* and push theENTER key.

    4. Notice the status of the application tc~sld~wd~admin: ______________

  2. Call the application sld in your SAP Application Server Java System.

    1. Open a browser.

    2. Enter the URL for the NWA http://<host name:port>/sld (for example http://epdhost.wdf.sap.corp:51100/sld)

    3. Log on with your AS Java user ID and password

    4. As we use a fresh installation and we are not going to use the sld (System Landscape Directory) it is not configured. Optional you can select the link Administration(top left corner), press Initial Setup and provide the following Object Server Name: train##ObjectServer.

      Result

      If you have done the last optional step and return to the Home screen, the red message disappears.
  3. Check the status of the applications tc~sld~wd* in NWA again.

    1. Return to the NWA tab.

    2. Press the Refresh button in the Application List(on the right hand side).

    3. Enter the Status of the application tc~sld~wd~admin: ______________

    4. In the section Details About tc~sld~wd~admin notice on which Instance Number the application is started: ______________

  4. Define a filter rule that disables all applications with the Component Name Masktc~sld~wd* on template level.

    1. In the NWA, choose ConfigurationInfrastructure.

    2. Choose Java System Properties in the content area.

    3. Count the Tabs you find in the Details section: _________

    4. On the top in the Templates section, press the button Show Advanced Properties.

      Result

      You should now find the additional tabs: Filters and Shared Tables.

    5. If not already selected, choose in section Templates the first row called ZATPL_AIO.

    6. Select the tab Filters in section Details about ZATPL_AIO.

    7. In the list below tab Filters you can see the Inherited Filters.

      Note

      As visible, there is a specific sequence which is taken into account:

      • start all components
      • stop/start some specific application(s) and/or component(s)
      • disable many specific application(s) and/or component(s)

    8. In the lower part of the screen, area Local Filters, press Add.

    9. In the resulting pop-up Modify Filter enter the following information:

      Action:disabled
      Vendor Mask:sap.com
      Component:application
      Component Name Mask:tc~sld~wd*
    10. Press Set.

    11. Press Save.

    12. Notice the confirmation below Java System Properties: Overview"Filters were saved successfully. In order for the changes to take effect, restart the cluster."

    13. Press Hide Advanced Properties.

    14. Use the History and select Start & Stop: Java Applicationsor (if not available) switch to Home and use navigation path OperationsSystemsStart & StopJava Applications.

    15. Press More ActionsEdit Startup Filters.

      Result

      You jumped to Java System Properties: Overview, the Show Advanced Properties button has been pressed ("by the system") and you see the Filter in the area Local Filters which you just configured.

  5. Restart the PAS instance with a tool of your choice (e.g. SAP MC or sapcontrol).

  6. Open the alias /sld in your SAP NetWeaver AS Java System EPD.

    1. Open a browser.

    2. Enter the URL for the NWA based on the PAS instance (!) http://<host name>:>port of PAS instance>/sld (for example http://epdhost.wdf.sap.corp:51100/sld)

    3. Which message do you receive in the browser? ______________

      Hint

      Because you disabled this application, you should receive the error: 404 Not Found or 503 Service Unavailable and in the details the message should be: Error: Application is stopped. In our scenario this is a the expected message which confirms the disabling of the sld applications.

  7. Use the Start & Stop function to start the Java Application tc~sld~wd~admin.

    1. Open the NWA in a browser on EPD-WTS.

    2. In the NWA, choose the menu path OperationsSystems.

    3. Select Start & Stop.

    4. Select the view Java Applications.

    5. On the top left use the filter field and enter: sld

    6. Press ENTER.

    7. Select the row tc~sld~wd~admin.

    8. Press Start.

      Result

      You get the message on top below window title Start & Stop: Java Applications: "Application is starting asynchronously. To see the current state, choose "Refresh" in the status table"

    9. Press the refresh icon (at the right hand side of the Application List.

      Note

      In the field status of instance PAS should be written: Failed to start.

      If it did not work as expected, repeat to start the application and press again refresh.

      Caution

      Remember, that we did not restart the AAS instance since the configuration of the own filter. In addition there are multiple potential reasons why it did not work, for example ...
      • Browser cache issues > close all sessions of this browser type and retry
      • URL accessing the AAS instance instead of PAS instance > edit URL or restart AAS instance
  8. Optional: Restart the AAS instance with a tool of your choice (e.g. SAP MC or sapcontrol).

Task 5: Optional: Use SAP NetWeaver Administrator and check a Service.

Change a parameter of a selected service using the NWA.

Once you change the setting restart the instance mentioned in the tasks. Use the tool of your choice to restart the instance.

In TADM10 Landscape this exercise will not work. We keep it for the participants as a reference.

Steps

  1. Change for the service HTTP Provider the parameter DetailedErrorResponse from false to true on template level. Then change it back to false on the PAS instance level. This exercise is intended to show the system behavior with regard to template and instance level configuration levels.

    Hint

    Service HTTP Provider parameter DetailedErrorResponse: By default, the Web Container issues a short message to the client browser. To troubleshoot this kind of application error, you have the following two options:- Keep the short messages you could use the error ID to look-up error details from the corresponding trace file.- Enable verbose error messages to be issued to the client browser. However, this is considered insecure behavior and we recommend that you use it only on non-productive systems. To enable detailed error messages follow the exercise.

    1. If not already done, in the NWA, choose ConfigurationInfrastructureJava System Properties.

    2. Select the active template, for example ZATPL_AIO.

    3. Switch to tab Services.

    4. In the area Details about ID11<no.> use the Filter field for column Nameand enter HTTP.

    5. Press ENTER.

    6. If not yet selected, choose row HTTP Provider.

    7. In the areaExtended Details search for the parameter DetailedErrorResponse (by scrolling down or using the filter field with input Detail followed by ENTER).

    8. Select the line DetailedErrorResponse.

    9. Press Show Details.

    10. Read the Description of the parameter in section Default Property Data.

    11. Check the Range of this Parameter

    12. Press Hide Details.

    13. Is the flag Changeable checked: ______

    14. Press the button Modify.

    15. In field Enter Custom Value in the pop up window enter: true.

    16. Press Set.

    17. Press Save.

      Result

      Check the status on top of the screen below the window title Java System Properties: Overview: "Changes were saved successfully".

    18. In the Templates area expand ZATPL_AIO and select the row for the PAS instance (11<no.>).

    19. For parameter DetailedErrorResponse. Write down the values of the following fields:

      • Default Calculated Value: ___________
      • Custom Calculated Value: ___________
    20. Press Modify.

    21. Enter false.

    22. Press Set.

    23. Press Save.

Log in to track your progress & complete quizzes