SAP Knowledge Base Article - Preview

2573122 - Diagnostics Agent can't find .sar file

Symptom

This article discusses several technical aspects related to performing an archive based installation of the Diagnostics Agent.

More details, also on the currently required minimum patch-levels of the SAR-files, which you need when installing with the latest SWPM version, are documented in SAP Note 2253383.

For this example, a directory holding all the below listed SAR-files was constructed.  The directory on purpose holds much more SAR-files than needed, to increase the illustrative value of this example. In directory /SWPM/K_749_U_LINUX_X86_64_JVM8/DBINDEP, we have:

SAR-file Name Description Remark with regard to this Example
SAPEXE_100-70001625.SAR SAP Kernel 7.49, patch-level 100 Should not get accepted, patch-level too low
SAPEXE_300-70001625.SAR SAP Kernel 7.49, patch-level 300 Should get accepted, patch-level OK
SAPHOSTAGENT13_13-20009394.SAR SAP Host Agent 7.21 patch-level 13 Should not get accepted, patch-level too low
SAPHOSTAGENT26_26-20009394.SAR SAP Host Agent 7.21 patch-level 26 Should get accepted, patch-level OK
SAPJVM6_98-10006989.SAR SAP JVM 6.1, patch-level 98 Should not get accepted, patch-level too low
SAPJVM6_102-10006989.SAR SAP JVM 6.1, patch-level 102 Should get accepted, patch-level OK => JVM OK, remaining constraints will decide which JVM is picked
SAPJVM7_10-10010932.SAR SAP JVM 7.1, patch-level 10 Should not get accepted, incorrect release
SAPJVM8_31-80000202.SAR SAP JVM 8.1, patch-level 31 Should get accepted, patch-level OK => JVM OK, remaining constraints will decide which JVM is picked
SMDA720_SP04_1-80002931.SAR Diagnostics Agent 7.49.1 (SMDA720_SP04_1) Should get accepted, patch-level OK

 

SAR-File Patch-Level Requirements

When providing a set of SAR-files to the SWPM installer, all SAR-files, regardless of their name, will get scanned to determine if the name and the content of the included manifest-file matches the requirements of the selected installation option. SWPM names these requirements "manifest predicate". During the scanning of the SAR-files, "manifest predicate" information is written to the sapinst_dev.log.

In the sapinst_dev.log you will find "Request archive" entries like shown below. These entries print-out which "manifest predicate" the SWPM installer will enforce, for each of the required SAR-files for your current installation option. The SAR-file names which you see below are the assumed default SAR-file names. The SWPM installer will also accept (e.g.) SAR-files which have a patch-level in the name, as we will see later on.

TRACE      2017-11-28 11:48:35.913 (root/sapinst) (startInstallation) com.sap.sdt.ins.component.archive_extraction.SpecifyArchive
Request archive:
 - name: SAPEXE
 - media name: SAPEXE.SAR, part of the Kernel
 - manifest: sapmanifest.mf
 - dependencies: []
 - manifest predicate:
                  @keyname='SAP_KERNEL' and
                  @kernel_os='LINUXX86_64' and
      @compilation_mode='UNICODE' and
     (
      (@kernel_release=721 and @kernel_patch_number>=800) or
      (@kernel_release=722 and @kernel_patch_number>=300) or
      (@kernel_release=749 and @kernel_patch_number>=200)
     )
 
TRACE      2017-11-28 11:48:35.913 (root/sapinst) (startInstallation) com.sap.sdt.ins.component.archive_extraction.SpecifyArchive
Request archive:
 - name: SAPJVM6
 - media name: SAPJVM6.SAR, part of the Kernel
 - manifest: sapjvmmanifest.mf
 - dependencies: [SAPEXE]
 - manifest predicate:
                  @keyname='SAPJVM' and
                  @sapjvm_os='LINUXX86_64' and
                  @sapjvm_release=6.1 and
      (
       ( //SAPEXE/@kernel_release=721   and   @sapjvm_patch_number>=99        )  or
       ( //SAPEXE/@kernel_release=722   and   @sapjvm_patch_number>=99        )  or
       ( //SAPEXE/@kernel_release=749   and   @sapjvm_patch_number>=99        )
      )

TRACE      2017-11-28 11:48:35.913 (root/sapinst) (startInstallation) com.sap.sdt.ins.component.archive_extraction.SpecifyArchive
Request archive:
 - name: SAPDIAGNOSTICSAGENT
 - media name: SAPDIAGNOSTICSAGENT.SAR, part of the Kernel
 - manifest: diagnosticsagent.mf
 - dependencies: [SAPEXE]
 - manifest predicate:
                  @keyname='SAPDIAGNOSTICSAGENT' and
      (
     ( @release=7.10 and   @servicepack=11 and  @patchnumber>=5   )  or
     ( @release=7.20 and   @servicepack>=4 ) 
      )

 

SWPM UI

Once SWPM has scanned and checked the SAR-files which you have provided, it will only show the accepted SAR-files in the SWPM UI. The below example shows that all required files are found and accepted.

The "info file" link at the screen below, gives you access to detailed analysis results.

swpm.png

 

The "info file"

The "info file" will help you to understand why SAR-files are accepted or rejected.

Per processed SAR-file, the analyzed candidate files are listed, and if a SAR-file is not accepted, the table in the "info file" lists the reason.

If at least the manifest file-name was correct, the not met "manifest predicate" is shown.

Explanation Section from the "info file"

SWPM looks for a SAPDIAGNOSTICSAGENT.SAR candidate.

Based on manifest-file name (Manifest Check) one file is selected.

The "manifest predicate" is fullfilled.

sar-1.png

SWPM looks for a SAPEXE.SAR candidate.

Based on manifest-file name (Manifest Check) two files are selected.

For @kernel_release = 749, the @kernel_patch_number attribute must be >= 200.

The "manifest predicate" is not fullfilled for patch_number 100.

The "manifest predicate" is fullfilled for patch_number 300.

 

 

sar-2.png

SWPM looks for a SAPJVM6.SAR candidate.

Based on manifest-file name (Manifest Check) four files are selected.

The "manifest predicate" requires an @sapjvm_release=6.1. Two SAR-files fullfil that.

The "manifest predicate" also requires an @sapjvm_patch_number>=99. Only one SAR-file fullfils that.

 

sar-3.png

SWPM looks for a SAPHOSTAGENT.SAR candidate.

Based on manifest-file name (Manifest Check) two files are selected.

The "manifest predicate" requires an @hostagent_patch_number >= 22, for all supported kernel versions. Only one SAR-file fullfils that.

 

sar-4.png

SWPM looks for a SAPJVM8.SAR candidate.

Based on manifest-file name (Manifest Check) four files are selected.

The "manifest predicate" requires an @sapjvm_release=8.1. One SAR-file fullfils that.

sar-5.png

 

Manifest-file Content

If you have trouble finding the correct version for one of the required SAR-files, you may want to check the manifest information which the installer has found in (e.g.) the kernel SAR-file which you provided.

This information can also be found in the sapinst_dev.log.

The below table shows the content of several manifest-files used in this example.

Note that the attributes which you see in the manifest-files are the same attributes which are used to formulate the "manifest predicate".

Description Manifest-file Content

Example sapmanifest.mf
from SAPEXE_300-70001625.SAR

Read manifest sapmanifest.mf:
  compilation_mode:UNICODE
  keyvendor:sap.com
  Manifest-Version:1.0
  kernel_os:linuxx86_64
  keyname:SAP_KERNEL
  kernel_release:749
  kernel_patch_number:300
  keylocation:SAP AG
  kernel_dbslversion:749.05
  make_variant:749_REL
  compiled_for:64 BIT
  downward-compatible_to:740 750 751 765
Example hostagent.mf
from SAPHOSTAGENT26_26-20009394.SAR
Read manifest hostagent.mf:
  hostagent_os:linuxx86_64
  hostagent_patch_number:26
  keyvendor:sap.com
  Manifest-Version:1.0
  kernel_os:linuxx86_64
  hostagent_release:7.21
  kernel_release:721
  keylocation:SAP AG
  compiled_for:64 BIT
  compilation_mode:Non-Unicode
  compversion-id:67838200100200018473
  keyname:SAPHOSTAGENT
  kernel_patch_number:819

Example diagnosticsagent.mf
from SMDA720_SP04_1-80002931.SAR

Read manifest diagnosticsagent.mf:
  changelistnumber:634232
  diagnosticsagent_release:7.20
  projectname:sm_agelets
  perforceserver:perforce3002.wdf.sap.corp:3002
  diagnosticsagent_service_pack:04
  keyvendor:sap.com
  release:7.20
  Manifest-Version:1.0
  Created-By:20.65-b04 (Sun Microsystems Inc.)
  patchnumber:1
  keycounter:7.2004.20170112095913.0000
  keylocation:SAP AG
  versionstring:7.20.04.1
  codeline:SM720_04_REL
  diagnosticsagent_patch_number:1
  servicepack:04
  Ant-Version:Apache Ant 1.6.5
  keyname:SAPDIAGNOSTICSAGENT
  diagnosticsagent_version_string:7.20.04.1

Example sapjvmmanifest.mf
from SAPJVM6_102-10006989.SAR

Read manifest sapjvmmanifest.mf:
  keyvendor:sap.com
  Manifest-Version:1.0
  sapjvm_build:61_REL-20170427
  sapjvm_release:6.1
  sapjvm_os:linuxx86_64
  keyname:SAPJVM
  sapjvm_patch_number:102
  sapjvm_version:6.1.102
  keylocation:SAP AG

Example sapjvmmanifest.mf
from SAPJVM8_31-80000202.SAR

Read manifest sapjvmmanifest.mf:
  keyvendor:sap.com
  Manifest-Version:1.0
  sapjvm_build:81_REL-20170704
  sapjvm_release:8.1
  sapjvm_os:linuxx86_64
  keyname:SAPJVM
  sapjvm_patch_number:031
  sapjvm_version:8.1.031
  keylocation:SAP AG

"Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental."


Read more...

Keywords

KBA , SV-SMG-INS-AGT , Installation of Solution Manager Diagnostics Agent , How To

About this page

This is a preview of a SAP Knowledge Base Article. Click more to access the full version on SAP for Me (Login required).

Search for additional results

Visit SAP Support Portal's SAP Notes and KBA Search.