Creating a Process Server
A Process server is used to schedule, control, and execute your processes.
A process server:
- Provides resources.
- Accepts processes from a queue via a queue provider.
- Has services that execute processes.
- Can represent a remote system, for example an SAP system or a UNIX server.
Services
A service executes processes, and creates files. A service can be started and stopped independently of other services. When a process server is stopped, all services are stopped. When a process server is started, all of its services are also started. Most services are related to definition types; when you assign a definition type to a process server, the required service is automatically assigned to the process server.
In some circumstances, you might want to assign a service but no definition type to a process server, for example, when the process server is only used for file events.
Process servers are part of the Environment section in the navigation bar. The following standard process servers are provided with Redwood Server:
Worker Queues
By default, a process server has 100 worker queues, which means that it can execute 100 concurrent processes (processes running in parallel). You can set the maximum number of worker queues using the registry:
/configuration/requestQueueSize/<process_server_partition>/<process_server>/<service>
You set the maximum workers for the ScriptService (RedwoodScript) to 20, for the ProcessServer named 'PS_TEST' which is in the GLOBAL partition as follows:
/configuration/requestQueueSize/GLOBAL/PS_TEST/ScriptService=20
Forced Process Server
You force a process to run on a specific process server by using the <job>.setForcedProcessServer(<process_server>) RedwoodScript method. This is used in pre-running actions and triggers, for example, to force a chain process to run on the same host as another chain process in a Chain. You can recognize chain processes that have been forced to run on a given process server in the processes monitor by the Forced Process Server property which is set to the name of the process server.
Context-Menu
Process servers support the following context-menu actions:
| Action | Description |
|---|---|
| Start | Start the process server |
| Stop | Stop the process server |
| Edit Security | Edit the security of the process server |
| Duplicate | Make a copy of the process server to create a similar one |
| Delete | Delete the process server |
| Monitor related Chains | Opens the monitor with a filter displaying chains related to the current process server |
| Get Support Files | Allows you to retrieve files for troubleshooting purposes; such as process server logs, chain logs, operator messages |
| Export > Export | Export the process server into a CAR file |
| Export > Export with related objects | Export the process server into a CAR file including referenced objects |
| Promote > Promote to system | Promote the object to a remote system |
| Promote > Edit further then promote | Edit the export rule set prior to promoting |
| Promote | Promote the process server to another Redwood Server instance |
| Edit | Edit the process server |
| Show permalinks | Show links that can be used from third party applications to link to the object |
| Add to navigation bar | Add the current object to the navigation bar |
| Expand All | Expand all process servers in the current filter |
| New | Create a new process server |
| Show Diagram | Displays the Process Server diagram in a new tab |
| Filter > New Filter | Create a new process server filter |
| Filter > Edit Filter | Edit current process server filter |
| Filter > Delete | Delete current process server filter |
| Filter > Duplicate Filter | Create a copy of the filter |
| Filter > Export Filter | Export the filter into a CAR file |
| Filter > Add to navigation bar | Add the filter to a navigation bar |
| Filter > Create filter from search | Create a filter from the current IntelliSearch query |
It is not possible to delete a process server when it is in status Running. You must first stop the process server.
Process server parameters have two values, a Current value that is being used by the process server right now and a Desired value, which is the one that will be used after a restart of the process server. These will be different if you edit the parameters on a running process server but do not restart it. The Desired value reflects this change and makes it clear that a change has been made, but is not yet being used. Before you restart a process server in a production environment, it is recommended to check the Desired values of the parameters.
Errors and Operator Messages
Process servers raise operator messages in the central 'Operator Messages' system when they encounter warnings and errors. You should check the operator message log if a process server appears not to be behaving correctly, after changing a process server (or the related SAP System), or if a process server does not start.
Deleting Process Servers
You can only delete process servers when no other objects relate to them. For example, if there are still chains that ran on the process server, then it cannot be deleted until all chains have been deleted. You can see all chains that relate to the process server in the Related Objects in the lower detail pane and on the show page.
Finding Process Servers
You can search for process servers using filters and the Search Process Servers box on the Process Servers tab. This box is known as the IntelliSearch box and located under your username on the top right-hand side of the user interface. Filters allow you to specify a list of objects with static criteria. IntelliSearch 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 process servers with the term process server in the comment, you would use the search criteria as follows:
c:process server
You can search more than one property, as follows:
c:process server n:JV
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 process servers:
| Prefixes | Description |
|---|---|
| n, name | searches the name property |
| c, comment | searches the documentation property |
| d, description | searches the description property |
| a, application | searches the application property |
| psId | search for process server by UniqueId |
| cb, changedbefore | (internal) search for process servers that changed before a certain ISO-8601 period |
Security
| Privilege | Description |
|---|---|
| ProcessServer.Create | Create process servers |
| ProcessServer.Delete | Delete process servers |
| ProcessServer.Edit | Edit process servers |
| ProcessServer.View | Access process servers |
| ProcessServer.ViewJobs | View the processes in the process server |
| ProcessServer.Control | open and close the process server |
| ProcessServer.UseForFileEvents | Use the process server for file event processes |
| ProcessServer.SubmitOnto | Submit processes onto the process server |
You can grant privileges on two levels, Access and Admin; a privilege granted on Admin level allows the grantee to grant the privilege to other users. These privileges can be granted per partition or system-wide.
The Security tab allows you to specify which users can access, edit, and delete the process server.
Overriding Process Server Default Values
You can override process server parameter default values globally by setting the following registry entry:
/configuration/ProcessServerParameters/<name>
The <name> is the name of the process server parameter. Note that this registry entry only affects default values; if you add the process server parameter to the process server, then that value will have precedence over the value of this registry entry.
Only the scheduler-isolation-administrator can create/edit these registry entries.
Procedure
- Choose "Environment > Process Servers".
- Choose New Process Server.
- Select the appropriate type.
- Fill in the details, refer to the Values section below.
- Choose Save and Close.
Values
More information about the various tabs of the process server editor is available in the Values for Creating a Process Server section of the documentation.
Example
- Choose "Environment > Process Servers".
- Choose New Process Server, select Manual Setup, and fill the data below into the corresponding fields on the tabs.
- Choose Save & Close to save the new process server and close the edit window.
ProcessServer Tab
Name: Main_SystemServer
Default Time Zone: Europe/Berlin
Application: [none]
Description: Process server for the main system.
Documentation Tab
Documentation: Process server for the main system.
Parameters Tab
Name: RootDirectory
Value: /opt/redwood/data
Services Tab
Service: JobChainService
Desired Status: Running
Service: SystemService
Desired Status: Running
Providers Tab
Queue: System
Held: unchecked
Execution size:
Inclusive: unchecked
Hold level:
Hold Above CPU Load:
Hold Above Page Rate:
Time Window: [none]
Resources Tab
None
Definition Types Tab
JOBCHAIN
SYSTEM
See Also
- Using the Wizard to Create Process Servers
- Process Server Parameters
- Process Server Services
- Privileges Required to use Process Servers
- Configuring a Process Server
- Process Server Parameters
- Controlling Process Servers with RedwoodScript
ProcessServer