sap cps quick install guide

SAP CPS Quick Install Guide

Table of Contents1. Preparation for SAP NetWeaver ..................................................................................................................... 1

1.1 Checking Hardware and Software Requirements ..................................................................................... 1Required Support Package Stack ....................................................................................................... 1

1.2 Preparing the Installation Files ............................................................................................................. 12. Prerequisites for SAP NetWeaver ................................................................................................................... 23. Installation on SAP NetWeaver ...................................................................................................................... 3

Purpose ................................................................................................................................................ 5Process Flow ......................................................................................................................................... 5Deliverables .......................................................................................................................................... 5Prerequisites ......................................................................................................................................... 5Procedure ............................................................................................................................................. 5Backup Strategy for SAP CPS .................................................................................................................. 53.1 Creating Roles in SAP NetWeaver ........................................................................................................ 5

Use ............................................................................................................................................. 8Prerequisites ................................................................................................................................. 8Procedure ..................................................................................................................................... 8Values .......................................................................................................................................... 8Example ....................................................................................................................................... 8

3.2 Creating Users in SAP NetWeaver ........................................................................................................ 8Use ............................................................................................................................................. 9Prerequisites ................................................................................................................................. 9Procedure ..................................................................................................................................... 9Values .......................................................................................................................................... 9

3.3 Assigning Isolation Groups in SAP NetWeaver ....................................................................................... 9Use ............................................................................................................................................ 10Prerequisites ................................................................................................................................ 10Procedure ................................................................................................................................... 10

3.4 Installing a License .......................................................................................................................... 10Use ............................................................................................................................................ 11Prerequisites ................................................................................................................................ 11Procedure ................................................................................................................................... 11

3.5 Advanced Remote Installation on SAP NetWeaver ................................................................................. 11Use ............................................................................................................................................ 13Prerequisites ................................................................................................................................ 13Procedure ................................................................................................................................... 13

iii

Chapter 1. Preparation for SAP NetWeaverBefore you start the installation and configuration of the Central Scheduler system, you have to complete the following steps:

1. Check the requirements for the Central Scheduler system. See Checking Hardware and Software Requirements.

2. Prepare the installation files. See Preparing the Installation Files.

1.1 Checking Hardware and Software RequirementsThe following table lists the requirements.

The installation host for the Central Scheduler system must meet the following requirements:

RequirementRequirement Type

Disk space: 150 MBHardware requirements

For the supported operating system releases, see the Product Availability Matrix on SAPService Marketplace at service.sap.com/pam. Support Package Stack (SPS) applied to theSAP systems. See the Required Support Package Stack section of Chapter 3.

Software requirements

All databases supported by SAP NetWeaver are supported, for SAP DB, however, version7.7.0.27 or later is required. If you do not have this version, please make sure you understandthe SAP DB version numbering [http://www.sapdb.org/7.4/htmhelp/e3/-c238a9a4a94e9dbde129cbdbea9959/content.htm]. You need at least SAP DB 7.7 build 27.

Database requirements

Required Support Package StackYou should upgrade the SAP system on the Central Scheduler installation host to the necessary SPS level as outlined in thetable below:

Required SPS Level (Central Scheduling System)

SPS NumberRelease Number

14700

To get consistent job handling on the satellite systems, you should upgrade the satellite systems in question to the latest SupportPackage Stack.

1.2 Preparing the Installation Files1. Download the installation file. The file is available on SAP Service Marketplace at: service.sap.com/swdc -> Download

-> Support Packages and Patches -> Entry by Application Group -> SAP NetWeaver -> SAP NETWEAVER -> SAPNETWEAVER 7.0 (2004S) -> SAP Central Process Scheduling by Redwood -> SAP CPS for NW 7.0

2. Download the following file:

a. ETPRJSCHEDULER17_0-10004015.SCA

Note

Login credentials are required to access the website.

1

http://www.sapdb.org/7.4/htmhelp/e3/c238a9a4a94e9dbde129cbdbea9959/content.htm

Chapter 2. Prerequisites for SAP NetWeaverInstallation requires:

• A fully functional SAP NetWeaver 7.0 SP14 installation.

• Hostname and HTTP port number for Netweaver applications. The default HTTP port number is 50000.

• SAP username/password for the Netweaver application server with privileges to deploy Software and create/modify SAPusers and roles.

• The following deliverable:

DescriptionFile

Scheduler software with GUIETPRJSCHEDULER17_0-10004015.SCA

2

Chapter 3. Installation on SAP NetWeaverPurpose

This section tells you how to install and configure the Central Scheduler system on Windows and UNIX. You need direct accessto the NetWeaver system to perform the deployment procedure described below, remote deployment is described in the sectionRemote Installation on SAP NetWeaver.

Process Flow1. You download and deploy the ETPRJSCHEDULER17_0-10004015.SCA.

2. You assign administrative privileges to a user, via a role, in UME.

3. You request and install a license for SAP CPS.

DeliverablesRequiredDescriptionFile

AlwaysScheduler software with GUIETPRJSCHEDULER17_0-10004015.SCA.

Optional, provides additional function-ality

Provides Java access to the repository.scheduler-scripting-sda.sda

You deploy the SCA file using the Java Support Package Manager (JSPM). You have to deploy the SCA file as a new softwarecomponent.

You deploy SDA files using Software Deployment Manager (SDM).

For more information on starting JSPM, please consult the SAP Help Portal, http://help.sap.com/saphelp_nwpi71/help-data/en/87/4797422930c56ae10000000a155106/frameset.htm.

To deploy a file using JSPM, you need to know the location of the JSPM Inbox Directory, perform the following commandto detect it:

sappfpar pf=<install_directory>:\usr\sap\<SID>\SYS\profile\<SID>_<Central instance name>_<host> DIR_EPS_ROOT

Note

Make sure this directory only contains packages that you want to install at this moment as JSPM will install allpackages in contained in this directory, by default. You can choose to skip one or more packages, the SAP CPSpackage is named redwood.com/&package;.

You use the SCA file to deploy the following actions in AS Java:

• redwood.com/Scheduler.AccessScheduler

• redwood.com/Scheduler.ManageScheduler

These actions contain the permissions for SAP CPS that need to be granted to roles.

3

http://help.sap.com/saphelp_nwpi71/helpdata/en/87/4797422930c56ae10000000a155106/frameset.htm


You use the SDA file to deploy a scripting environment which allows you to use RedwoodScript; a Java-based scripting languagewith a subset of Java classes. RedwoodScript can be used in a Shell as well as in jobs to interact with the Central Scheduler.Please refer to the Administration Guide for more details.

The Advanced Scripting Module is delivered with extensive API documentation. Please contact your Sales Representative ifyou require the Advanced Scripting Module.

Prerequisites• JSPM Inbox Directory

• <SAPSID>adm credentials

• SDM needs to be started and available, only one connection to the SDM is allowed at any given time.

ProcedureDeploying ETPRJSCHEDULER17_0-10004015.SCA

1. Copy the file to the JSPM Inbox Directory.

2. Start JSPM and log on as user <SAPSID>adm.

3. Choose New Software Components, No NWDI control and choose Next.

4. If there are one or more packages you do not want to install, please choose Skip under Target Release.SPLevel.PatchLevelto skip the installation of unwanted packages. Choose Next to check the deliverable(s). SAP CPS deliverables start withredwood.com and should be installed if you were instructed to. The name of the Central Scheduler package is red-wood.com/&package;.

5. Choose Next to confirm deployment.

6. Verify that the Status is set to Deployed and choose Exit.

Deploying scheduler-scripting-sda.sda (Optional):

1. Start SDM and log on as user <SAPSID>adm.

2. Choose the Deployment tab.

3. Choose Add SCA/SDA to Deployment List (Local File Browser), navigate to the location of the scheduler-scripting-sda.sda archive. Select scheduler-scripting-sda.sda choose Choose. After the archive has been loaded,you see a list of information about the version, software type, number of dependencies, and the archive name.

4. Choose Next.

5. The SDM determines the Deployment Action from the manifest data and displays the data in the archive list. The Repos-itory Preview shows you how the SDA's are distributed in the SDM Repository.

6. Choose Next.

7. The SDM tells you that it is ready for deployment. Choose Start Deployment.

8. A message appears at the end of the deployment process. If the message says that the deployment was successful, chooseConfirm to confirm the deployment. If there was an error, the message will provide information about it.

4

Installation on SAP NetWeaver

Note

If an error occurs and you have to perform the deployment in SDM again, deployments that were successfully per-formed are not repeated.

Starting & Stopping SAP CPS

When setup and configuration of SAP CPS have been finished, SAP CPS starts and stops together with the hosting SAPNetWeaver AS Java. Starting and stopping SAP NetWeaver AS Java is described in great detail in SAP Help Portal. For moredetails, please see:

http://help.sap.com/saphelp_nw70/helpdata/en/71/1c9a4267f9c66ae10000000a155106/frameset.htm

Backup Strategy for SAP CPSSince SAP CPS is a mission critical component of your SAP system landscape, SAP strongly recommends to set up a backupstrategy. When you encounter issues, you can restore and, if required, recover your system from a specific point in time.

SAP CPS is backed up together with the hosting SAP NetWeaver AS Java. Backups can be performed online. The backupstrategy and the tools being used are database specific. Detailed information about the strategy and tools for each SAP NetWeaverdatabase can be found here:

http://help.sap.com/saphelp_nw70/helpdata/en/29/7d4ed11dc11d45a73850df6e8a1bac/frameset.htm

3.1 Creating Roles in SAP NetWeaver

UseA role is a set or group of privileges that can be granted to users or other roles. Roles are part of the Security section in thenavigation bar.

The following standard roles are provided with SAP CPS:

• scheduler-administrator - can perform all actions.

• scheduler-event-operator - can raise and clear events.

• scheduler-job-administrator - can create/edit/delete event definitions, job definitions, job chains. Can modifyjobs.

• scheduler-user - has access to SAP CPS only, cannot see any objects.

• scheduler-viewer - read only access to all objects.

• scheduler-isolation-administrator - can create/edit/delete isolation groups and add users to these.

• scheduler-screen-reader - indicates that you are using a screen reader.

These are the standard roles, it is not possible to create roles directly in SAP CPS, or edit the standard roles. You create a rolewith the corresponding name in the UME, assign it the redwood.com/Scheduler.AccessScheduler action and grant it to SAPCPS users. Once you grant these roles to users in the UME, the users will get the corresponding SAP CPS roles granted andhave the privileges granted to these roles as soon as they log on.

The UME also allows you to grant SAP CPS privileges directly to roles via the following actions:

5


http://help.sap.com/saphelp_nw70/helpdata/en/71/1c9a4267f9c66ae10000000a155106/frameset.htm

http://help.sap.com/saphelp_nw70/helpdata/en/29/7d4ed11dc11d45a73850df6e8a1bac/frameset.htm

• redwood.com/Scheduler.AccessScheduler - read-only access, all roles that you want to use in SAP CPS must have thisaction assigned.

• redwood.com/Scheduler.ManageScheduler - scheduler Administrator (same as scheduler-administrator role)

• redwood.com/Scheduler.ManageSchedulerIsolation - isolation group administrator (same as scheduler-isolation-administrator role); you are not allowed to grant the redwood.com/Scheduler.ManageScheduler action to the samerole.

SAP strongly recommends you start by creating the above roles in the UME and assign them the redwood.com/Scheduler.Ac-cessScheduler action. Once that is done, you grant these roles to users. If the roles do not exactly suit your needs, create customroles (with names that do not match the above roles) in the UME and assign them the same action; these roles will be editablein SAP CPS and allow you to extend privileges of users.

Granting Privileges

You can grant privileges to custom roles. Custom roles are recognizable by the name (it is not allowed to be one of the above)as well as the description and comment fields, which contain Created automatically on first login.

Some privileges are not dependent on a partition or isolation group, these are known as global Privileges.

You grant specific privileges to roles for each object type; available privileges are dependent on the object. These privilegesare known as system privileges and are granted via the role object. There are two levels at which you can grant system privileges,Access and Admin. Privileges granted with the Admin level allow the grantee to grant the privileges to other users.

You can also grant privileges for specific objects on object-level to users or roles, these are known as object privileges andare granted via the Security tab on the object.

The following topics in the Security Guide and Administration Guide provide more information on security:

• System Privileges

• Object Privileges

• Granting and Revoking System Privileges

• Granting or Revoking Object Privileges

Prerequisites• The URL to the Netweaver UME. Usually http://<host>:<port>/useradmin

• An account with sufficient privileges to create a role and add members to the role.

• The username and password of a user you add to the role.

• A Scheduler Manager user account for SAP CPS

ProcedureCreating a role to map to a SAP CPS role

1. Connect to the UME in SAP NetWeaver where SAP CPS was installed.

2. Choose Role in the drop-down box for Search Criteria.

3. Choose Create Role and enter a name of one of the SAP CPS roles into the Unique Name field.

6


4. Choose the Assigned Actions tab.

5. Search for scheduler and choose the action name redwood.com/Scheduler.AccessScheduler, choose Add and Save.

6. Log out of the UME.

Creating a custom role to manage isolation groups in the UME



3. Choose Create Role and enter a role name in the Unique Name field.


5. Search for scheduler and choose the action names AccessScheduler and ManageSchedulerIsolation.

6. Choose Add and Save.


Editing a custom role in SAP CPS

1. Navigate to Security > Roles.

2. Choose Edit from the context menu of an editable role.Editable roles have a description: Created automatically on firstlogin.

3. On the Assign Privileges tab, choose an Object definition and then Next.

4. Choose the desired range of the privileges.

5. Choose a Rank with the desired privileges. Admin privileges allow the user to perform the action and to grant the privilegeto others as well. Access privileges allow the user to perform the actions.

Assigning a user to a role


2. Fill in the Search Criteria field and locate the user.

3. Choose the user, and choose the Assigned Roles tab.

4. Search for one of the roles previously created, and choose Add.

5. Choose Add and Save.


Values

Assign Privileges

• Object Definition - The role name.

• Grantable - If this option is selected, the user can grant this role to any other user.

7


Assigned Global Privileges

• Granted Subject - The privilege name.

• Grantable - If this option is selected, the user can grant this privilege to any other user.

Example• The URL to the Netweaver UME http://sapnwprd.masalan.com:50200/useradmin

• The account with sufficient privileges to create a role and add members to the role is Administrator

• The username and password of the user to add to the role is masalan and process1 respectively, created previously.

• The Scheduler Manager user account is ProcAdmin.

Creating a role that maps to the scheduler-event-operator SAP CPS role

1. Connect to http://sapnwprd.masalan.com:50200/useradmin using the Administrator login


3. Choose Create Role and enter scheduler-event-operator into the Unique Name field.


5. Search for scheduler and choose the action name AccessScheduler, choose Add and Save.


3.2 Creating Users in SAP NetWeaver

UseUsers represent users of the system and can have roles granted to them in order to have privileges to perform actions.

Users are part of the Security section in the navigation bar. The following standard users are provided with SAP CPS:

• Redwood System - a user that represents the system.

Users are imported automatically from the SAP User Management Engine (UME) as soon as they log on for the first time andkept in sync with UME at each login. This synchronization only occurs one way, from UME to SAP CPS. Users are createdin UME and cannot be created in SAP CPS. They must have the following action assigned to at least one of their roles to getread-only access:

• redwood.com/Scheduler.AccessScheduler

Administrator users additionally have the UME role scheduler-administrator or the following action assigned toone of their roles:

• redwood.com/Scheduler.ManageScheduler

To view all the available users, choose Security > Users in the Navigation bar.

You can enable and disable login for a user, when you disable login for a user, the user will be notified at the next login attemptthat the user has no access to the system.

8


Prerequisites• A user account and password with appropriate privileges for managing users in the SAP Netweaver system where SAP

CPS was installed.

• The URL to the User Management interface of the SAP Netweaver system where SAP CPS was installed.

ProcedureCreate a user in SAP NetWeaver UME

1. Connect to the User Management interface in SAP Netweaver where SAP CPS was installed.

2. Choose Create User and fill in the data.

3. Add this user to at least one of the roles created during the installation of SAP CPS.

4. Log on with this user in SAP CPS.

Disable a user from logging into SAP CPS

1. Navigate to Security > U.ers.

2. Choose Disable Login from the context menu of the user

Values

User

• Name - The name of the user.

• Description - The description of the user.

• Comment - A comment about the user.

• Creation Time - The time the user ID was created.

• Last Modification time - The last time the user ID was modified.

3.3 Assigning Isolation Groups in SAP NetWeaver

UseWith an isolation group, a user is limited to interacting with objects of the same isolation group as well as objects from theGLOBAL isolation group. You assign users to isolation groups in the Security section in the navigation bar. The user musteither have the role scheduler-isolation-administrator or a custom role granted which has the redwood.com/ManageScheduler-Isolation action to be able to add users to an isolation group. Users can have multiple isolation groups; in this case, the userneeds to choose an isolation group for the session during logon.

Note

In the Free of Charge version, only one SAP client can be in an isolation group. This is governed by the value ofthe System.SharedPartitions license key.

9


Prerequisites• the user needs the role scheduler-isolation-administrator or a custom role granted which has the redwood.com/Scheduler.Ac-

cessScheduler action.

ProcedureCreate an isolation group

1. Navigate to Security > Isolation Groups.

2. Choose New from the context menu.

3. Enter a name for the isolation group. Names should be all upper case.

4. Choose Save & Close to exit edit dialog.

Assign an isolation group to users

1. Navigate to Security > Isolation Groups.

2. Choose Import Users

3. Use the search dialog to locate users from the Authentication system, wildcard * and ? are allowed.

4. Select the users to import and choose Import.

5. Close the window when you are finished importing users into the isolation group.

3.4 Installing a License

UseAfter a successful installation and login, you will be presented with the licensing page. If you have purchased a license, youcan generate a license request, send it to Redwood Software and you will be provided with a license as well as instructions onhow to install the license.

You can also use the Free of Charge license, which does not require you to send an email to Redwood Software. On the licensingpage, you need to fill in your company name and choose Generate Free of Charge License. Note that a lot of features are disabledwith the Free of Charge license and your SAP instances are isolated from each other in SAP CPS; you can only schedule jobsin one SAP system per session.

Note

The Free of Charge license is only available for installations on SAP NetWeaver.

Prerequisites• The full URL to the SAP CPS installation

• An email account to request the license, which will be sent inline to that account.

10


ProcedureGenerate a license request and install the license

1. Log on to SAP CPS If the licensing page does not appear, or you want to install a new license, go to ht-tp://<sever>:<port>/scheduler/ui/licence/request1.jsp

2. Fill in a company name and proceed to the following screen.

3. The text displayed needs to be sent to Redwood Software, it is required for the license generation, please copy-paste itinto an email message or use the link provided and send the email.

4. Once you have received the license, you can paste it into the following window. If you closed the window, you mayproceed to http://<sever>:<port>/scheduler/ui/licence/request1.jsp; note that this time, sinceyou have the license, there is no need to send another email.

Use the Free of Charge license

1. Log on to SAP CPS If the licensing page does not appear, or you want to install a new license, go to ht-tp://<sever>:<port>/scheduler/ui/licence/request1.jsp

2. Fill in a company name and choose Generate Free of Charge License.

3.5 Advanced Remote Installation on SAP NetWeaver

UseYou are advised to follow the standard deployment instructions if you can, which are described in the 5.1 Installation on SAPNetWeaver section.

The Software Deployment Manager (SDM) server deploys Software in SAP NetWeaver, you use the SDM Gui or the JavaSupport Package Manager (JSPM) client to load archives in the form of war, ear, sca or sda files into SDM. SDM Gui can beused to deploy all these file types, however, the use of JSPM is highly recommended for the deployment of sda files, JSPMdoes not support the other file formats.

You usually access the JSPM or SDM Gui on the NetWeaver server itself, this requires direct access to the server, which canbe an issue for some companies, It is possible to deploy software on NetWeaver servers from remote clients.

JSPM requires you to copy the archives to the JSPM inbox on the NetWeaver server, SDM allows you to load the files fromthe client, which can be stored locally or on a network share.

Using JSPM for remote deployments

For information on starting JSPM, please consult the SAP Help Portal, http://help.sap.com/saphelp_nwpi71/help-data/en/87/4797422930c56ae10000000a155106/frameset.htm.

To deploy a file using JSPM, you need to know the location of the JSPM Inbox Directory, perform the following commandto detect it:

sappfpar pf=<install_directory>:\usr\sap\<SID>\SYS\profile\<SID>_<Central instance name>_<host> DIR_EPS_ROOT

Refer to 5.1 Installation on SAP NetWeaver for more information on deploying software with JSPM.

11




Using SDM for remote deployments

SDM lives in /usr/sap/<SID>/<central instance>/SDM/program.The command is named RemoteGui withthe sh extension for Unix and bat for Windows.

It is a graphical tool and if the NetWeaver system is running on a GNU/Linux or Unix system you need an X Server runningon your Windows machine.

Note

SDM has been removed from SAP NetWeaver as of release 7.10.

Prerequisites• Location fo the JSPM inbox directory, if you are going to use JSPM

• Credentials of the <SID>adm user of the target NetWeaver system

• An X server on your Windows Client, if you plan on using SDM remotely and your NetWeaver system is installed on Unix

Procedure

Using JSPM from a remote client

1. Copy the archive into the JSPM inbox directory. Use the following command to detect the location of the directory:

sappfparpf=<install_directory>:\usr\sap\<SID>\SYS\profile\<SID>_<Central instance name>_<host> DIR_EPS_ROOT

1. Determine your situation:

a. Your NetWeaver instance is installed on a Windows system and you are accessing it from a Windows client, youcan safely run /usr/sap/<SID>/<central instance>/j2ee/JSPM/go.bat

b. Your NetWeaver instance is installed on a Unix system and you are using a Unix system as a client or your Windowsinstallation has an X server you can safely run /usr/sap/<SID>/<central instance>/j2ee/JSPM/goon Unix clients or /usr/sap/<SID>/<central instance>/j2ee/JSPM/go.bat on Windows clients

c. Your NetWeaver instance is installed on a Unix system and your Windows installation does not have an X server,you will have to copy part of the JSPM directory structure to your system, change some files and run JSPM fromyou computer.

i. Copy StartGui.bat and the lib directory from /usr/sap/<SID>/<centralinstance>/j2ee/JSPM to your system.

ii. go to /usr/sap/<SID>/<central instance>/j2ee/JSPM/param and open the file jspm_config.txt; in that file changethe line /dialog/SDTServerConnection/SDTGui/launch = true to /dialog/SDTServer-Connection/SDTGui/launch = false

iii. save the change

iv. start the go command again; it should come up with the “Waiting for SDTServer to connect on hostname.. “message

v. Start StartGui.bat on your machine and specify the host and port from the message

12


Note

A supported X server on Windows is Hummingbird Exceed, other x servers may work, some have been reported todisplay an unresponsive GUI.

Using SDM from a remote client

1. Copy the whole SDM directory, /usr/sap/<SID>/<central instance>/SDM/program over to your machine.

2. Edit the following files:

a. SDM/program/RemoteGui.bat - fix the paths

b. SDM/program/sdm_prep_com.bat - fix the paths

c. SDM/program/sdm_jdk.bat - fix the path to your Java home directory

3. Run RemoteGui.bat

Note

If your NetWeaver server is on a Unix-based system, you will need an X server on your Windows system.

13


sap cps quick install guide

Documents