SAP CPS Quick Install Guide - Redwood Software

SAP CPS Quick Install Guide

SAP CPS Quick Install Guide

Table of Contents 

1. Preparation for SAP NetWeaver ..................................................................................................................... 1 

1.1 Checking Hardware and Software Requirements ..................................................................................... 1 

Required Support Package Stack ....................................................................................................... 1 

1.2 Preparing the Installation Files ............................................................................................................. 1 

2. Prerequisites for SAP NetWeaver ................................................................................................................... 2 

3. Installation on SAP NetWeaver ...................................................................................................................... 3 

Purpose ................................................................................................................................................ 5 

Process Flow ......................................................................................................................................... 5 

Deliverables .......................................................................................................................................... 5 

Prerequisites ......................................................................................................................................... 5 

Procedure ............................................................................................................................................. 5 

Backup Strategy for SAP CPS .................................................................................................................. 5 

3.1 Creating Roles in SAP NetWeaver ........................................................................................................ 5 

Use ............................................................................................................................................. 8 

Prerequisites ................................................................................................................................. 8 

Procedure ..................................................................................................................................... 8 

Values .......................................................................................................................................... 8 

Example ....................................................................................................................................... 8 

3.2 Creating Users in SAP NetWeaver ........................................................................................................ 8 

Use ............................................................................................................................................. 9 

Prerequisites ................................................................................................................................. 9 

Procedure ..................................................................................................................................... 9 

Values .......................................................................................................................................... 9 

3.3 Assigning Isolation Groups in SAP NetWeaver ....................................................................................... 9 

Use ............................................................................................................................................ 10 

Prerequisites ................................................................................................................................ 10 

Procedure ................................................................................................................................... 10 

3.4 Installing a License .......................................................................................................................... 10 

Use ............................................................................................................................................ 11 


Procedure ................................................................................................................................... 11 

3.5 Advanced Remote Installation on SAP NetWeaver ................................................................................. 11 

Use ............................................................................................................................................ 13 


Procedure ................................................................................................................................... 13 

iii

Chapter 1. Preparation for SAP NetWeaver 

Before 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 Requirements 

The following table lists the requirements. 

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

Requirement Type 

Hardware requirements 

Software requirements 

Database requirements 

Requirement 

Disk space: 150 MB 

Required Support Package Stack 

For the supported operating system releases, see the Product Availability Matrix on SAP 

Service Marketplace at service.sap.com/pam. Support Package Stack (SPS) applied to the 

SAP systems. See the Required Support Package Stack section of Chapter 3. 

All databases supported by SAP NetWeaver are supported, for SAP DB, however, version 

7.7.0.27 or later is required. If you do not have this version, please make sure you understand 

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

You should upgrade the SAP system on the Central Scheduler installation host to the necessary SPS level as outlined in the 

table below: 

Required SPS Level (Central Scheduling System) 

Release Number 

700 

SPS Number 

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

Package Stack. 

1.2 Preparing the Installation Files 

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

NETWEAVER 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 

14

Chapter 2. Prerequisites for SAP NetWeaver 

Installation 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 SAP 

users and roles. 

• The following deliverable: 

File 

ETPRJSCHEDULER17_0-10004015.SCA 

2 

Description 

Scheduler software with GUI

Chapter 3. Installation on SAP NetWeaver 

Purpose 

This section tells you how to install and configure the Central Scheduler system on Windows and UNIX. You need direct access 

to the NetWeaver system to perform the deployment procedure described below, remote deployment is described in the section 

Remote Installation on SAP NetWeaver. 

Process Flow 

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

Deliverables 

File 

ETPRJSCHEDULER17_0- 

10004015.SCA. 

scheduler-scripting-sda.sda 

Description 

Scheduler software with GUI 

Provides Java access to the repository. 

Required 

Always 

Optional, provides additional functionality 

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

component. 

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/helpdata/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 command 

to detect it: 

sappfpar pf=:\usr\sap\\SYS\profile\__ DIR_EPS_ROOT 

Note 

Make sure this directory only contains packages that you want to install at this moment as JSPM will install all 

packages in contained in this directory, by default. You can choose to skip one or more packages, the SAP CPS 

package 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

You use the SDA file to deploy a scripting environment which allows you to use RedwoodScript; a Java-based scripting language 

with 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 if 

you require the Advanced Scripting Module. 

Prerequisites 

• JSPM Inbox Directory 

• adm credentials 

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

Procedure 

Deploying ETPRJSCHEDULER17_0-10004015.SCA 

1. Copy the file to the JSPM Inbox Directory. 

2. Start JSPM and log on as user 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.PatchLevel 

to skip the installation of unwanted packages. Choose Next to check the deliverable(s). SAP CPS deliverables start with 

redwood.com and should be installed if you were instructed to. The name of the Central Scheduler package is redwood.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 adm. 

2. Choose the Deployment tab. 

3. Choose Add SCA/SDA to Deployment List (Local File Browser), navigate to the location of the scheduler-scriptingsda.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 Repository 

Preview shows you how the SDA's are distributed in the SDM Repository. 

6. Choose Next. 

Installation on SAP NetWeaver 

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

Confirm to confirm the deployment. If there was an error, the message will provide information about it. 

4

Note 

If an error occurs and you have to perform the deployment in SDM again, deployments that were successfully performed 

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 SAP 

NetWeaver AS Java. Starting and stopping SAP NetWeaver AS Java is described in great detail in SAP Help Portal. For more 

details, please see: 

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

Backup Strategy for SAP CPS 

Since SAP CPS is a mission critical component of your SAP system landscape, SAP strongly recommends to set up a backup 

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

strategy and the tools being used are database specific. Detailed information about the strategy and tools for each SAP NetWeaver 

database can be found here: 

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

3.1 Creating Roles in SAP NetWeaver 

Use 

A 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 the 

navigation 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 modify 

jobs. 

• 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 role 

with the corresponding name in the UME, assign it the redwood.com/Scheduler.AccessScheduler action and grant it to SAP 

CPS users. Once you grant these roles to users in the UME, the users will get the corresponding SAP CPS roles granted and 

have 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

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

action assigned. 

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

• redwood.com/Scheduler.ManageSchedulerIsolation - isolation group administrator (same as scheduler-isolationadministrator 

role); you are not allowed to grant the redwood.com/Scheduler.ManageScheduler action to the same 

role. 

SAP strongly recommends you start by creating the above roles in the UME and assign them the redwood.com/Scheduler.AccessScheduler 

action. Once that is done, you grant these roles to users. If the roles do not exactly suit your needs, create custom 

roles (with names that do not match the above roles) in the UME and assign them the same action; these roles will be editable 

in 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 privileges 

are 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 and 

are 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://:/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 

Procedure 

Creating 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 first 

login. 

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 privilege 

to 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 

Use 

Users 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 and 

kept in sync with UME at each login. This synchronization only occurs one way, from UME to SAP CPS. Users are created 

in UME and cannot be created in SAP CPS. They must have the following action assigned to at least one of their roles to get 

read-only access: 

• redwood.com/Scheduler.AccessScheduler 

Administrator users additionally have the UME role scheduler-administrator or the following action assigned to 

one 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 attempt 

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

Procedure 

Create 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 

Use 

With an isolation group, a user is limited to interacting with objects of the same isolation group as well as objects from the 

GLOBAL isolation group. You assign users to isolation groups in the Security section in the navigation bar. The user must 

either 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 user 

needs 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 of 

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

action. 

Procedure 

Create 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 

Use 

After a successful installation and login, you will be presented with the licensing page. If you have purchased a license, you 

can generate a license request, send it to Redwood Software and you will be provided with a license as well as instructions on 

how 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 licensing 

page, you need to fill in your company name and choose Generate Free of Charge License. Note that a lot of features are disabled 

with the Free of Charge license and your SAP instances are isolated from each other in SAP CPS; you can only schedule jobs 

in one SAP system per session. 

Note 

Prerequisites 

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

• The full URL to the SAP CPS installation 


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

10

Procedure 

Generate 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 http://:/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 it 

into 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 may 

proceed to http://:/scheduler/ui/licence/request1.jsp; note that this time, since 

you 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 http://:/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 

Use 

You are advised to follow the standard deployment instructions if you can, which are described in the 5.1 Installation on SAP 

NetWeaver section. 

The Software Deployment Manager (SDM) server deploys Software in SAP NetWeaver, you use the SDM Gui or the Java 

Support Package Manager (JSPM) client to load archives in the form of war, ear, sca or sda files into SDM. SDM Gui can be 

used to deploy all these file types, however, the use of JSPM is highly recommended for the deployment of sda files, JSPM 

does 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 can 

be 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 from 

the 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/helpdata/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 command 

to detect it: 

sappfpar pf=:\usr\sap\\SYS\profile\__ 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///SDM/program. The command is named RemoteGui with 

the 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 running 

on your Windows machine. 

Note 

Prerequisites 

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

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

• Credentials of the 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=:\usr\sap\\SYS\profile\__ 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, you 

can safely run /usr/sap///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 Windows 

installation has an X server you can safely run /usr/sap///j2ee/JSPM/go 

on Unix clients or /usr/sap///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 from 

you computer. 

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

ii. go to /usr/sap///j2ee/JSPM/param and open the file jspm_config.txt; in that file change 

the 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 to 

display an unresponsive GUI. 

Using SDM from a remote client 

1. Copy the whole SDM directory, /usr/sap///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 - Redwood Software

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?