1. Documentation
2. 10.1 (Latest)10.09.109.99.89.79.69.59.49.39.29.19.08.28.18.07.6
3. Deployment
4. Admin tools
5. Platform Admin

Platform Admin

Introduction

Platform Admin provides an easy to use interface for common platform administration tasks in two distinct areas:

• Manage centrally defined coding environments
• Manage Real-Time Scoring Deployments

This page provides an overview of these functions and their limitations. The Platform Admin is available as part of the RapidMiner Platform deployment. See thedeployment overviewon where it fits in, and check one of thedeployment templatesto get started with it.

Logging in to Platform Admin

Platform Admin is accessible via the RapidMiner Platform landing page, or by navigating tohttps://your-platform-deployment/platform-admin/.

You need the right roles configured for your user to access Platform Admin and its features. Users with theplatform-adminrole will have access to all features of Platform Admin. If needed, you can restrict access by assigning any of the defined fine-grained roles based on the table below:

Role Name	Description
pem-viewer	Can view defined coding environments and their contents
pem-admin	Can view, create, archive and delete coding environments
rts-viewer	Can view and test deployments
rts-deployment-admin	Can view, test, create and delete deployments
rts-admin	Can install licenses and manage scoring access control

For more information on configuring roles, go to therelevant page of Manage deployments.

Managing coding environments

The RapidMiner Platform deployment supports coder data scientists in their daily productivity. As part of that, we ship ourPython Scripting ExtensionandR Scripting Extensionpre-configured for process and web service execution.

We also ship a default Anaconda environment that contains the most commonly used coding packages in data science projects, however it is a common use-case that projects need their specific set of Python or R packages. As the RapidMiner Platform'sscalable execution backendis a distributed engine, it is required to ensure the same environments are defined on all parts of the execution backend.

The goal of the Platform Admin is to ease the administration of these coding environments. Its key benefits are:

• reduced administrative overhead
• reduced risk of administrative errors
• ensured correct operation of deployed RapidMiner processes and web services containing Python or R code

Platform Admin ensures that the same coding environment is provisioned and ready for use in all these components:

• Job Agents, for batch and scheduled job execution
• RapidMiner Server, for web service execution
• RapidMiner Notebooks, for fast prototyping in a notebook environment

Limitations

Please be mindful of the following limitations when managing coding environments:

• Coding environment management for Real-Time Scoring Agent is not supported.
• When importing an environment definition file that was exported from another machine, only Linux (and WSL in Windows) is supported as a source. Environments exported from macOS or Windows based systems will not work. This is a limitation of the underlying Anaconda package manager.
• The environment namedbaseandpa-syncare reserved for special purposes and cannot be used. Platform Admin will prevent the upload of such environments.

Creating a new coding environment

The Platform Admin interacts with an Anaconda installation present on the deployed Job Agents. It accepts environment definition YAML files which are used by Anaconda. Follow these steps to create a new environment:

1. First, create a definition file on your computer. You can use any of the following methods:
   • Preferred way: download the preinstalled coding environment definition from Platform Admin to your computer and edit it (be sure to change the name). Seeinstructions below.

     

   • Export the environment from your own machine using theconda env exportcommand. Make sure to check thelimitationsfirst.
   • Open your favorite text editor and create the definition file manually.
2. In the Platform Admin UI,browseand find the YAML file you just created, and clickSubmit.
3. Be patient for a few minutes until the settings are applied on all Job Agents.
4. You can check the status of the deployment if you refresh the page.

Updating an existing coding environment

Updates are very similar to creating new environments. The only difference is that you need to specify an environment with an existing name. Follow theinstructions aboveto create and upload your modified environment definition file.

Setting the default environment

Python code running in anExecute Pythonoperator inside a RapidMiner process will use the default environment on the machine it's executed on, unless explicitly specified in the operator parameters.

You can select the default environment forallsuch executions by clicking theSet Defaultbutton next to your coding environment.

Checking status and logs

You can track the status of an environment deployment by clicking onView Logsnext to your environment. It will open a new page where you can see thestdoutandstderroutputs for thecondacommands executed on all connected Job Agents.

Downloading a Python environment definition file

You can download an existing environment definition file by clickingView YMLnext to your environment.

Archiving an existing coding environment

If you no longer need an environment, you can archive it by clicking on theArchivebutton next to your environment. This will remove the environment from all connected clients, and move it to the list of archived environments in the Platform Admin. This might come in handy if you later need to reuse it or create a new one with slight modifications.

Managing archived environments

If you no longer need an archived environment for your records, you can completely erase it by clicking on theRemovebutton next to the archived environment.

You can also erase all archived environments, by clicking onRemove all archived environments.

Managing Real-Time Scoring Deployments

Platform Admin also provides an easy way to manage Real-Time Scoring Deployments.

It can manage only a single Real-Time Scoring Agent deployed on the same machine (virtual or physical). See thedeployment overviewon where it fits in.

Configuring scoring access control

To ensure we meet low latency requirements for Real-Time Scoring, we kept the scoring access control simple.

To manage access to the scoring service, navigate toScoring Access ControlunderReal-Time Scoring.

Adding a new user

1. Type the username of the new user into theUsernamefield
2. Type the new password in thePasswordfield
3. Click on theAdd Userbutton

Passwords can be changed by introducing the old name and new password into theUsernameandPasswordfields and clicking onAdd User. If you change the password of the logged-in user, it will be immediately logged out and asked to log in again.

Adding a new license

如果你刚刚部署实时得分gent, you'll need to upload the license you obtained from RapidMiner. The license is a long string of characters.

To upload it, use theLicensemenu item underReal-Time Scoring. Click onAdd new licenseand paste your license in the available space. Click submit. After that, it will take a minute or two before the system is ready to go. You can check the status in theStatusmenu item.

Managing deployments

TheDeploymentmenu item underReal-Time Scoringallows reviewing, adding and removing deployment packages from the Real-Time Scoring Agent.

It provides a list of the currently active deployment packages.

For each deployment, you can see the name, and the list of REST endpoints it contains. To the right of each endpoint, there is acopybutton that provides the full URL to call that particular endpoint.

To add a new deployment:

First, if you're not yet familiar with it, learnhow to create a deployment packagein RapidMiner Server.

To add a new deployment, follow these steps:

1. Click theChoose Filebutton
2. 浏览文件系统stem and select the deployment's zip file
3. ClickSubmit

To remove a deployment:

To remove a deployment, click on the correspondingXto the right of the deployment's name.