当前位置：文档库 › sapjvm_switch_unix_new

sapjvm_switch_unix_new

Installation Guide

SAP JVM Switch Tool

SAP Systems Based on SAP NetWeaver 04 (SAP Web AS 6.40) and SAP NetWeaver 7.0 on UNIX

Target Audience

■Technology consultants

■System administrators

PUBLIC

Document version: 1.0 – 2011-05-25

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:

https://www.wendangku.net/doc/2a2077756.html,/instguides

SAP JVM Switch Tool .

The following table provides an overview of the most important document changes.

2/36PUBLIC 2011-05-25

Chapter 1Introduction (5)

1.1About This Document (5)

1.2SAP Notes (5)

Chapter 2Performing the Switch to SAP JVM Step by Step (7)

Chapter 3Preparation (9)

3.1Downloading the Required Software (9)

Chapter 4Running the SAP JVM Switch Tool (11)

4.1Running SAPinst (11)

4.2Additional Information About SAPinst (14)

4.2.1Interrupted Installation with SAPinst (14)

4.2.2Performing a Remote Installation with SAPinst (16)

4.2.3Starting SAPinst GUI Separately (17)

4.2.4Running SAPinst in Accessibility Mode (19)

Chapter 5Performing the Switch to SAP JVM 4 for the Diagnostics

Agent (21)

5.1Installing SAP JVM 4 (21)

5.2Replacing the Vendor Java Cryptography Extension Policy Files (22)

5.3Adapting SAP System Instance Profiles (23)

Chapter 6Follow-Up Activities (21)

6.1Making Changes to JAVA_HOME Effective (25)

Chapter 7Additional Information (27)

7.1Troubleshooting (27)

7.1.1Troubleshooting with SAPinst (27)

7.2Undoing the Changes Applied by the SAP JVM Switch Tool (27)

7.3What Does SAP JVM Switch Tool Do in Detail? (28)

2011-05-25PUBLIC3/36

A.1The Main SAP Documentation Types (29)

4/36PUBLIC2011-05-25

1Introduction

1.1About 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

7.0 with SAP JVM 4. This document is about how to run SAP JVM Switch Tool to accomplish this

replacement.

1.2SAP Notes

Make sure that you have read the following SAP Notes before you run the SAP JVM Switch Tool:

Introduction 1.1About This Document

2011-05-25PUBLIC 5/36

This page is left blank for documents that are printed on both sides.

2Performing 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:

1.You download the required software [page 9].

2.You run the SAP JVM Switch Tool [page 11].

3.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 https://www.wendangku.net/doc/2a2077756.html,/instguides .4.You perform follow-up activities [page 25

Performing the Switch to SAP JVM Step by Step

2011-05-25PUBLIC 7/36

This page is left blank for documents that are printed on both sides.

3Preparation

3.1Downloading 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 NW70_IM_SWITCH_JDK_.SAR file. You

have to download and extract it using SAPCAR to be able to use it.

■SAPJVM4.SAR for your operating system

SAPJVM4.SAR is the software component archive containing SAP JVM 4 for your

operating system. You have to download but not to 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 https://www.wendangku.net/doc/2a2077756.html,/swdc .

Procedure

Log on as user adm .2.

Download NW70_IM_SWITCH_JDK_.SAR and SAPJVM4.SAR to the local file system of the host of the SAP system instance on which you want to perform the switch to SAP JVM. Check SAP Note 1555341 for the current download path at https://www.wendangku.net/doc/2a2077756.html,/swdc .3.Extract NW70_IM_SWITCH_JDK_.SAR into a directory on the local file system.

Preparation 3.1Downloading the Required Software

2011-05-25PUBLIC 9/36

This page is left blank for documents that are printed on both sides.

4Running the SAP JVM Switch Tool

4.1Running 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 s apinst_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.

■sapinst_instdir/

■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 t

emporary d irectory s apinst_exe.xxxxxx.xxxx s ometimes r emains u ndeleted. Y ou c an s afely

delete it.

Running the SAP JVM Switch Tool 4.1Running SAPinst

2011-05-25PUBLIC 11/36

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=

●GUISERVER_DIALOG_PORT=

●GUISERVER_HTTP_PORT=

■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 19].

■

If required, you can stop SAPinst by choosing

SAPinst Cancel in the SAPinst GUI menu.

NOTE

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 adm .

This is also true if user 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

adm to make sure that the csh scripts are up-to-date:

/bin/csh -c "source //adm/.cshrc;env"

■Check the value of the environment variable TEMP , TMP , or TMPDIR :

Running the SAP JVM Switch Tool 4.1Running SAPinst

12/36PUBLIC 2011-05-25

●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 :0.0, where

is the host on which you want to display the GUI.

Procedure 1.Log on to the installation host as user adm or root .

CAUTION

If you want to perform the switch as user adm and the switch was started before by another user, for example by the adm of another system, you must delete the old NW70 directory and all its subdirectories in //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:/.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

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.

Running the SAP JVM Switch Tool 4.1Running SAPinst

2011-05-25PUBLIC 13/36

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 /.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 19] ■Troubleshooting with SAPinst [page 27]

4.2Additional 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 19]

4.2.1Interrupted 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:

Running the SAP JVM Switch Tool 4.2Additional Information About SAPinst

14/36PUBLIC 2011-05-25

NOTE not recommend that

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 adm or root .CAUTION

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 .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

Running the SAP JVM Switch Tool 4.2

Additional Information About SAPinst 2011-05-25PUBLIC 15/36

4.2.2Performing 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 Hummingbird 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].

Running the SAP JVM Switch Tool 4.2Additional Information About SAPinst

16/36PUBLIC 2011-05-25

■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 adm or root .

CAUTION

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 .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=

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 , port

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.3Starting 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

Running the SAP JVM Switch Tool 4.2Additional Information About SAPinst

2011-05-25PUBLIC 17/36

■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 19].

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

Make the required software available as described in Downloading the Required Software [page 9].2.Change to the directory of the sapinstgui executable:

platform>.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 -port

– where is the name of the remote host, and

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

– where 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 -port

– where is the name of the remote host, and

is the port the GUI server uses to

communicate with the GUI client (21212 by default).

The SAPinst GUI starts and connects to SAPinst.

Running the SAP JVM Switch Tool 4.2Additional Information About SAPinst

18/36PUBLIC 2011-05-25

Starting SAPinst GUI on UNIX

Make the required software available as described in Downloading the Required Software [page 9].2.

Change to the directory of the sapinstgui executable by entering the following command:cd .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 -port

– where is the name of the remote host, and

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

– where 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 -port

– where is the name of the remote host, and

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.2.4Running 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:

Running the SAP JVM Switch Tool 4.2Additional Information About SAPinst

2011-05-25PUBLIC 19/36

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.

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 -port

Running the SAP JVM Switch Tool 4.2Additional Information About SAPinst

20/36PUBLIC 2011-05-25