Installation GuideSAP JVM Switch ToolSAP Systems Based on SAP NetWeaver 04 (SAP Web AS 6.40) and SAP NetWeaver 7.0 on UNIX
Target Audience ■ Technology consultants ■ System administrators
PUBLICDocument version: 1.40 – 2011-12-20
Document History
CAUTION
Before you start the SAP JVM Switch Tool, make sure you have the latest version of this document.
You can find the latest version at the following location: http://service.sap.com/instguides
SAP JVM Switch Tool .
The following table provides an overview of the most important document changes.
Version Date Description
1.40 2011-12-20 Updated Version
1.30 2011-12-12 Updated Version
1.20 2011-09-28 Updated Version
1.10 2011-07-07 Updated Version
1.0 2011-05-25 Initial Version
2/32 PUBLIC 2011-12-20
Table of Contents
Chapter 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1 About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2 SAP Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Chapter 2 How to Perform the Switch to SAP JVM Step by Step . . . . . . . . . . . . . . . . . 7
Chapter 3 Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.1 Replacing the IBM i Native JDBC Driver with the IBM i Toolbox
Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2 Checking SAP JVM Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.3 Downloading the Required Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Chapter 4 Running the SAP JVM Switch Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.1 Running SAPinst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.2 Additional Information About SAPinst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.2.1 Interrupted Installation with SAPinst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.2.2 Performing a Remote Installation with SAPinst . . . . . . . . . . . . . . . . . . . . . . . . 16
4.2.3 Starting SAPinst GUI Separately . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.2.4 Running SAPinst in Accessibility Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Chapter 5 Performing the Switch to SAP JVM 4 for the Diagnostics
Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.1 Installing SAP JVM 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.2 Replacing the Vendor Java Cryptography Extension Policy Files . . . . . . . . . . . 22
5.3 Adapting SAP System Instance Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Chapter 6 Follow-Up Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
6.1 Making Changes to JAVA_HOME Effective . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Chapter 7 Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
7.1 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
7.1.1 Troubleshooting with SAPinst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
2011-12-20 PUBLIC 3/32
7.2 Undoing the Changes Applied by the SAP JVM Switch Tool . . . . . . . . . . . . . . 27
7.3 What Does SAP JVM Switch Tool Do in Detail? . . . . . . . . . . . . . . . . . . . . . . . . 28
4/32 PUBLIC 2011-12-20
1 Introduction
1.1 About This Document
SAP introduced SAP JVM (SAP Java Virtual Machine) 4 for SAP systems based on SAP NetWeaver 04
(SAP Web AS 6.40) and SAP NetWeaver 7.0. SAP JVM 4 is a Java Development Kit (JDK) provided and
supported by SAP. It is fully compliant to the Java Standard Edition 1.4.2. With the SAP JVM Switch
Tool, SAP enables you to replace the vendor JVM 1.4.2 of existing SAP systems based on SAP NetWeaver
0.4 or 7.0 with SAP JVM 4. This document is about how to run SAP JVM Switch Tool to accomplish
this replacement.
1.2 SAP Notes
Make sure that you have read the following SAP Notes before you run the SAP JVM Switch Tool:
SAP Note Number Title Description
1665953 SAP JVM Switch Tool Composite Note
Contains supplementary information to the SAP JVM Switch Tool guide and to the SAP JVM Switch Tool as such.
1 Introduction
1.1 About This Document
2011-12-20 PUBLIC 5/32
2 How to Perform the Switch to SAP JVM Step by Step
Procedure
You have to perform the following steps on every application server instance host, that is on the
central instance host and on all dialog instance hosts:
Preparation
1. You check the installation prerequisites for the SAP JVM [page 9].
2. You download the required software [page 9]
Performing the Switch to the SAP JVM
1. You run the SAP JVM Switch Tool [page 11].
2. You perform the switch to SAP JVM 4 for the diagnostics agent [page 21].
NOTE
These steps are only required if one of the following applies:
■ Your SAP Java system is based on SAP NetWeaver 7.0 SR3 (SAP ERP 6.0 SR3, SAP CRM
5.0 SR3, SAP SRM 5.0 SR3, SAP SCM 5.0 SR3) or SAP NetWeaver 7.0 including EHP1 (SAP
ERP 6.0 EHP4, SAP CRM 7.0, SAP SRM 7.0, SAP SCM 7.0).
■ Your SAP Java system is based on SAP NetWeaver including EHP2 (SAP ERP 6.0 EHP5,
SAP CRM 7.0 EHP1, SAP SRM 7.0 EHP1) and the diagnostics agent is running with vendor
JVM 1.4.2 (not with SAP JVM 6). For more information about the choice between vendor
JDK 1.4.2 and SAP JVM 6 for the diagnostics agent, see the Java installation guides for SAP
NetWeaver including EHP2 (SAP ERP 6.0 EHP5, SAP CRM 7.0 EHP1, SAP SRM 7.0 EHP1)
at http://service.sap.com/instguides.
Follow-Up Activities
You perform follow-up activities.
2 How to Perform the Switch to SAP JVM Step by Step
2011-12-20 PUBLIC 7/32
3 Preparation
3.1 Replacing the IBM i Native JDBC Driver with the IBM i Toolbox Driver
If your system uses the IBM i Native JDBC Driver, you must replace it with the IBM i Toolbox Driver.
Procedure
Proceed as described in SAP Note 826449.
3.2 Checking SAP JVM Installation Prerequisites
The SAP JVM requires specific operating system versions, additional libraries and library patches.
Procedure
Check the requirements for your operating system as listed in SAP Note 1367498.
3.3 Downloading the Required Software
You have to make the following software available on every application server instance host of the SAP
system:
■ SAP JVM 4 Switch Tool
The SAP JVM 4 Switch Tool is delivered as a SAPJVMSWITCH<version>.SAR file. You have to
download and extract it using SAPCAR to be able to use it.
NOTE
If you want to perform a remote installation, and your remote and your local host are running
on different operating systems, you also have to download the required software for your
local host separately. For example:
● If your local host is Windows 32 bit, you have to download the file
SAPJVMSWITCH<version>.SAR of the platform Windows Server on IA32 32 bit on the local
host.
● If your local host is Linux 32 bit, you have to download the file
SAPJVMSWITCH<version>.SAR of the platform Linux on IA32 32 bit on the local host.
For more information, see Performing a Remote Installation with SAPinst [page 16].
■ SAPJVM 4
3 Preparation
3.1 Replacing the IBM i Native JDBC Driver with the IBM i Toolbox Driver
2011-12-20 PUBLIC 9/32
SAP JVM 4 is delivered as a SAPJVM<version>.SAR file. You have to download it but you must
not extract it.
Prerequisites
Make sure that at least SAPCAR 7.00 is available. We recommend that you use the latest SAPCAR
version. If required, download SAPCAR from http://service.sap.com/swdc.
Procedure
1. Log on as user <sapsid>adm.
2. Download the SAPJVMSWITCH<version>.SAR and SAPJVM<version>.SAR files for your operating
system to the local file system of the host of the SAP system instance on which you want to perform
the switch to SAP JVM.
You can find the current download path in SAP Note 1555341.
3. Extract SAPJVMSWITCH<version>.SAR into a directory on the local file system.
CAUTION
You must not unpack SAPJVM<version>.SAR.
3 Preparation
3.3 Downloading the Required Software
10/32 PUBLIC 2011-12-20
4 Running the SAP JVM Switch Tool
4.1 Running SAPinst
SAPJVM Switch Tool uses the functions of the installation tool SAPinst.
This section describes how to run the installation tool SAPinst. SAPinst includes a GUI client and a GUI
server, which both use Java.
This section describes an installation where SAPinst, GUI client, and GUI server are running on the
same host. In the following, GUI client and GUI server are addressed as “SAPinst GUI”.
If you need to see the installation on a remote display, we recommend that you perform a remote installation
with SAPinst [page 16], where the SAPinst GUI is running on a separate host from SAPinst.
Alternatively, you can use an X server for Microsoft Windows or other remote desktop tools like
vncviewer or nxserver/nxclient – offered by various vendors or open source – for remote access to
the GUI on Windows workstations. We recommend you use the Hummingbird Exceed X Server, which
we use to validate installations with SAPinst. For more information, see SAP Note 1170809.
Useful Information About SAPinst
■ When you start SAPinst, it automatically starts the SAPinst GUI.
■ SAPinst creates the installation directory sapinst_instdir directly below the temporary directory.
SAPinst finds the temporary directory by checking the value of the following environment variables
in the following sequence: TEMP, TMP, and TMPDIR. If no value is set for these variables, SAPinst
creates the installation directory sapinst_instdir directly below the /tmp directory by default.
If you want SAPinst to create the installation directory sapinst_instdir in another directory, set
the environment variable TEMP to this directory before you start SAPinst.
Shell Used Command
Bourne shell (sh) TEMP=<directory>
export TEMP
C shell (csh) setenv TEMP <directory>
Korn shell (ksh) export TEMP=<directory>
■ SAPinst creates a subdirectory for each installation option called sapinst_instdir/
<installation_option_directory>.
■ SAPinst extracts itself to a temporary directory called sapinst_exe.xxxxxx.xxxx, which is located
in the environment variables TEMP, TMP, or TMPDIR. These files are deleted after SAPinst has stopped
running.
The temporary directory sapinst_exe.xxxxxx.xxxx sometimes remains undeleted. You can safely
delete it.
4 Running the SAP JVM Switch Tool
4.1 Running SAPinst
2011-12-20 PUBLIC 11/32
The temporary directory also contains the log file dev_selfex.out from the extraction process,
which might be useful if an error occurs.
CAUTION
If SAPinst cannot find a temporary directory, the installation terminates with the error
FCO-00058.
■ During the installation, the default ports 21200, 21212, and 4239 are used for communication
between SAPinst, GUI server, GUI, and HTTP server, as follows:
● SAPinst uses port 21200 to communicate with the GUI server.
● The GUI server uses port 21212 to communicate with the GUI client.
● 4239 is the port of the HTTP server, which is part of the GUI server.
If the ports for SAPinst and the GUI server are already in use, SAPinst automatically searches for
free port numbers. If the search fails, SAPinst exits.
In this case or if you want SAPinst to use specific ports, you can assign them by executing the
sapinst executable with the following command line parameters:
● SAPINST_DIALOG_PORT=<port_number_sapinst_to_gui_server>
● GUISERVER_DIALOG_PORT=<port_number_gui_server_to_gui_client>
● GUISERVER_HTTP_PORT=<port_number_http_server>
■ To see a list of all available SAPinst properties, start SAPinst as described above with command line
parameter -p:
./sapinst -p.
■ If you need to run SAPinst in accessibility mode, proceed as described in Running SAPinst in Accessibility
Mode [page 20].
■ If required, you can stop SAPinst by choosing SAPinst Cancel in the SAPinst GUI menu.
NOTE
If you need to terminate SAPinst, you can do this by pressing Ctrl + C .
Prerequisites
■ We recommend that you use the csh shell for the installation with SAPinst. If you want to use
another shell, make sure that you have read SAP Note 202227.
SAPinst uses csh scripts during the installation to obtain the environment for user <sapsid>adm.
This is also true if user <sapsid>adm already exists from an earlier SAP system installation, and the
shell of this user is not csh. Before you start SAPinst, execute the following command as user
<sapsid>adm to make sure that the csh scripts are up-to-date:
/bin/csh -c "source /<home>/<sapsid>adm/.cshrc;env"
■ Check the value of the environment variable TEMP, TMP, or TMPDIR:
Shell Used Command
Bourne shell (sh) TEMP=<directory>
export TEMP
4 Running the SAP JVM Switch Tool
4.1 Running SAPinst
12/32 PUBLIC 2011-12-20
Shell Used Command
C shell (csh) setenv TEMP <directory>
Korn shell (ksh) export TEMP=<directory>
● Make sure that your operating system does not delete the contents of the temporary
directory /tmp or the contents of the directories to which the variable TEMP, TMP, or TMPDIR
points – for example, by using a crontab entry.
● Make sure that you have at least 60 MB of free space in the installation directory for each
installation option. In addition, you need 200 MB free space for the SAPinst executables. If you
cannot provide 200 MB free space in the temporary directory, you can set one of the
environment variables TEMP, TMP, or TMPDIR to another directory with 200 MB free space for
the SAPinst executables.
● Make sure that the temporary directory has the permissions 777.
■ Make sure that your DISPLAY environment variable is set to <host_name>:0.0, where
<host_name> is the host on which you want to display the GUI.
Shell Used Command
Bourne shell (sh) DISPLAY=<host_name>:0.0
export DISPLAY
C shell (csh) setenv DISPLAY <host_name>:0.0
Korn shell (ksh) export DISPLAY=<host_name>:0.0
Procedure
1. Log on to the installation host as user <sapsid>adm or root.
CAUTION
If you want to perform the switch as user <sapsid>adm and the switch was started before by
another user, for example by the <sapsid>adm of another system, you must delete the old
NW70 directory and all its subdirectories in /<path to temporary directory>/
sapinst_instdir or move it to another location.
2. Make the required software available as described in Downloading the Required Software [page 9].
3. Start SAPinst by executing ./sapinst from the following path:
/<directory into which you extracted SAPJVMSWITCH<version>.SAR>
4. Follow the instructions in the SAPinst dialogs and enter the required parameters.
NOTE
For more information about the input parameters, position the cursor on the parameter and
press F1 .
5. To start the switch operation, choose Start
6. If required, delete directories with the name sapinst_exe.xxxxxx.xxxx after SAPinst has finished.
Sometimes these remain in the temporary directory.
4 Running the SAP JVM Switch Tool
4.1 Running SAPinst
2011-12-20 PUBLIC 13/32
NOTE
If there are errors with the SAPinst extraction process, you can find the log file
dev_selfex.out in the temporary directory.
7. We recommend that you delete the directory <user_home>/.sdtgui/.
More Information
■ Interrupted Installation with SAPinst [page 14]
■ Performing a Remote Installation with SAPinst [page 16]
■ Starting SAPinst GUI Separately [page 17]
■ Running SAPinst in Accessibility Mode [page 20]
■ Troubleshooting with SAPinst [page 27]
4.2 Additional Information About SAPinst
The following sections provide additional information about SAPinst:
■ Interrupted Installation with SAPinst [page 14]
■ Performing a Remote Installation with SAPinst [page 16]
■ Starting SAPinst GUI Separately [page 17]
■ Running SAPinst with Accessibility Mode [page 20]
4.2.1 Interrupted Installation with SAPinst
The SAP system installation might be interrupted for one of the following reasons:
■ An error occurred during the Define Parameters or Execute phase:
SAPinst does not abort the installation in error situations. If an error occurs, the installation pauses
and a dialog box appears. The dialog box contains a short description of the choices listed in the
table below as well as a path to a log file that contains detailed information about the error.
■ You interrupted the installation by choosing Cancel in the SAPinst menu.
CAUTION
If you stop an option in the Execute phase, any system or component installed by this option
is incomplete and not ready to be used. Any system or component uninstalled by this option
is not completely uninstalled.
The following table describes the options in the dialog box:
Option Definition
Retry SAPinst retries the installation from the point of failure without repeating any of the previous steps.This is possible because SAPinst records the installation progress in the keydb.xml file.
4 Running the SAP JVM Switch Tool
4.2 Additional Information About SAPinst
14/32 PUBLIC 2011-12-20
Option DefinitionWe recommend that you view the entries in the log files, try to solve the problem, and then choose Retry.If the same or a different error occurs, SAPinst displays the same dialog box again.
Stop SAPinst stops the installation, closing the dialog box, the SAPinst GUI, and the GUI server.SAPinst records the installation progress in the keydb.xml file. Therefore, you can continue the installation from the point of failure without repeating any of the previous steps (see the procedure below).
Continue SAPinst continues the installation from the current point.
View Log Access installation log files.
NOTE
You can also terminate SAPinst by choosing Ctrl + C . However, we do not recommend that
you use Ctrl + C , because this kills the process immediately.
Procedure
This procedure describes the steps to restart an installation, which you stopped by choosing Stop, or to
continue an interrupted installation after an error situation.
1. Log on to the installation host as user <sapsid>adm or root.
CAUTION
If you want to perform the switch as user <sapsid>adm and the switch was started before by
another user, for example by the <sapsid>adm of another system, you must delete the old
NW70 directory and all its subdirectories in /<path to temporary directory>/
sapinst_instdir or move it to another location.
2. Make the required software available as described in Downloading the Required Software [page 9].
3. Change to the directory with the sapinst executable for your operating system by entering the
following command:
cd <directory into which you extracted SAPJVMSWITCH<version>.SAR>
4. Start SAPinst by executing the following command:
./sapinst
NOTE
For more information about how to start SAPinst, see Running SAPinst [page 11] or Performing a
Remote Installation with SAPinst [page 16] and Starting SAPinst GUI Separately [page 17].
5. From the tree structure in the Welcome screen, select the installation option that you want to
continue and choose Next.
The What do you want to do? screen appears.
6. In the What do you want to do? screen, decide between the following alternatives and continue with
Next:
4 Running the SAP JVM Switch Tool
4.2 Additional Information About SAPinst
2011-12-20 PUBLIC 15/32
Alternative Behavior
Run a new option SAPinst does not continue the interrupted installation option. Instead, it moves the content of the old installation directory and all installation-specific files to a backup directory. Afterwards, you can no longer continue the old installation option.For the backup directory, the following naming convention is used:<log_day_month_year_hours_minutes_seconds>
EXAMPLE
log_01_Oct_2008_13_47_56
CAUTION
SAPinst moves all the files and folders to a new log directory, even if these files and folders are owned by other users. If there are any processes currently running on these files and folders, they might no longer function properly.
Continue with the old option SAPinst continues the interrupted installation option from the point of failure.
4.2.2 Performing a Remote Installation with SAPinst
You use this procedure to install your SAP system on a remote host. In this case, SAPinst runs on the
remote host, and the SAPinst GUI runs on the local host. The local host is the host from which you
control the installation with the SAPinst GUI. The SAPinst GUI connects using a secure SSL connection
to SAPinst.
If your security policy requires that the person performing the installation by running the SAPinst GUI
on the local host is not allowed to know root credentials on the remote host, you can specify another
operating system user for authentication purposes. You do this using the
SAPINST_REMOTE_ACCESS_USER parameter when starting the sapinst executable from the command
line.
As an alternative to remote installation you can use an X server for Microsoft Windows or other remote
desktop tools such as VNC Viewer or NX Server / NX Client – offered by various vendors or open
source – for remote access to SAPinst GUI on Windows workstations. We recommend that you use the
Open Text Exceed X Server, which we use to validate installations with SAPinst. For more
information, see SAP Note 1170809.
Only valid for: Linux;Windows |
You can run the SAPinst GUI on a PC with 32-bit while SAPinst is running on a 64-bit installation host.
For more information, see Starting SAPinst GUI Separately [page 17].End of: Linux;Windows |
Prerequisites
■ The remote host meets the prerequisites for starting SAPinst as described in Running SAPinst [page
11].
4 Running the SAP JVM Switch Tool
4.2 Additional Information About SAPinst
16/32 PUBLIC 2011-12-20
■ Both computers are in the same network and can ping each other.
To test this:
■ If you need to specify another operating system user with the SAPINST_REMOTE_ACCESS_USER
command line parameter, make sure that this user exists on the remote host.
Procedure
1. Log on to the installation host as user <sapsid>adm or root.
CAUTION
If you want to perform the switch as user <sapsid>adm and the switch was started before by
another user, for example by the <sapsid>adm of another system, you must delete the old
NW70 directory and all its subdirectories in /<path to temporary directory>/
sapinst_instdir or move it to another location.
2. Make the required software available as described in Downloading the Required Software [page 9].
3. Change to the directory of the sapinst executable by entering the following command:
cd <directory into which you extracted SAPJVMSWITCH<version>.SAR>
4. Start SAPinst by executing the following command:
./sapinst -nogui
NOTE
If you need to specify another operating system user for authentication purposes, enter the
following command:
./sapinst -nogui SAPINST_REMOTE_ACCESS_USER=<specified OS user>
SAPinst now starts and waits for the connection to the SAPinst GUI. You see the following at the
command prompt:
guiengine: no GUI connected; waiting for a connection on host <host_name>, port
<port_number> to continue with the installation
5. Start the SAPinst GUI on your local host as described in Starting the SAPinst GUI Separately [page
17].
4.2.3 Starting SAPinst GUI Separately
You use this procedure to start the SAPinst GUI separately. You need to start the SAPinst GUI separately
in the following cases:
■ You closed the SAPinst GUI using File Exit from the SAPinst menu while SAPinst is still
running.
■ You want to perform a remote installation, where the SAPinst GUI runs on a different host from
SAPinst. For more information, see Performing a Remote Installation with SAPinst [page 16].
4 Running the SAP JVM Switch Tool
4.2 Additional Information About SAPinst
2011-12-20 PUBLIC 17/32
■ You want to run SAPinst in accessibility mode. In this case, you have to start the SAPinst GUI
separately on a Windows host as described below with the additional command line parameter –
accessible. For more information, see Running SAPinst in Accessibility Mode [page 20].
Prerequisites
The host on which you want to start the SAPinst GUI meets the prerequisites for starting SAPinst as
described in Running SAPinst [page 11].
Procedure
Starting SAPinst GUI on Windows
1. Make the required software available as described in Downloading the Required Software [page 9].
NOTE
If your remote and your local host are running on different operating systems, you also have
to download the required software for your local host separately. For example, if your local
host is Windows 32 bit, you have to download the file SAPJVMSWITCH<version>.SAR of the
platform Windows Server on IA32 32 bit.
2. Change to the directory of the sapinstgui executable:
<Drive>:\<directory into which you extracted SAPJVMSWITCH<version>.SAR>
3. Start the SAPinst GUI from a command prompt by executing sapinstgui.exe with the relevant
command line parameters:
■ If you want to perform a remote installation, execute the following command:
sapinstgui.exe -host <remote_host> -port
<port_number_gui_server_to_gui_client>
– where <remote_host> is the name of the remote host, and
<port_number_gui_server_to_gui_client> is the port the GUI server uses to communicate
with the GUI client (21212 by default).
■ If you closed the SAPinst GUI using File Exit and want to reconnect to SAPinst, proceed
as follows:
● If you are performing a local installation with SAPinst and SAPinst GUI running on the
same host, execute the following command:
sapinstgui.exe -port <port_number_gui_server_to_gui_client>
– where <port_number_gui_server_to_gui_client> is the port the GUI server uses to
communicate with the GUI client (21212 by default).
● If you are performing a remote installation with SAPinst and SAPinst GUI running on
different hosts, execute the following command:
sapinstgui.exe -host <remote_host> -port
<port_number_gui_server_to_gui_client>
4 Running the SAP JVM Switch Tool
4.2 Additional Information About SAPinst
18/32 PUBLIC 2011-12-20
– where <remote_host> is the name of the remote host, and
<port_number_gui_server_to_gui_client> is the port the GUI server uses to
communicate with the GUI client (21212 by default).
The SAPinst GUI starts and connects to SAPinst.
Starting SAPinst GUI on UNIX
1. Make the required software available as described in Downloading the Required Software [page 9].
NOTE
If your remote and your local host are running on different operating systems, you also have
to download the required software for your local host separately. For example, if your local
host is Linux 32 bit, you have to download the file SAPJVMSWITCH<version>.SAR of the
platform Linux on IA32 32 bit.
2. Change to the directory of the sapinstgui executable by entering the following command:
cd <directory into which you extracted SAPJVMSWITCH<version>.SAR>
3. Only valid for: AIX;HP-UX;IBM i5/OS;Linux;Solaris;Windows |
Start the SAPinst GUI by executing ./sapinstgui with the relevant command line parameters:
■ If you want to perform a remote installation, execute the following command:
./sapinstgui -host <remote_host> -port <port_number_gui_server_to_gui_client>
– where <remote_host> is the name of the remote host, and
<port_number_gui_server_to_gui_client> is the port the GUI server uses to communicate
with the GUI client (21212 by default).
■ If you closed the SAPinst GUI using File Exit and want to reconnect to SAPinst, proceed
as follows:
● If you are performing a local installation with SAPinst and SAPinst GUI running on the
same host, execute the following command:
sapinstgui -port <port_number_gui_server_to_gui_client>
– where <port_number_gui_server_to_gui_client> is the port the GUI server uses to
communicate with the GUI client (21212 by default).
● If you are performing a remote installation with SAPinst and SAPinst GUI running on
different hosts, execute the following command:
sapinstgui -host <remote_host> -port
<port_number_gui_server_to_gui_client>
– where <remote_host> is the name of the remote host, and
<port_number_gui_server_to_gui_client> is the port the GUI server uses to
communicate with the GUI client (21212 by default).
The SAPinst GUI starts and connects to SAPinst.End of: AIX;HP-UX;IBM i5/OS;Linux;Solaris;Windows |
4 Running the SAP JVM Switch Tool
4.2 Additional Information About SAPinst
2011-12-20 PUBLIC 19/32
4.2.4 Running SAPinst in Accessibility Mode
You can also run SAPinst in accessibility mode. The following features are available:
■ Keyboard access:
This feature is generally available for all operating systems.
■ High-contrast color:
This feature is derived from the Windows display properties. Therefore, to enable this feature, you
must perform a remote installation with the SAPinst GUI running on a Windows host.
■ Custom font setting:
This feature is derived from the Windows display properties. Therefore, to enable this feature, you
must perform a remote installation with the SAPinst GUI running on a Windows host.
Procedure
Activating and Adjusting Accessibility Settings on Windows
You first have to activate and adjust the relevant settings for the font size and color schemes before
you start SAPinst or the SAPinst GUI.
NOTE
The following procedure applies for Windows Server 2008 and might be different when using
another Windows operating system.
1. Right click on your Windows desktop and choose Personalize.
2. Select Adjust font size (DPI) and choose Larger scale (120 DPI).
To define other font size schemes, choose Custom DPI.
3. In the right-hand pane, select Window Color and Appearance.
Select a color scheme from the Color scheme drop-down box.
To define your own color schemes, choose Advanced.
Running SAPinst in Accessibility Mode
You perform a remote installation as follows:
1. Start SAPinst on the remote host by executing the following command from the command line
as described in Performing a Remote Installation with SAPinst [page 16]:
./sapinst –nogui
2. Start SAPinst GUI on a local Windows host by executing the following command from the
command line as described in Starting the SAPinst GUI Separately for a Remote Installation [page 17]:
sapinstgui.exe -accessible –host <remote_host> -port
<port_number_gui_server_to_gui_client>
4 Running the SAP JVM Switch Tool
4.2 Additional Information About SAPinst
20/32 PUBLIC 2011-12-20
5 Performing the Switch to SAP JVM 4 for the Diagnostics Agent
You have to perform the following steps to perform the switch to SAP JVM 4 for the diagnostics agent
running on the application server instances of your SAP Java system:
1. You install SAP JVM 4 [page 21].
2. You replace the Vendor Java Cryptography Extension policy files [page 22].
3. You adapt SAP system instance profiles [page 23].
NOTE
These steps are only required if one of the following applies:
■ Your SAP Java system is based on SAP NetWeaver 7.0 SR3 (SAP ERP 6.0 SR3, SAP CRM 5.0
SR3, SAP SRM 5.0 SR3, SAP SCM 5.0 SR3) or SAP NetWeaver 7.0 including EHP1 (SAP ERP 6.0
EHP4, SAP CRM 7.0, SAP SRM 7.0, SAP SCM 7.0).
■ Your SAP Java system is based on SAP NetWeaver including EHP2 (SAP ERP 6.0 EHP5, SAP
CRM 7.0 EHP1, SAP SRM 7.0 EHP1) and the diagnostics agent is running with vendor JVM
1.4.2 (not with SAP JVM 6). For more information about the choice between vendor JDK 1.4.2
and SAP JVM 6 for the diagnostics agent, see the Java installation guides for SAP NetWeaver
including EHP2 (SAP ERP 6.0 EHP5, SAP CRM 7.0 EHP1, SAP SRM 7.0 EHP1) at http://
service.sap.com/instguides.
5.1 Installing SAP JVM 4
If diagnostics agents are available in the application server instances of your SAP system, you have to
replace the vendor JVM 1.4.2 of the diagnostics agent with SAP JVM 4.
Prerequisites
You have downloaded the SAP JVM 4 Archive as described in Downloading the Required Software.
Procedure
1. Log on as user <sapsid>adm.
2. Open a command shell and extract the archive as follows:
■ For SAP systems based on SAP NetWeaver 7.0 SR3 or 7.0 EHP1, enter the following commands:
SAPCAR -xf <path to copied archive file>/SAPJVM4.SAR -R /usr/sap/<SAPSID>/exe
■ For SAP systems based on SAP NetWeaver 7.0 EHP2, enter the following commands:
5 Performing the Switch to SAP JVM 4 for the Diagnostics Agent
5.1 Installing SAP JVM 4
2011-12-20 PUBLIC 21/32
SAPCAR -xf <path to copied archive file>/SAPJVM4.SAR -R /usr/sap/<SAPSID>/SYS/
exe/uc/platform
5.2 Replacing the Vendor Java Cryptography Extension Policy Files
The SAP JVM has strong, but limited encryption capabilities by default. These capabilities are controlled
by two Java Cryptography Extension (JCE) policy files, namely local_policy.jar and
US_export_policy.jar, which are located in the jre/lib/security folder of a vendor JDK. If you are
using unlimited encryption with your vendor JDK, you must replace the vendor JCE policy files with
the JCE policy files required for the SAP JVM.
Procedure
Checking the Vendor JDK for Unlimited Encryption
Proceed as follows to check whether unlimited encryption is provided by your vendor JDK:
1. Open a command shell and enter the following command:
<path to vendor JDK>/bin/jar xf <path to vendor JDK>/jre/lib/security/
local_policy.jar default_local.policy
cat default_local.policy
2. Check the output of the commands.
If the output is similar to the following, unlimited encryption is provided by your vendor JDK:
EXAMPLE
grant {
// There is no restriction to any algorithms.
permission javax.crypto.CryptoAllPermission;
};
Applying Unlimited Encryption to the SAP JVM
For Sun/Oracle and HP 1.4. 2 partner JDKs, the unlimited encryption policy files of your partner JDK
can be reused for SAP JVM. Former IBM JDK users can download unlimited encryption policy files
from Oracle's website.
Proceed as follows to replace the vendor JCE policy files with the JCE policy files required for the SAP
JVM:
■ Solaris, HP-UX, Linux/x86 (32 bit):
Copy local_policy.jar and US_export_policy.jar from <path to Sun or HP JDK 1.4.2>/
jre/lib/security to /usr/sap/<SID>/SYS/exe/run/sapjvm_4/jre/lib/security. Overwrite
already existing equally named files.
■ AIX, Linux on POWER processors, Linux on x86_64, Linux on Z architecture:
5 Performing the Switch to SAP JVM 4 for the Diagnostics Agent
5.2 Replacing the Vendor Java Cryptography Extension Policy Files
22/32 PUBLIC 2011-12-20
1. Download jce_policy_1_4_2.zip from Oracle's website at https://cds.sun.com/is-bin/
INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US/-/USD/ViewProductDetail-
Start?ProductRef=7503-jce-1.4.2-oth-JPR@CDS-CDS_Developer.
2. Unpack jce_policy_1_4_2.zip.
3. Copy local_policy.jar and US_export_policy.jar to /usr/sap/<SID>/SYS/exe/run/
sapjvm_4/jre/lib/security
5.3 Adapting SAP System Instance Profiles
You have to restart the sapstart service in order to activate the changed <sapsid> profile. Before you
can do this, you first have to apply further changes to the profiles.
Procedure
1. This step is only required for SAP systems based on SAP NetWeaver 7.0 EHP 2:
Set up the SAPCPE program to copy the executables from the central directory to the local instance
directories as follows:
1. Edit the <sapsid> profile. This file is named <DASID>_<Instance>_<Hostname>
2. Change line _CPARG0 = list:$(DIR_CT_RUN)/j2eeinst.lst so that it looks as follows:
_CPARG0 = list:$(DIR_CT_RUN)/j2eeinst.lst list:$(DIR_CT_RUN)/sapjvm_4.lst
NOTE
The two list expressions must be separated by a space, not by a new-line character.
2. You have to set the profile parameter jstartup/vm/home to the path of the SAP JVM executable
to be able to run the diagnostics agent with SAP JVM. We recommend that you make a backup of
the profiles before modifying them.
To do so, proceed as follows:
1. Edit the instance profiles found at /usr/sap/<SID>/SYS/profile/
<SID>_<Instance>_<Hostname>.
2. Set the following parameter: jstartup/vm/home=/usr/sap/<SID>/SYS/exe/run/sapjvm_4
3. Add the following parameter: SAPJVM_VERSION = <version of the SAPJVM4>
4. Save the modified instance profiles.
3. Restart the sapstart service of each SAP system instance to make sure that the instance loads the
changed profiles.
You can either use the SAP MMC, or the SAP MC, or the sapcontrol command line tool.
■ Using the SAP MMC or the SAP MC:
Select your instances in the left tree view and choose All tasks Restart Service in the context
menu.
■ Using sapcontrol:
Enter the following command:
5 Performing the Switch to SAP JVM 4 for the Diagnostics Agent
5.3 Adapting SAP System Instance Profiles
2011-12-20 PUBLIC 23/32
/usr/sap/<SAPSID>/SYS/exe/run/sapcontrol -nr <Instance number> -function
RestartService
5 Performing the Switch to SAP JVM 4 for the Diagnostics Agent
5.3 Adapting SAP System Instance Profiles
24/32 PUBLIC 2011-12-20
6 Follow-Up Activities
6.1 Making Changes to JAVA_HOME Effective
Procedure
You have to log off and log on again as user <sapsid>adm on the host where you performed the switch
to SAP JVM so that the changes to JAVA_HOME become effective.
6 Follow-Up Activities
6.1 Making Changes to JAVA_HOME Effective
2011-12-20 PUBLIC 25/32
7 Additional Information
7.1 Troubleshooting
7.1.1 Troubleshooting with SAPinst
This section tells you how to proceed when errors occur during the installation with SAPinst.
If an error occurs, SAPinst:
■ Stops the installation.
■ Displays a dialog informing you about the error.
Procedure
1. Check SAP Note 1548438 for known SAPinst issues.
2. To view the log file, choose View Logs.
3. If an error occurs during the Define Parameters or Execute phase, do either of the following:
■ Try to solve the problem
■ Stop the installation by choosing Cancel in the SAPinst menu.
For more information, see Interrupted Installation with SAPinst [page 14].
■ After resolving the problem, you can continue the installation by choosing Retry.
4. Check the log and trace files of the GUI server and SAPinst GUI in the directory
<user_home>/.sdtgui/ for errors.
■ If the SAPinst GUI does not start, check the file sdtstart.err in the current <user_home>
directory.
■ If you use an X Server for Microsoft Windows or other remote desktop tools for the Remote
Access of SAPinst GUI on Windows Workstations and you experience display problems such
as missing repaints or refreshes, contact your X Server vendor. The vendor can give you
information about whether this X Server supports Java Swing-based GUIs and also tell you
about further requirements and restrictions. See also SAP Note 1170809.
5. If you cannot resolve the problem, create a customer message using component BC-INS.
7.2 Undoing the Changes Applied by the SAP JVM Switch Tool
If required, you can undo the changes applied by the SAPJVM Switch Tool retroactively.
Procedure
1. Go to directory /<path to temporary directory>/sapinst_instdir/NW70/SWITCH_JDK.
7 Additional Information
7.1 Troubleshooting
2011-12-20 PUBLIC 27/32
2. Follow the instructions in the switchJDK.txt file.
7.3 What Does SAP JVM Switch Tool Do in Detail?
The SAP JVM Switch Tool replaces the vendor JVM 1.4.2 of your SAP system with SAP JVM 4. To
acccomplish this, SAP JVM Switch Tool performs the following steps:
Process
1. Unpacking the SAPJVM4.SAR archive to /<sapmnt>/<SAPSID>/exe/jvm/<arch>/
sapjvm_<version>, where <arch> is the name of the unpacked archive folder.
2. Creating a link /usr/sap/<SAPSID>/SYS/exe/jvm that points to /<sapmnt>/<SAPSID>/exe/jvm.
3. Installing JCE policy files, if the vendor JVM uses unlimited encryption.
4. Updating (if already set) or setting (if not yet set) the JAVA_HOME environment variable to the path
of the SAP JVM location for user <sapsid>adm.
5. Modifying SAP system instance and start profiles by invoking sapcpe to replicate SAP JVM 4 to the
exe directory of every SAP system instance directory /usr/sap/<SAPSID>/<INSTANCE_NAME>/
exe.
6. Updating the configuration of the Software Deployment Manager (SDM) in the central instance
and restarting the instance service and instance agent.
7 Additional Information
7.3 What Does SAP JVM Switch Tool Do in Detail?
28/32 PUBLIC 2011-12-20
Typographic Conventions
Example Description
<Example> Angle brackets indicate that you replace these words or characters with appropriate entries to make entries in the system, for example, “Enter your <User Name>”.
ExampleExample
Arrows separating the parts of a navigation path, for example, menu options
Example Emphasized words or expressions
Example Words or characters that you enter in the system exactly as they appear in the documentation
http://www.sap.com Textual cross-references to an internet address
/example Quicklinks added to the internet address of a homepage to enable quick access to specific content on the Web
123456 Hyperlink to an SAP Note, for example, SAP Note 123456
Example ■ Words or characters quoted from the screen. These include field labels, screen titles, pushbutton labels, menu names, and menu options.
■ Cross-references to other documentation or published works
Example ■ Output on the screen following a user action, for example, messages ■ Source code or syntax quoted directly from a program ■ File and directory names and their paths, names of variables and parameters, and
names of installation, upgrade, and database tools
EXAMPLE Technical names of system objects. These include report names, program names, transaction codes, database table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE
EXAMPLE Keys on the keyboard
2011-12-20 PUBLIC 29/32
SAP AGDietmar-Hopp-Allee 16
69190 WalldorfGermany
T +49/18 05/34 34 34F +49/18 05/34 34 20
www.sap.com
© Copyright 2011 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, and PowerPoint 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, System z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server, PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes, BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States and/or other countries.Oracle and Java are registered trademarks of Oracle.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.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 companySybase 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.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.
DisclaimerSome components of this product are based on Java™. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressly 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.
Documentation in the SAP Service MarketplaceYou can find this document at the following address: http://service.sap.com/instguides
30/32 PUBLIC 2011-12-20
SAP AGDietmar-Hopp-Allee 1669190 WalldorfGermanyT +49/18 05/34 34 34F +49/18 05/34 34 20www.sap.com
© Copyright 2011 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.
Top Related