Managing R Boundaries
R boundaries are used to constrain runtime resource usage related to:
- Authenticated operations running on projects
- Asynchronous operations running as background jobs
- Anonymous operations running on stateless projects
R boundaries help manage the optimal allocation of resources across all operations. They also protect the system from poorly written or malicious code that may attempt to consume all system resources in an infinite loop or other threats.
In this Administration Console, you can access and work with R boundaries by clicking R Boundaries in the main menu.
Once you create an R boundary, you can assign it to any grid node or user account in the console. Grid node boundaries take precedence over boundaries associated with individual users.
You can also designate a particular R boundary as the default system-wide R boundary to be used whenever no other boundary is indicated.
If you plan to associate R boundaries with grid nodes, we recommend that you create a custom R boundary for each node operation type (authenticated, asynchronous, and anonymous operations) supported on the grid.
Figure: Boundary List page
Creating New Boundaries
To create a new boundary:
From the main menu, click R Boundaries.
From the R Boundary List page, click the New Boundary link. The New R Boundary page appears.
Figure: New R Boundary page
In the New R Boundary page, define your boundary, including:
Name. Enter a unique name for the boundary. This field is required.
Max CPU (sec). Enter the maximum amount of time in seconds that the CPU can be engaged at runtime. If the time limit is exceeded, then an R error is returned at runtime. If you enter a value of 0, this constraint will be ignored.
Click Create to save the new boundary.
Deleting Boundaries
To delete a boundary:
From the main menu, click R Boundaries.
From the R Boundary List page, click the name of the boundary you want to delete. The R Boundary Details page appears.
Click Delete and confirm the removal of the boundary.
Viewing and Editing Boundaries
To view and edit a boundary:
From the main menu, click R Boundaries.
From the R Boundary List page, click the name of the boundary you want to view or edit in the table. The R Boundary Details page appears.
Figure: R Boundary Details page
To edit a boundary, perform the following steps:
Click Edit.
Make your changes.
Click Update to save the changes.
Exporting Boundaries
You can export all or selected R boundaries into one CSV file. Exporting can be used to copy the boundaries to another machine or to preserve them as a backup. You can later import the contents of this file to this server or across multiple server deployments.
Figure: Export Boundaries page
To export:
From the main menu, click R Boundaries.
From the R Boundary List, click Export Boundaries.
Select the R boundaries you want to export. You can choose to export all of them or individually select the boundaries to be exported.
Click Export to File and save the file.
Importing Boundaries
You can import R boundaries from a CSV file into the server. This CSV file can come from a previous export or might be a file you created manually using the proper format.
Figure: Import Boundaries page
To import:
From the main menu, click R Boundaries.
From the R Boundary List, click Import Boundaries.
Click Browse and select the file to be imported. By default, the file has the CSV file extension.
Click Load.
Choose which R boundaries to import. You can choose to import all of them or individually select the boundaries to import.
Click Import. If a boundary by the same name already exists, then a message appears to inform you that the incoming boundary was rejected.