Sun Cluster Data Service for SAP liveCache Guide for Solaris OS

Installing and Configuring liveCache

This section contains the procedures that you need to install and configure liveCache.

ProcedureHow to Install and Configure liveCache

Use this procedure to install and configure liveCache.

  1. Install and configure SAP APO System.

    See Sun Cluster Data Service for SAP Guide for Solaris OS for the procedures on how to install and configure SAP APO System on Sun Cluster software.

  2. Install liveCache.


    Note –

    Install liveCache by using the physical hostname if you have not already created the required logical host.


    For more information, see your SAP documentation.

  3. If you are using liveCache 7.5 or compatible versions, ensure that the liveCache administrator user is in the sdba user group.

    The format of the liveCache administrator user's user ID is lc-nameadm.

    If you are creating the liveCache administrator user manually, add the following entry to the /etc/group file:

    sdba::group-id:lc-nameadm
    
    group-id

    The group's unique numerical ID (GID) within the system

    lc-name

    Lowercase name of liveCache database instance

    For more information about the /etc/group file, see the group(4) man page.

  4. Become liveCache administrator user, create the .XUSER.62 file for the SAP APO administrator user and the liveCache administrator user by using the following command.


    Note –

    This user whose home directory contains the .XUSER.62 file is an internal database user who has permissions to start, stop, and query the database.



    $ dbmcli -uk username,passwd -d LC-NAME -n logical-hostname
    
    LC-NAME

    Uppercase name of liveCache database instance

    logical-hostname

    Logical hostname that is used with the liveCache resource


    Caution – Caution –

    Neither SAP APO transaction LC10 nor Sun Cluster HA for SAP liveCache functions properly if you do not create this file correctly.


  5. Copy /usr/spool/sql from the node, on which you installed liveCache, to all the nodes that will run the liveCache resource. Ensure that the ownership of these files is the same on all node as it is on the node on which you installed liveCache.

    Example:


    # tar cfB - /usr/spool/sql | rsh destination tar xfB -
    
    destination

    Specifies the node which you are copying the /usr/spool/sql directory and its contents

  6. Copy the /etc/opt/sdb directory and its contents from the node on which you installed liveCache, to all the nodes where resources for liveCache will run. Ensure that the ownership of these files is the same on all nodes as it is on the node on which you installed liveCache.


    # tar cfB - /etc/opt/sdb | rsh destination tar xfB -
    
    destination

    Specifies the node which you are copying the /etc/opt/sdb directory and its contents

  7. Create a link from the /sapdb/LCA/db/wrk directory to the /sapdb/data/wrk directory as follows:


    # ln -s /sapdb/data/wrk /sapdb/LCA/db/wrk
    
  8. Ensure that all the required system files have been copied from the install node to all the nodes that will run the liveCache resource. The required files include /etc/group and etc/passwd.

ProcedureHow to Enable liveCache to Run in a Cluster

During a standard SAP installation, liveCache is installed with a physical hostname. You must modify liveCache to use a logical hostname so that liveCache works in a Sun Cluster environment. Use this procedure to enable liveCache to run in a cluster.

  1. Create the failover resource group to hold the network and liveCache resource.


    # clresourcegroup create [-n nodelist] livecache-resource-group
    
  2. Verify that you added all the network resources you use to your name service database.

  3. Add a network resource (logical hostname) to the failover resource group.


    # clreslogicalhostname create -g livecache-resource-group \
    -h lc-logical-hostname -d lc-logical-hostname
    

    Note –

    If you require a fully qualified hostname, you must specify the fully qualified name with the -h option and you cannot use the fully qualified form in the resource name.


  4. Enable the failover resource group.


    # clresourcegroup online -M livecache-resource-group
    
  5. Log on to the node that hosts the liveCache resource group.

  6. As the liveCache administrator user, start SAP xserver manually on the node that hosts the liveCache resource group.


    # su - lc-nameadm
    $ x_server start
    
    lc-name

    Lowercase name of liveCache database instance

  7. Log on to SAP APO System by using your SAP GUI with user DDIC.

  8. Go to transaction LC10 and change the liveCache host to the logical hostname you defined in Step 3.


    liveCache host: lc-logical-hostname