Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
Managing MC/ServiceGuard Extension for SAP R/3: > Chapter 2 Step by Step Installation Guide

HP-UX Configuration

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Index

Correct HP-UX configuration ensures that all cluster nodes provide the environment and system configuration required to run SAP R/3. This section describes how to distribute the SAP R/3 installation configuration changes made in the previous section, "“Preparing the Integration”," among the cluster nodes, that is, from all primary nodes to all other nodes.

Several of the following steps must be repeated on each node. Record the steps completed for each node, as you complete them. This helps identify errors in the event of a malfunction later in the integration process. The HP-UX configuration task is split into the following sections:

  • “Cluster Node Synchronization”

    This section consists of steps performed on the backup nodes. These ensure that the primary node and the backup nodes have a similar environment.

    Repeat the steps in this section for each node of the cluster that is different from the primary.

    The primary host is the host where the Central Instance was installed. If your database is currently running on a machine different from this, repeat all steps once again for each node with the database machine as primary host. This distributes the database configuration, too.

  • “Cluster Node Configuration”

    This section consists of steps performed on all the cluster nodes, regardless if the node is a primary node or a backup node.

    Repeat the steps in this section for each node of the cluster.

  • “External Application Server Host Configuration”

    This section consists of steps performed on any host outside of the cluster that runs another instance of the SAP R/3 system.

    Repeat this section for each host that has an external application server installed.

Performing some of the iterations in parallel is fine, just use caution in any complex setup situation.

Rather than using the cut and paste mechanism you can also fill out the tables provided by first analyzing the primary host(s). Afterwards you can use the tables to synchronize all nodes.

Cluster Node Synchronization

Repeat the steps in this section for each node of the cluster that is different than the primary.

  • Logon as root to the primary host.

  • Prepare a logon for each of its backup hosts.



Installation Step:

Level: IS150

Look at the groupfile file, /etc/group, on the primary side.

If any of the groups listed in Table 2-4 “Groupfile File Groups” exist on the primary node and they do not exist on the backup node, copy them from the primary node to the backup node. If any group exists, verify that it has the same GID on both the primary and backup nodes. Merge the group members lists.

Table 2-4 Groupfile File Groups

groupsGIDgroup members
sapsys  
dba  
oper  
informix  
super_archive  

 



Installation Step:

Level: IS160

Look at the password file, /etc/passwd, on the primary side.

If any of the users listed in Table 2-5 “Password File Users” exist on the primary node, recreate them on the backup node. Assign the users on the backup nodes the same user and group ID as the primary nodes.

INFORMIX users must have the same passwords, as well, on both the backup and primary nodes. Beware of copying over into /etc/passwd if your HP-UX is running in Trusted System mode.

Table 2-5 Password File Users

usernameUIDGID home directoryshell
<sid>adm    
ora<sid>    
informix    
sapr3    

 



Installation Step:

Level: IS170

Look at the service file, /etc/services, on the primary side.

Replicate all services listed in Table 2-6 “Service File Services” that exist on the primary node onto the backup node.

Table 2-6 Service File Services

service nameservice port
sapdp00  
sapdp01 
. . . 
sapdp<nn> 
. . . 
sapdp99  
sapdp<nn>s 
sapgw00  
sapgw01  
. . . 
sapgw<nn> 
. . . 
sapgw99  
sapgw<nn>s 
sapms<SID>  
orasrv 
tlisrv  
sapinf<SID> 

 


 

Installation Step:

Level: IS180

Change the HP-UX kernel on the backup node to meet the SAP R/3 requirements.

Compare the Tunable Parameters section of /stand/system on both hosts. All values on the backup host must reach or exceed the values of the primary host. A tool, kinst, configures the kernel automatically. It is bundled with SAP R/3 releases prior to 3.0F.

Install all HP-UX patches that are recommended for MC/ServiceGuard and patches recommended for SAP R/3.

If you are planning to configure multiple Application Servers that are configured to be started parallel (see IS510) make sure the kernel parameter "tcp_conn_request_max" of your HP-UX systems are configured appropriately to 1024. This will prevent closing tcp ports (for example the LISTENER port configured for Oracle DB).



Installation Step:

Level: IS200

Build a new kernel with mk_kernel(1m) on the backup host if /stand/system was changed in either Step Title not available or .



Installation Step:

Level: IS210

If the primary node has the Central Instance installed:

  • Copy the <sid>adm home directory to the backup node. This is a local directory on each node.

  • Rename the start, stop and environment scripts in /home/<sid>adm on the secondary node. Some of the environment scripts may not exist. For example:

    su - <sid>adm
    mv startsap_<primary>_<INSTNR> startsap_<secondary>_<INSTNR>
    mv stopsap_<primary>_<INSTNR> stopsap_<secondary>_<INSTNR>
    mv .sapenv_<primary>.csh .sapenv_<secondary>.csh
    mv .sapenv_<primary>.sh .sapenv_<secondary>.sh
    mv .dbenv_<primary>.csh .dbenv_<secondary>.csh
    mv .dbenv_<primary>.sh .dbenv_<secondary>.sh
    # Remove logfiles from <primary> if any
    exit

    Never use the relocatable address in these filenames. If an application server was already installed, do not overwrite any files which will start the application server. If the rc-files have been modified, correct any hardcoded references to the primary hostname.



Informix Database Step:

Level: IR220

If the primary node has the INFORMIX database installed:

  • Copy the home directories of sapr3 and informix to the backup node.

  • Rename the environment scripts in /home/informix on the backup node. For example:

    su - informix
    mv .dbenv_<primary>.csh .dbenv_<secondary>.csh
    mv .dbenv_<primary>.sh .dbenv_<secondary>.sh
    exit


Oracle Database Step:

Level: OR230

If the primary node has the ORACLE database installed:

Create additional links in /oracle/<SID> on the primary node. For example:

su - ora<sid>
ln .dbenv_<primary>.csh .dbenv_<secondary>.csh
ln .dbenv_<primary>.sh .dbenv_<secondary>.sh
exit
NOTE: If you are implementing an APP server package make sure that you install the Oracle Client libraries on all nodes you run the package on. Refer to OSS Note 180430 for more details.


Oracle Database Step:

Level: OR240

If you are using ORACLE:

Create a mountpoint for the Oracle files on the backup node if it is not already there. For example:

su - ora<sid>
mkdir -p /oracle/<SID>
exit
NOTE: Complete this step also, if you are using 4.0A, the two package concept, and the backup node will be configured to run the Central Instance package only.


Optional Step:

Level: OS250

If you need different configurations of the Central Instance depending on the node it runs on:Be careful if you create different instance profiles for the different machines. You have to make sure by yourself that the Central Instance is capable of doing the intended work with any of the possible configurations.

Perform the following steps to setup different configurations:

  • Execute the command:

    su - <sid>adm
  • On each host the files /home/<sid>adm/startsap_<local>_<INSTNR> and /home/<sid>adm/stopsap_<local>_<INSTNR> contain a line that specifies the start profile. After a standard installation this line is similar to:

    START_PROFILE="START_DVEBMGS<INSTNR>_<primary>"

    Change the line individually on each host, MC/ServiceGuard in a two-node cluster:

    • On the primary host keep:

      START_PROFILE="START_DVEBMGS<INSTNR>_<primary>"
    • On the secondary host change the value in both files to:

      START_PROFILE="START_DVEBMGS<INSTNR>_<secondary>"
  • The start profile and the instance profile can be found in the shared profile directory. Be careful if you rename the instance profile. You must change all references to this file afterwards. The following is an example of the steps to create two individual configurations in a two-node cluster:

    cp /sapmnt/<SID>/profile/START_DVEBMGS<INSTNR>_<primary>\
    /sapmnt/<SID>/profile/START_DVEBMGS<INSTNR>_<secondary>
    cp /sapmnt/<SID>/profile/<SID>_DVEBMGS<INSTNR>_<primary>\
    /sapmnt/<SID>/profile/<SID>_DVEBMGS<INSTNR>_<secondary>
  • Now replace any reference to <SID>_DVEBMGS<INSTNR>_<primary>, type:

    <SID>_DVEBMGS<INSTNR>_<secondary> in the file 
    /sapmnt/<SID>/profile/START_DVEBMGS<INSTNR>_<secondary>.

 

Installation Step:

Level: IS260

If the primary node has the Central Instance installed and the other node has no internal application server installed:

Distribute the local directory tree /usr/sap/<SID>/SYS. Do not use rcp(1), it will follow all links and copy a lot of files from the shared disks that are not needed.

For example:

On the primary node:

cd /usr/sap/<SID>/SYS
find . -depth -print | cpio -o >/tmp/SYS.cpio
use ftp(1) to copy the file over to the secondary node

On the secondary node:

su - <sid>adm
mkdir -p /usr/sap/<SID>/SYS
cd /usr/sap/<SID>/SYS
cpio -id </tmp/SYS.cpio
exit


Installation Step:

Level: IS270

Import the shared volume groups using the minor numbers specified in Step Title not available.

The whole volume group distribution should be done using the command line interface. Do not use SAM. SAM will scramble the minor numbers. Specify the device minor numbers explicitly by creating the groupfile manually. For example:

mkdir /dev/vgsap<SID>
mknod /dev/vgsap<SID>/group c 64 0x080000

Now you can use vgimport(1m) with the mapfile created on the primary host during Step Title not available or Step Title not available.



Installation Step:

Level: IS275

Create a mountpoint for the Central Instance directory so the node can run the Central Instance. For example:

mkdir -p /usr/sap/<SID>/DVEBMGS<INSTNR>

Cluster Node Configuration

Repeat the steps in this section for each node of the cluster.

Logon as root.



Installation Step:

Level: IS280

Check that /etc/logingroup is a link to /etc/group.



Installation Step:

Level: IS290

Create an .rhosts file in the home directories of the HP-UX users root, <sid>adm and (if applicable) informix. Allow login for root as root from all nodes including the node you are logged into. Allow login for root and <sid>adm as <sid>adm from all nodes including the node you are logged into. Be careful with this step, many problems result from an incorrect setup of remote access.

Check the setup with remsh commands. If you have to provide a password, the .rhosts does not work.



Installation Step:

Level: IS300

Create all directories below /export as specified in Step Title not available. For example:

su - <sid>adm
mkdir -p /export/sapmnt/<SID>
mkdir -p /export/usr/sap/trans
exit
su - informix
mkdir -p /export/informix (Informix only)
exit

 

Installation Step:

Level: IS310

Add all relocatable IP address information to /etc/hosts. Do not forget heartbeat IP addresses. Use Table 2-7 “Relocatable IP Address Information” to record the addresses.

Table 2-7 Relocatable IP Address Information

name/aliasesIP address
  . . .
  . . .
  . . .
  . . .
  . . .
  . . .
  . . .
  . . .
  . . .
  . . .

 



Installation Step:

Level: IS320

If you use DNS:

Configure /etc/nsswitch.conf to avoid problems. For example:

hosts: files[NOTFOUND=continue UNAVAIL=continue \
TRYAGAIN=continue]dns


Installation Step:

Level: IS330

If you establish frontend and server LANs to separate network traffic:

Add routing entries to the internet routing configurations of /etc/rc.config.d/netconf. This is the only phase of the whole installation in which you will need to specify addresses of the server LAN. Route all relocatable client LAN addresses to the local server LAN addresses. For example, a two package concept:

ROUTE_DESTINATION[n]=<relocdb>
ROUTE_MASK[n]=""
ROUTE_GATEWAY[n]=<relocdb_s>
ROUTE_COUNT[n]=1
ROUTE_ARGS[n]=""
ROUTE_DESTINATION[n+1]=<relocci>
ROUTE_MASK[n+1]=""
ROUTE_GATEWAY[n+1]=<relocci_s>
ROUTE_COUNT[n+1]=1
ROUTE_ARGS[n+1]=""

 

Installation Step:

Level: IS335

If you have SAP R/3 4.0A or higher:

Beginning with SAP R/3 4.0A, during installation SAP R/3 appends some entries to the standard .profile files in the user home directories instead of using a new file defined by SAP R/3. On HP-UX, by default, there is the following in the given profiles:

set -u 

This confuses the .dbenv*.sh and .sapenv*.sh files of SAP R/3. They fail during execution if the environment is not setup properly. Using SGeSAP the package startup fails trying to bring up the database.

Search the .profile of <sid>adm and remove the set -u, if found.

External Application Server Host Configuration

Repeat the steps in this section for each host that has an external application server installed.

Logon as root.



Installation Step:

Level: IS340

Create an .rhosts file in the home directories of the HP-UX users root, <sid>adm and (if applicable) informix. Allow login for users root and <sid>adm from all cluster nodes.

For reasons described in Step Title not available, search .profile in the home directory of <sid>adm and remove the set -u, if found.



Installation Step:

Level: IS345

If you have SAP R/3 4.0A or higher:

For reasons described in Step Title not available, search .profile in the home directory of <sid>adm and remove the set -u, if found.



Installation Step:

Level: IS350

Add all relocatable IP address information to /etc/hosts.



Installation Step:

Level: IS360

If you establish frontend and server LANs to separate network traffic:

Add routing entries to the internet routing configurations of /etc/rc.config.d/netconf. This is the only phase of the whole installation in which you will need to specify addresses of the server LAN. Route all relocatable client LAN addresses to the local server LAN addresses. For example, a one package concept:

ROUTE_DESTINATION[n]=<relocdbci>
ROUTE_MASK[n]=""
ROUTE_GATEWAY[n]=<relocdbci_s>
ROUTE_COUNT[n]=1
ROUTE_ARGS[n]=""
Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© Hewlett-Packard Development Company, L.P.