Checking Your License
A license enables certain licensed features, features that require a license item include:
- Scripting module
- Mail module
- SNMP module
- Import/Export module
- Expiration date
- Number of SAP Systems
- Number of platform agents
A license is made of license keys that have a value, the value can be a date, number, boolean or string.
When you lack a license key, that license key will automatically have the value of false.
Navigate to "Configuration > License Keys" to inspect your license.
Your license should look similar to the one below:
Module.Scripting true
Module.ImportExport true
ProcessServerService.External.limit 100
ProcessServerService.OS.limit 100
ProcessServerService.SAP.limit 2
company.contract SLA-MSLN-PROD-1
company.name Example Inc
product.expiry 20100630
request.requesting_version 2023.3.0
signature 1;a300a310a300600a318a319a320a321a330a330400a330200a330600a340a340400a340600a350a380a380800
system.id prd1
note
In the above license, the licensee can create 100 external workload schedulers in total, that could mean 100 OS process servers (UNIX, Windows and HP OpenVMS) and no SAP process servers or 98 OS process servers and 2 SAP process servers, for example. It does not mean that the licensee can create 102 (100 OS and 2 SAP) process servers.
note
Monitoring-only process servers do not use a ProcessServerService.OS.limit key.
The following table illustrates some of the license keys that are available.
| Name | Description | Type |
|---|---|---|
| Contract.Subscription | Pricing based on process usage | Boolean |
| Module.Alerting | Active Monitoring module | Boolean |
| Module.Archiving | Active Archiving module for archiving process output to an Archive Server | Boolean |
| Module.Auditing | Auditing allows tracking of changes to objects and restoration of objects from a previous iteration. | Boolean |
| Module.Forms | Can (runtime) forms be used in any form | Boolean |
| Module.ImportExport | Import/Export of objects | Boolean |
| Module.LoadBalancing | Load balancing capabilities. | Boolean |
| Module.Mail | Can the System_Mail_Send process be used to send email | Boolean |
| Module.ProcessMonitor | ProcessMonitor support | Boolean |
| Module.Reconciliation | Activate the reconciliation interface. | Boolean |
| Module.RemoteEvent | Remote Event module that allows the jevent tool to be used. | Boolean |
| Module.Scripting | Scripting module for Redwood Script support and advanced REL functions | Boolean |
| Module.Security | Security allows custom non-rank privileges and import/export for grants. | Boolean |
| Module.SNMP | Can System_SNMP_Send process to used to send SNMP traps | Boolean |
| Module.UserMessage | UserMessage support | Boolean |
| Module.WebServices.Inbound | Module that allows the inbound web services to be published and called. | Boolean |
| PricingModel.Job | Process Based Pricing | Boolean |
| ProcessServerService.AgentInitiated | Whether agents can use reversed communication where the agent connects to the server instead of the server connecting to the agent. | Boolean |
| ProcessServerService.AS400.limit | Maximum number of AS400 process servers that can be configured. | Limit |
| ProcessServerService.External.limit | Maximum number of external process servers that can be configured. If this is defined, then the sum of defined Windows/Unix platform agents, distinct web service endpoints, and SAP (AS ABAP, AS JAVA, BusinessObjects) systems cannot exceed this value. The external process servers are also constrained by their respective keys; if defined, the most restrictive applies. Note that this key does not allow/affect HP OpenVMS platform agents. | Limit |
| ProcessServerService.GlobalExecution.limit | Maximum number of concurrent customer jobs in an active state. Step jobs are not included in the count. | Limit |
| ProcessServerService.Java.limit | Maximum number of Java agents that can be configured | Limit |
| ProcessServerService.JCL_FTP | Running JES processes via a UNIX or Windows platform agent that contacts the host via its FTP server. | Boolean |
| ProcessServerService.JDBC.limit | Maximum number of JDBC process servers that can be instantiated | Limit |
| ProcessServerService.LowVolume.threshold | Maximum number of processes that a LowVolume process server can process in one day. | Limit |
| ProcessServerService.MailConnector.limit | Maximum number of concurrent customer Mailboxes in an active polling state. | Limit |
| ProcessServerService.OraApps.limit | Maximum number of Oracle Application Servers that can be configured. | Limit |
| ProcessServerService.OracleJob | Allow activation of the OracleJob service and the PL/SQL API. | Boolean |
| ProcessServerService.OraOhi.limit | Maximum number of Oracle Health Insurance Servers that can be configured. | Limit |
| ProcessServerService.OS.limit | Maximum number of Unix and Windows platform agents that can be configured. HP OpenVMS and AS/400 are not affected by this license key. Note that this license key can be further restricted by {@link #ProcessServerService_External_limit ProcessServerService.External.limit}; if both keys exist, both must be honored. The most restrictive applies. | Limit |
| ProcessServerService.PeopleSoft.limit | Maximum number of Oracle PeopleSoft Servers that can be configured. | Limit |
| ProcessServerService.Publish.limit | Maximum number of Publish process servers that can be instantiated | Limit |
| ProcessServerService.SAP.ApplicationsAPI | Is support for the Applications API aka Business Automation Enabler (BAE) enabled. Used for Closing Cockpit, Solution Manager Integration, and SAP BW process chain type CPS. | Boolean |
| ProcessServerService.SAP.BAEConnector.limit | Maximum number of SAP BAE connectors that can be configured. | Limit |
| ProcessServerService.SAP.CalendarSync | Can SAP calendars be synchronized | Boolean |
| ProcessServerService.SAP.cc | Is Closing Cockpit integration enabled (requires ProcessServerService.SAP.ApplicationsAPI and optionally Module.Mail) | Boolean |
| ProcessServerService.SAP.iDoc | Support for iDocs. | Boolean |
| ProcessServerService.SAP.JRFC | Can jRFC be used to retrieve the output of SAP jobs | Boolean |
| ProcessServerService.SAP.limit | Maximum number of SAP process servers that can be instantiated. Note that this license key can be further restricted by ProcessServerService.External.limit; if both keys exist, both must be honored. The most restrictive applies. | Limit |
| ProcessServerService.SAP.MassActivities | Processing of mass activities. | Boolean |
| ProcessServerService.SAP.ProcessChainRestart | Restart of SAP BW Process Chains / Processes. | Boolean |
| ProcessServerService.SAP.SolutionManager | Is Solution Manager Integration enabled (requires ProcessServerService.SAP.ApplicationsAPI) | Boolean |
| ProcessServerService.SAP.XBPAllVersions | Can the Redwood transports that allow full functionality in all XBP versions be used | Boolean |
| ProcessServerService.SAP.XBPExternal | Can SAP external commands and programs be used | Boolean |
| ProcessServerService.SAP.XBPVariant | Is support for working with variants enabled | Boolean |
| ProcessServerService.SAP.XMBMessageMonitoring | Support for XMB message monitoring. | Boolean |
| ProcessServerService.SAPBOBJ.limit | Maximum number of SAP Business Objects process server services that can be configured Note that this license key can be further restricted by {@link #ProcessServerService_External_limit ProcessServerService.External.limit}; if both keys exist, both must be honored. The most restrictive applies. | Limit |
| ProcessServerService.VMS.limit | Running VMS (DCL) processes via a platform agent. | Limit |
| System.BusinessUsers.limit | Maximum number of active business users. | Limit |
| System.NamedUsers.limit | Maximum number of active named users. | Limit |
| System.Production | Is this license for a production system? If this is false then only non-production systems can be connected to. | Boolean |
| WebServices.OutboundServer.limit | Maximum number of servers that can be contacted via SOAP calls. Limited by the number of distinct SOAP Credential Endpoints. Note that this license key can be further restricted by {@link #ProcessServerService_External_limit ProcessServerService.External.limit}; if both keys exist, both must be honored. The most restrictive applies. | Limit |
note
When you install a new license from a different contract, the old license keys remain in place and have no effect. You can use the license manager to remove old licenses by deactivating the contract. The license manager is available at: http://<server>:<port>/redwood/ui/licence/manager.jsp.
note
Licenses are valid only on the system for which they were generated; a license is valid only on the system with the same hostname and port on Redwood Platform or same SID on SAP NetWeaver.
Searching License Keys
You can search for license keys using the Search License Keys box located under your username on the top right-hand side of the user interface. This is known as IntelliSearch and allows you to specify complex queries in a simple way using prefixes. Prefixes are used to specify which property you are searching in and have short as well as long syntaxes. For example, if you want to display all license keys for contract SGO-FR-0210-008-P you would use the following search criteria:
c:SGO-FR-0210-008-P
You can search more than one property, as follows:
c:SGO-FR-0210-008-P n:Module.SNMP
note
No spaces should be entered before or after the colon (: ).
See the Advanced Object Search for more information.
The following table illustrates the available prefixes for license keys:
| Prefix | Description |
|---|---|
| n, name | name of the license key (case sensitive) |
| con, contract | contract name (case sensitive) |
Special Restrictions
License Expiration
When a license has an expiration date, usually for testing purposes, and it expires, all scheduled processes will continue to run and be rescheduled by their submit frame, if applicable. You will, however, not be able to access the system via its user interface. If you are in this situation and you want to stop Redwood Server, you need to stop the Redwood Server application running in the application server. How you do this depends on your application server. You might wish to remove Redwood Server completely. See the Uninstalling Redwood Server topic for more information.
Process Server Licensing
The maximum amount of external process servers is specified by the ProcessServerService.External.limit license key, it would normally be coupled with other license keys that share the same number which are ProcessServerService.OS.limit, WebServices.OutboundServer.limit and ProcessServerService.SAP.limit. To allow you the greatest flexibility, Redwood allows you to create as many OS, web service, and SAP (AS ABAP, JAVA, BusinessObjects) process servers as you want, as long as the grand total OS process servers + web services + SAP process servers does not exceed the value defined in ProcessServerService.External.limit.
The most restrictive license key applies; this means that even if ProcessServerService.External.limit is set to a high number, if ProcessServerService.SAP.limit is set to 1 you will only be able to create a maximum of 1 SAP system in other words, if a license key is present, it has to be honored. If you only have ProcessServerService.External.limit and not ProcessServerService.SAP.limit, you may still create SAP systems, provided the grand total OS process servers + web services + SAP process servers does not exceed the value defined in ProcessServerService.External.limit.
At any time, you may shutdown and delete a process server to make room for another, regardless of being an SAP, web service or OS process server. Note, however, that to delete a process server all dependent objects, such as processes that ran on that process server, need to be deleted first.
note
Monitoring-only platform agents on Microsoft Windows and UNIX are free of charge. You can create as many of them as you require.
onsiteTopic