SAP ABAP IMG Activity EHS_MD_135_07 (Set Up EH&S Expert Server As a Windows Service)
Hierarchy
EA-APPL (Software Component) SAP Enterprise Extension PLM, SCM, Financials
   EHS-SAF (Application Component) Product Safety
     CBUI (Package) Company Environment Information System
IMG Activity
ID EHS_MD_135_07 Set Up EH&S Expert Server As a Windows Service  
Transaction Code S_SH8_72000981   IMG Activity: EHS_MD_135_07 
Created on 20001013    
Customizing Attributes EHS_MD_135_07   Set Up EH&S Expert Server as Windows Service 
Customizing Activity    
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name EHS_MD_135_07    

Use

In this IMG activity, you set up the EH&S Expert server as a Windows NT or Windows 2000 service.

Requirements

  • Your PC runs on the Windows NT or Windows 2000 operating system.
  • You have installed the EH&S Expert server on your PC.
  • You have configured the EH&S Expert server for a certain destination. (In the following, the destination EHS_EXPERT is used as an example).

Standard settings

The EH&S Expert server as a Windows service consists of the file EHSEXPSV.EXE that is automatically copied to the corresponding bin directory for Expert installation when installing the EH&S Expert 2.7B (for example, c:\program files\ehs expert\bin). The bin directory should also contain the following three files:

  • The administration program SVCADMIN.EXE, which can be used to install, configure, and check services
  • The program library WIN32SVC.DLL
  • The EHSSTART.EXE file to automatically start and monitor the WWI generation server or EH&S Expert server as a Windows service

Activities

  1. Log on as local administrator to the PC.
  2. Start the MS-DOS prompt and change to the bin directory for EH&S Expert installation.
  3. Install the service by calling the EHSEXPSV file together with command line parameters as follows:

    EHSEXPSV.EXE -I -N<name> -D<destination>.

    Example:

    EHSEXPSV.EXE -I -NTest -DEHS_EXPERT installs the Windows service EH&S Expert Server (Test). The destination EHS_EXPERT is used.

  4. Make the settings that are specific to the application for the EH&S Expert server as a Windows NT service.

    During the installation, for each service, a key is created with the name EhsExpertSvc(<name>) under the main key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services.

    1. Start REGEDIT.EXE via Start\Run\regedit.exe.
    2. Choose the key EhsExpertSvc(<name>)\Parameter.
    3. Change the parameters if required.

  • Destination: name of logical SAP system destination
  • Idle Time:
  • (default value = 1000 ms)
  • InitialServerCount: Number of EH&S Expert server threads that are created directly after the service is started.
  • (Default value = 1)
  • MaximumServerCount: Maximum number of EH&S Expert server threads. As soon as the maximum is reached, a warning is logged. The service main thread then only functions as a database server.
  • (Default value = 20)
  • LogDirOptions: (Default value = 1 /F /P /E /L=clean.log)
  • Syntax: n [/F] [/P] [/E /L=<filename>]
    The number n deletes all files whose creation date or change date is more than n days ago (with 1 <= n <= 365)
    /F If the parameter is set, the reference point for deleting is the creation date. If the parameter is not set, the reference point for deleting is the date of the last access or last change.
  • /P If the parameter is set, subdirectory structures are retained and only files are deleted. If the parameter is not set, everything below the current directory is deleted.
  • /E Logs the names of all files and directories that cannot be deleted owing to restricted access rights. /L=<filename> Name of log file if parameter /E is set.
  • Examples:
  • 1 /F /P /E /L=clean.log deletes all files whose creation date is more than a day ago and log messages are created in the CLEAN.LOG file in the EH&S Expert directory.
  • 1 /P deletes all files whose change date is more than a day ago.

  1. Configure the application log for Windows NT or Windows 2000.
    1. Start the Windows event viewer (EVENTVWR.EXE).
    2. Change the setting for the application log via Log -> Log settings to the option Overwrite Events as Needed to prevent an overflow in the event viewer.
  2. Test the service.
    • Start and stop the EH&S Expert Server (Test) service using the SVCADMIN.EXE program from the bin directory of the Expert installation or the Services control in Windows.
    • Call the EH&S Expert Server (Test) from the SAP System.
    • Use the event viewer to check whether the respective commands in the application log file have been logged and whether the language-dependent texts for the events are displayed in the detail view.
    • Check whether the service was started automatically on system startup by rebooting the PC and calling the EH&S Expert Server (Test) from the SAP System.

To remove an installed service, proceed as follows:

  • Log on to the PC with administrator rights.
  • Start the service administration program SVCADMIN.EXE from the bin directory for the Expert installation.
  • If necessary, close the current service using the Control and configure services function.
  • Remove the service using the Uninstall services function.

Monitoring an EH&S Expert Server

To monitor a service-based EH&S Expert Server using EHSSTART.EXE, proceed as follows (prerequisite: you have configured EHSSTART.EXE as a service).

  1. Start the service administration program SVCADMIN.EXE from the bin directory of the Expert installation.
    • Choose the Control and configure services function.
    • Select the respective EH&S Expert Server service or WWI generation server service.
    • By pressing the Options button, an option dialog box is opened.
    • Choose the Service Attributes tab.
    • Set the Start type parameter to the option Manually.
    • Add the internal service name (for example, EHSStart) to the Service Dependency dialog box using the Add Dependency button.
    • Confirm the changes with OK.
  2. Close the EHSStart service and the service you just configured if necessary.
  3. Start the EHSStart service. After a short delay, this should start the service you just configured and monitor it. The principle here is that EHSStart starts and monitors all services that are dependent on it.

Business Attributes
ASAP Roadmap ID 201   Make global settings 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency A   Valid for all countries 
Assigned Application Components
Documentation Object Class Documentation Object Name Current line number Application Component Application Component Name
SIMG EHS_MD_135_07 0 ALR0000065 Tools 
Maintenance Objects
Maintenance object type    
History
Last changed by/on SAP  20030611 
SAP Release Created in