Getting an Overview of Configuration Tools for Server Processes

Objective

After completing this lesson, you will be able to name Configuration Tools and describe their primary usage

Overview of configuration tools

There are three different configuration tools to configure the AS Java server nodes. This is a bit confusing at first glance, but it is due to when which tool was developed, or for what purpose the tool is used.

In day-to-day operation, most of the configuration tasks can be completed with the SAP NetWeaver Administrator

If none of the instances can be started, you will inevitably have to use the Config Tool. There are also a few things that can still only be done with the Config Tool today.

In very special cases or because you prefer a tool based on command line mode, you use the Shell Console Adminstrator.

In the following we want to get an overview of the configuration tools.

system only available in English

SAP NetWeaver Administrator

The SAP NetWeaver Administrator (NWA) combines the most important administration, configuration and monitoring tools for Java systems in a browser-based user interface.

system only available in English

With the NWA, the standard HTTP port of the AS Java instance is used. As tool a supported browser is needed. At least one application server of the SAP system must be started in order to use the SAP NetWeaver Administrator. It can be called using the following URL: http://<hostname>:<http-port of AS Java>/nwa.

Config Tool

You use the Config Tool to maintain the settings for AS Java in the database. It is therefore necessary that the database is started, so that you can change the settings with the Config Tool.

system only available in English

The settings that you make with the Config Tool only take effect when AS Java is started; that is, you must restart AS Java after maintaining settings.

The Config Tool is available in the file system of each application server. Authentication on the database is usually carried out via Secure Store.

Shell Console Administrator

The Shell Console Administrator can also be used to access an AS Java instance. This connection works via telnet and requires at least an up and running Java instance. telnet is available on many operating systems and can therefore be used for administration without additional installation. However, for security reasons the telnet access is by default set to localhost (see Note below). A remote access can be set up by configuring the associated ICM parameter.

Note

For security reasons, access to the SAP system over Telnet is limited to host IP address 127.0.0.1 (localhost).

system only available in English

You can use the Shell Console Administrator to display basic information about an AS Java system. The Shell Console Administrator is also suitable for starting and stopping services.

If necessary, you can use the Shell Console Administrator to shut down the AS Java instance by stopping the ICM and the server processes.

You can use the Shell Console Administrator to configure the services and managers of all Java instances in the Cluster. It is significantly easier to make the changes to managers and services with the Config Tool. Therefore, only specialists should make changes to managers and services using the Shell Console Administrator.

Calling the Configuration Tools

This section describes the features when calling the different tools.

How to use the SAP NetWeaver Admintrator (NWA)

SAP NetWeaver Administrator is a Web-based framework tool for administration, configuration and monitoring. It consists of respective integrated tools that help you to configure,but also administer and monitor your SAP NetWeaver system.

To call the SAP NetWeaver Administrator (NWA), log on to the HTTP port of an AS Javainstance. The AS Java instance must therefore be started. The NWA can be called using the following URL: http://<hostname>:<http-port>/nwa. The start page of the NWA is displayed after the logon.

system only available in English

The management functions included in SAP NetWeaver Administrator are grouped into work centers according to the type of functionality they provide. The work centers are subdivided into work sets grouping related administration options. The number of work sets and their content is dynamic and changes according to the installation scenario.

For example, the function JCo RFC Provider is located in the work set Infrastructure, which in turn is located in the work center Configuration. A function can also be available in several work sets.

Which work sets, work centers and functions you see depends on the profile that is selected. You can change the profile by choosing the Personalize menu.

If you are not sure which work set contains the application you need, use the following ways:

  • Search field: You can enter only part of the application name with or without accessory symbols
  • Site Map: Find the relevant application and choose its link to open it

How to use the Config Tool

The Config Tool is a tool for administering and configuring AS Java. configtool.bat (under Windows) or configtool.sh (under UNIX) is called to start the Config Tool at operating system level of an application server for AS Java. The start file is stored under the following path at operating system level: \usr\sap\<SID>\<instance directory>\j2ee\configtool. To access the configuration data of the SAP system, you have to log on to the database of the system using the Config Tool. To do so, you use the data stored in the Secure Store of the system (user and password) in the default setting. You must still confirm whether you want to use these default settings or whether you want to make other settings. You can then use the Config Tool to edit the parameters (see the figure "Config Tool: Call").

system only available in English

During the start process of the AS Java instance, the parameters for the start and running operation are read from the database and copied to the file system. With the Config Tool, these parameters are maintained in the database. It is therefore necessary that the database is running so that the Config Tool can read the current parameters from the database. When the Config Tool is opened, you can see and change the default settings for logging on to the database by choosing No. The window contains the connection data for the database on the tab page Via SecureStore. This is stored during the installation process. Choose Connect to DB to log on to the database using the data stored in the Secure Store. The Config Tool then displays the configuration settings saved in the database. You can now view these settings and change them if required.

To log on to a remote database using the Config Tool, you can also use the pushbutton Select Security Folder, to store the path for the Secure Store of another system. To do so, use the data stored in the Secure Store of the remote system using a secured network connection. It must be accessible as a share or mount point for example. You can then Connect to DB the "remote" database with these settings.

If you want to access this database repeatedly, you can save this new connection data as a file using Save Connection As and use it again later via the Connection Settings.

Hint

If you choose the option Do not ask me again in the Connection Settings dialog, the default settings are always used. To display the dialog again, start the Config Tool and choose ViewStartup Options and then select the option Show connection dialog.

How to use the Shell Console Administrator

You can perform some administration tasks for AS Java with Shell Console Administrator. To do this, you must specify the host name (only localhost in the standard system) and the Telnet port of the AS Java instance when you call the Shell Console Administrator. You are then prompted to log on to the AS Java, as shown in the figure, Shell Console Administrator: Call. You use, for example, the same user to do this as for the NWA. Since you are logging on to the AS Java instance, this must already be running.

After the logon via telnet, you are directly forwarded to the first server node of the respective instance. The command jump <server node-ID> takes you to another node. The command man currently lists available commands. To get further details, man <command name> gives you an explanation of the specified command.

Optional: AS Java Configuration – Tool Overview

Business Example

Different configuration tools can be used to configure a NetWeaver AS Java System. This exercise provides an overview about the different tools.

Valid for this Exercise

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

Task 1: SAP NetWeaver Administrator

Start the SAP NetWeaver Administrator using the Edge Browser on the WTS. Experience the navigation elements of the tool, and read the description of a Service SLD Data Supplier as described in the Steps. In addition use the History button .

Steps

  1. Open a browser, call the URL of the SAP NetWeaver Administrator (NWA) and log on.

    1. Within Classroom 1 WTS open a browser and call the URL http://<host name>:<HTTP-Port>/nwa, for example http://smhost.wdf.sap.corp:59100/nwa.

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

      • User: train-##
      • Password: <your password>
  2. Use the Work Center Structure to find the Java System Properties function. Search for the Service SLD Data Supplier and read the description of the Service.

    1. In the Top Level Navigation of window SAP NetWeaver Administrator choose the Configuration Work Center.

    2. In the next hierarchical navigation level press Infrastructure.

    3. In the content area select function Java System Properties.

    4. In the section Details about <TemplateName> (e.g. ZATPL_AIO) select theServices tab.

    5. On top of the table, below the field Name use the Filter field, type SLD* and press ENTER on your keyboard. Alternatively use the scroll bar to find the service SLD Data Supplier.

    6. Which Service Component Name is assigned to this service? ____

    7. If not already done select the Service SLD Data Supplier.

    8. In the section Extended Details - Properties search for RepeatTimeMinutes by scrolling down in the subsequent list or using the Filter field for the search.

    9. Press the Button Show Details below tab Properties in the Application Toolbar and read the Description in the area Default Property Data.

    10. Check the field Changeable. Is the check-boxfor this field set? Answer: ______

    11. In section Templates below NWA screen Java System Properties: Overview, press the button Show Advanced Properties.

    12. Hint: If you do not remember which tabs were visible before enhancing the view with Show Advanced Properties, you can move back and forth with this button which simply changes with every click from Show to Hide Advanced Properties.

      Result

      Which additional tabs show up now: ______________and _______________________.
    13. In the section Details about <TemplateName> (e.g. ZATPL_AIO) use again the Filter to see your SLD Data Supplier service and press the button More Actions → Start Service.

    14. On the top of the page what is the name of this Configuration function? ________________________________

    15. Press the Back arrow on the standard toolbar in the upper right hand side of the screen Start & Stop: Java Services.

    16. What is the name of this Configuration function now? _____________________________

    17. On the screen Java System Properties: Overview press Home on the upper right part in the standard toolbar.

    18. Select History on top.

      Result

      You should find all functions which you used before and are able to re-use them for faster access.
    19. Press Site Map in the standard toolbar on top of the screen SAP NetWeaver Administrator.

    20. Press Strg/Ctrl and f and enter: Java System Prop.

  3. Use the Site Map and Search function of the tool. In addition check the Help function.

    1. On the top right of the screen press the link Site Map.

    2. Press the keys cntrl/strg + F.

      Result

      You should see a search function on your screen.
    3. In the search overlay enter Java System Prop.

    4. In which areas did you find the function Java System Properties? _______________________ and __________________.

    5. Close the search pop-up by pressing on X use the Home Link on the top right area of the screen.

    6. In the Search:field enter Java System Prop.

    7. Press the button Go.

    8. In the resulting list, next to Java System Properties use the Locations link. What is the path to access this function? You have used it already in a former exercise step.

    9. Under the Java System Properties use the Overview Navigation link.

      Result

      You should find yourself in the configuration function Java System Properties: Overview.
    10. Finally press the Help link on the top right of the screen in the standard toolbar.

      Result

      If you are lucky, you will be forwarded to the Content of topic Java System Properties. For this, the system opens a new browser tab in the SAP Help Portalhelp.sap.com documentation. To see the content, click on Accept All Cookies (or View and change cookie preferences). Maybe the wrong Release is shown. Sorry for this.
    11. Optional: To see the most up-to-date documentation for Java System Properties do the following:

    1. On the SAP Help Portal - SAP NetWeaver <old release>(e.g. 7.3 EHP1) below title SAP NetWeaver Administrator SPS<no.>select linkThis document and choose All SAP products.

    2. In the Search field on the right enter again Java System Properties and confirm your input with the ENTERkey.

    3. Hopefully the first result will point to the latest documentation ot topic Java System Properties. Simply try it - good luck.

Log in to track your progress & complete quizzes