SAP Solution Manager How To Guide How To Switch or Update SAP JVM Version 1.2 August 2013
Copyright 2013 SAP AG. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. Microsoft, Windows, Excel, Outlook, PowerPoint, Silverlight, and Visual Studio are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, z10, z/vm, z/os, OS/390, zenterprise, PowerVM, Power Architecture, Power Systems, POWER7, POWER6+, POWER6, POWER, PowerHA, purescale, PowerPC, BladeCenter, System Storage, Storwize, XIV, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, AIX, Intelligent Miner, WebSphere, Tivoli, Informix, and Smarter Planet are trademarks or registered trademarks of IBM Corporation. Linux is the registered trademark of Linus Torvalds in the United States and other countries. Adobe, the Adobe logo, Acrobat, PostScript, and Reader are trademarks or registered trademarks of Adobe Systems Incorporated in the United States and other countries. Oracle and Java are registered trademarks of Oracle and its affiliates. UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group. Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems Inc. HTML, XML, XHTML, and W3C are trademarks or registered trademarks of W3C, World Wide Web Consortium, Massachusetts Institute of Technology. Apple, App Store, ibooks, ipad, iphone, iphoto, ipod, itunes, Multi- Touch, Objective-C, Retina, Safari, Siri, and Xcode are trademarks or registered trademarks of Apple Inc. IOS is a registered trademark of Cisco Systems Inc. RIM, BlackBerry, BBM, BlackBerry Curve, BlackBerry Bold, BlackBerry Pearl, BlackBerry Torch, BlackBerry Storm, BlackBerry Storm2, BlackBerry PlayBook, and BlackBerry App World are trademarks or registered trademarks of Research in Motion Limited. Google App Engine, Google Apps, Google Checkout, Google Data API, Google Maps, Google Mobile Ads, Google Mobile Updater, Google Mobile, Google Store, Google Sync, Google Updater, Google Voice, Google Mail, Gmail, YouTube, Dalvik and Android are trademarks or registered trademarks of Google Inc. INTERMEC is a registered trademark of Intermec Technologies Corporation. Wi-Fi is a registered trademark of Wi-Fi Alliance. Bluetooth is a registered trademark of Bluetooth SIG Inc. Motorola is a registered trademark of Motorola Trademark Holdings LLC. Computop is a registered trademark of Computop Wirtschaftsinformatik GmbH. SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, SAP HANA, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries. Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company. Sybase and Adaptive Server, ianywhere, Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase Inc. Sybase is an SAP company. Crossgate, m@gic EDDY, B2B 360, and B2B 360 Services are registered trademarks of Crossgate AG in Germany and other countries. Crossgate is an SAP company. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary. These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. These materials are provided as is without a warranty of any kind, either express or implied, including but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. SAP shall not be liable for damages of any kind including without limitation direct, special, indirect, or consequential damages that may result from the use of these materials. SAP does not warrant the accuracy or completeness of the information, text, graphics, links or other items contained within these materials. SAP has no control over the information that you may access through the use of hot links contained in these materials and does not endorse your use of third party web pages nor provide any warranty whatsoever relating to third party web pages. SAP NetWeaver How-to Guides are intended to simplify the product implementation. While specific product features and procedures typically are explained in a practical business context, it is not implied that those features and procedures are the only approach in solving a specific business problem using SAP NetWeaver. Should you wish to receive additional information, clarification or support, please refer to SAP Consulting. Any software coding and/or code lines / strings ( Code ) included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or grossly negligent. Disclaimer: Some components of this product are based on Java. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressively prohibited, as is any decompilation of these components. Any Java Source Code delivered with this product is only to be used by SAP s Support Services and may not be modified or altered in any way. i
Document History Document Version Description 1.0 Initial release 1.1 Smaller improvements and corrections 1.2 Chapter 2 content removed. Instead point to the platform specific guides for the SAP JVM Switch Tool that also describe this procedure. ii
Typographic Conventions Icons Type Style Example Text Example text Description Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options. Cross-references to other documentation. Emphasized words or phrases in body text, graphic titles, and table titles. Example text File and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools. Example text User entry texts. These are words or characters that you enter in the system exactly as they appear in the documentation. <Example text> Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system. EXAMPLE TEXT Keys on the keyboard, for example, F2 or ENTER. Icon Description Caution Example iii
Table of Contents 1. Introduction...2 1.1 About this Document...2 1.2 Related SAP Notes...2 2. Switching to SAP JVM 4...2 3. Updating the SAP JVM...2
1. Introduction 1.1 About this Document This document applies to Diagnostics Agent installations based on: SAP NetWeaver 7.0 SR3 or SAP NetWeaver 7.0 including EHP1. SAP NetWeaver 7.0 including EHP2, and the agent is running with vendor JVM 1.4.2. Diagnostics Agent Standalone Installer 7.11, 7.2 and 7.3. Software Provisioning Manager. 1.2 Related SAP Notes SAP Note Title 1833501 Diagnostics Agent - Installer Versions 1555341 Downloading SAP JVM Switch Tool and SAPJVM 4 1240081 "Java Cryptography Extension Jurisdiction Policy" files 2. Switching to SAP JVM 4 This procedure is described in the guides that SAP Note 1555341 points to. The guides for Windows, Unix and IBM i can be accessed via: http://service.sap.com/instguides o SAP JVM Switch Tool 3. Updating the SAP JVM The Diagnostics Agent cannot patch the SAP JVM automatically. The following section provides detailed information about how to patch a SAP JVM 4, 5 or 6 for the Diagnostics Agent. Installations based on 7.11 SAPinst support SAP JVM 5 only. Do not update such systems to SAP JVM 6. Installations based on 7.0 SAPinst support SAP JVM 4 only. Do not update such systems to SAP JVM 5 or 6. Procedure Logon as <dasid>adm, and execute below steps for each Diagnostics Agent that must run with the new SAP JVM: 1. Create a new directory for the new SAP JVM version. This is a subdirectory of /usr/sap/<sid>/sys/exe/jvm/<platform> named sapjvm_<version>.
- For version 5.1.046 create /usr/sap/<sid>/sys/exe/jvm/<platform>/sapjvm_5.1.046 - For version 6.1.008 create /usr/sap/<sid>/sys/exe/jvm/<platform>/sapjvm_6.1.008 - For version 4.1.009 create /usr/sap/<sid>/sys/exe/jvm/<platform>/sapjvm_4.1.009 2. Change to the newly created directory, with the "cd" command. 3. Extract the archive with the new SAP JVM version like: SAPCAR -xvf <location of the archive> 4. Open the SAP JVM manifest file (sapjvmmanifest.mf) with a text editor, to verify the version. Make sure the line "sapjvm version:" matches the name of the directory you created. Otherwise, rename the directory. 5. SAP JVM 5 and SAP JVM 6 only: As of SAP JVM releases 5.1.046 and 6.1.008, the JCE policy files are part of the delivered software archive again, so the following steps are not required for these versions. For older releases proceed as follows: Copy the Java Cryptography Extension Jurisdiction Policy files from a former SAP JVM version to the newly created directory. For example, if the former SAP JVM version is located in /usr/sap/<sid>/sys/exe/jvm/<platform>/sapjvm_5.1.000, copy the files "local_policy.jar" and "US_export_policy.jar" from "/usr/sap/<sid>/sys/exe/jvm/<platform>/sapjvm_5.1.000/sapjvm_5/jre/lib /security" to "/usr/sap/<sid>/sys/exe/jvm/<platform>/sapjvm_5.1.044/sapjvm_5/jre/lib/ security". You can also download the policy files as described in SAP Note 1240081. 6. Edit the instance profile and change the profile parametersapjvm_version. Enter the new version of the SAP JVM. SAPJVM_VERSION = 5.1.046 SAPJVM_VERSION = 6.1.008 SAPJVM_VERSION = 4.1.009 7. To activate the changes in the instance profile, restart the Diagnostics Agent service by executing the following command (replace ## with the system instance number): sapcontrol -nr ## -function RestartService 8. Optionally, remove files and folders below directory /usr/sap/<sid>/sys/exe/jvm/<platform> of SAP JVM versions, which are no longer used.