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 Prerequisites ................................................................................................................................ 11 Procedure ................................................................................................................................... 11 3.5 Advanced Remote Installation on SAP NetWeaver ................................................................................. 11 Use ............................................................................................................................................ 13 Prerequisites ................................................................................................................................ 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. 2. Check the requirements for the Central Scheduler system. See Checking Hardware and Software Requirements. 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 Requirement Disk space: 150 MB 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.

Database requirements

Required Support Package Stack

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 14

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 Download the following file: a. ETPRJSCHEDULER17_0-10004015.SCA

2.

Note
Login credentials are required to access the website.

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: Description Scheduler software with GUI

File ETPRJSCHEDULER17_0-10004015.SCA

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. 2. 3. You download and deploy the ETPRJSCHEDULER17_0-10004015.SCA. You assign administrative privileges to a user, via a role, in UME. You request and install a license for SAP CPS.

Deliverables
File ETPRJSCHEDULER17_010004015.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=<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 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.

Installation on SAP NetWeaver

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 <SAPSID>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. 2. 3. 4. Copy the file to the JSPM Inbox Directory. Start JSPM and log on as user <SAPSID>adm. Choose New Software Components, No NWDI control and choose Next. 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;. Choose Next to confirm deployment. Verify that the Status is set to Deployed and choose Exit.

5. 6.

Deploying scheduler-scripting-sda.sda (Optional): 1. 2. 3. Start SDM and log on as user <SAPSID>adm. Choose the Deployment tab. 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. Choose Next. 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. Choose Next. The SDM tells you that it is ready for deployment. Choose Start Deployment. 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. 5. 6. 7. 8.

Installation on SAP NetWeaver

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:

Installation on SAP NetWeaver

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

Procedure
Creating a role to map to a SAP CPS role 1. 2. 3. Connect to the UME in SAP NetWeaver where SAP CPS was installed. Choose Role in the drop-down box for Search Criteria. Choose Create Role and enter a name of one of the SAP CPS roles into the Unique Name field.

Installation on SAP NetWeaver

4. 5. 6.

Choose the Assigned Actions tab. Search for scheduler and choose the action name redwood.com/Scheduler.AccessScheduler, choose Add and Save. Log out of the UME.

Creating a custom role to manage isolation groups in the UME 1. 2. 3. 4. 5. 6. 7. Connect to the UME in SAP NetWeaver where SAP CPS was installed. Choose Role in the drop-down box for Search Criteria. Choose Create Role and enter a role name in the Unique Name field. Choose the Assigned Actions tab. Search for scheduler and choose the action names AccessScheduler and ManageSchedulerIsolation. Choose Add and Save. Log out of the UME.

Editing a custom role in SAP CPS 1. 2. 3. 4. 5. Navigate to Security > Roles. Choose Edit from the context menu of an editable role.Editable roles have a description: Created automatically on first login. On the Assign Privileges tab, choose an Object definition and then Next. Choose the desired range of the privileges. 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 1. 2. 3. 4. 5. 6. Connect to the UME in SAP NetWeaver where SAP CPS was installed. Fill in the Search Criteria field and locate the user. Choose the user, and choose the Assigned Roles tab. Search for one of the roles previously created, and choose Add. Choose Add and Save. Log out of the UME.

Values
Assign Privileges
Object Definition - The role name. Grantable - If this option is selected, the user can grant this role to any other user.

Installation on SAP NetWeaver

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. 2. 3. 4. 5. 6. Connect to http://sapnwprd.masalan.com:50200/useradmin using the Administrator login Choose Role in the drop-down box for Search Criteria. Choose Create Role and enter scheduler-event-operator into the Unique Name field. Choose the Assigned Actions tab. Search for scheduler and choose the action name AccessScheduler, choose Add and Save. Log out of the UME.

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.

Installation on SAP NetWeaver

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. 2. 3. 4. Connect to the User Management interface in SAP Netweaver where SAP CPS was installed. Choose Create User and fill in the data. Add this user to at least one of the roles created during the installation of SAP CPS. Log on with this user in SAP CPS.

Disable a user from logging into SAP CPS 1. 2. Navigate to Security > U.ers. 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/ManageSchedulerIsolation 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.

Installation on SAP NetWeaver

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. 2. 3. 4. Navigate to Security > Isolation Groups. Choose New from the context menu. Enter a name for the isolation group. Names should be all upper case. Choose Save & Close to exit edit dialog.

Assign an isolation group to users 1. 2. 3. 4. 5. Navigate to Security > Isolation Groups. Choose Import Users Use the search dialog to locate users from the Authentication system, wildcard * and ? are allowed. Select the users to import and choose Import. 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
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

Installation on SAP NetWeaver

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://<sever>:<port>/scheduler/ui/licence/request1.jsp Fill in a company name and proceed to the following screen. 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. Once you have received the license, you can paste it into the following window. If you closed the window, you may proceed to http://<sever>:<port>/scheduler/ui/licence/request1.jsp; note that this time, since you have the license, there is no need to send another email.

2. 3. 4.

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://<sever>:<port>/scheduler/ui/licence/request1.jsp Fill in a company name and choose Generate Free of Charge License.

2.

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

Installation on SAP NetWeaver

Using SDM for remote deployments

SDM lives in /usr/sap/<SID>/<central instance>/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
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, you can safely run /usr/sap/<SID>/<central instance>/j2ee/JSPM/go.bat 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/<SID>/<central instance>/j2ee/JSPM/go on Unix clients or /usr/sap/<SID>/<central instance>/j2ee/JSPM/go.bat on Windows clients 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. ii. Copy StartGui.bat and the lib directory from /usr/sap/<SID>/<centralinstance>/j2ee/JSPM to your system. go to /usr/sap/<SID>/<central instance>/j2ee/JSPM/param and open the file jspm_config.txt; in that file change the line /dialog/SDTServerConnection/SDTGui/launch = true to /dialog/SDTServerConnection/SDTGui/launch = false

b.

c.

iii. save the change iv. v. start the go command again; it should come up with the Waiting for SDTServer to connect on hostname.. message Start StartGui.bat on your machine and specify the host and port from the message

12

Installation on SAP NetWeaver

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. 2. Copy the whole SDM directory, /usr/sap/<SID>/<central instance>/SDM/program over to your machine. Edit the following files: a. b. c. 3. SDM/program/RemoteGui.bat - fix the paths SDM/program/sdm_prep_com.bat - fix the paths SDM/program/sdm_jdk.bat - fix the path to your Java home directory

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