Categories

Versions

You are viewing the RapidMiner Server documentation for version 9.2 -Check here for latest version

Installing and Starting RapidMiner Server

The following sections describe all the steps required to get RapidMiner Server andJob Agents我nstalled and running using theFull Server Package. If you are familiar with these procedures, you can use theQuick Startas a reference for the installation process instead of these more detailed instructions.

You may want to verify that your system meets thesystem requirementsbefore beginning the installation.

The following sections describe all the necessary steps for getting RapidMiner Server fully operational:

Prerequisites

The following are required to successfully install RapidMiner Server:

Prerequisite Comment
Java 8 (either JDK or JRE) If it is not already present,我nstall Java 8. The installer displays an error message if it finds Java 7 (or a version earlier than 7), but does not block the installation. However, RapidMiner Server requires Java 8 and will otherwise return an error at start up.
A RapidMiner Server database The RapidMiner Server database (schema) stores configuration files, cron job details, user report requests, and other RapidMiner support data. You can use an existing database server or create a new one; it can reside locally or on a remote host. Refer tothese instructionsfor an example of creating a database schema for use by the RapidMiner service, using one of the many supported database platforms.
A RapidMiner Server database user with credentials During installation you will need to supply database access credentials for a user with read, write, and create and delete tables permissions. You can refer tothis exampleof setting permissions using PostgreSQL.
RapidMiner Studio You need a fully functioning RapidMiner Studio client to use RapidMiner Server for any meaningful operations.

Once the prerequisites are met, you canbegin the installation.

Installation instructions

Use the following steps to 1) download 2) configure, and 3) install RapidMiner Server. Once the installation process is complete, if youselected to do so, the settings are saved to a configuration file. You can later modify the file (for example, change hostname or ports) and easily install the RapidMiner Server service on a different machine. (See the section onheadless installationfor more information on this option.)

Downloading RapidMiner Server

Follow these steps to download the full RapidMiner Server package:

  1. Log into yourRapidMiner accountand click theDownloads我con or tab:

  2. From theDownloadspage, select the appropriate type of installation for your environment.

  3. Unlike RapidMiner Studio, you do not need to pick an operating system platform for the Server edition. ClickDownloadand accept the EULA to download the zip filerapidminer-server-installer-x.x.x.zip, which contains the RapidMiner Server package.

  4. Extract the contents of the download file to an installation directory.

Installing RapidMiner Server

The following steps describeServer我nstallation. The installation script requires Java 8; if it is not available (not on the path or JAVA_HOME is not set), the installer will not run correctly. If it does not run, check your Java installation.

Note for Windows Users: It is helpful to run the installation asAdmin. This allows the installer to register the service. Additionally, a standard user is not allowed to write to all folders on the system (for example,C:\Program Files). If you do not want to register RapidMiner Server as a service and plan to install to a folder you have write access to, admin privileges are not required.

  1. Change to thebindirectory (within the installation directory) to locate the start script (or batch file) for the installation.

    • For Windows, use the filerapidminer-server-installer.bat
    • For Linux, Unix, or Mac OS, use the filerapidminer-server-installer
  2. AsAdmin, run the appropriate installer script. TheRapidMiner Server Installerwindow opens. This is not the RapidMiner service; it is a tool to help you preconfigure the service.

  3. In theRapidMiner Server Installerwindow, read theBefore You Starttext and clickNext IconNextwhen you are ready.

  4. In the next window, select the modeFresh installation of RapidMiner Server. You can install either locally or you can create a configuration file used for aheadless installation. If you select a headless installation, browse to a file location for storing the resulting XML file. ClickNext IconNext.

  5. Scroll to the bottom of the EULA screen, check the box to accept, and clickNext IconNext.

  6. Enter or browse to the location where RapidMiner Server should be installed. Please ensure that the folder path does not contain+or%characters and the file system supports UTF-8.

  7. Enter or browse to the location where theRapidMiner Server home directoryshould be located. The home directory is a central place for stored repository content, extensions, logs and configuration files. Please ensure that the folder path does not contain+or%characters and the file system supports UTF-8. ClickNext IconNext. The RapidMiner Server InstallerLicensewindow opens.

  8. From your account portalLicensespage, copy the license key to your clipboard. (See thisadditional information我f you need help copying your key.)

  9. Paste the key into theLicensewindow. The license registration information updates based on the details of the entered license. ClickNext IconNext.

To copy the license key to your clipboard:

  • Log in to your account portal and go to theLicenses page.

    When the page opens, make sure theServertab is selected. Your license information, including license type and expiration, displays:

  • ClickView License Keynext to the appropriate license to display the key.
  • Click in the box containing the key to select it, then copy it to your clipboard.

TheServer Settingswindow opens.

Configuring RapidMiner Server settings

On this screen, you set the connection settings for RapidMiner Server.

In theRapidMiner Server Settingswindow, enter the server settings:

Field Value
Hostname 输入the hostname or IP address for the local machine hosting the RapidMiner Server service.
Bind to this hostname only Check this box to prevent the server from binding to all available local interfaces. You may want to check this, for example, if the server has more than one IP address and you want to limit the RapidMiner service to run on only one.

Default: false
Port for Web Interface 输入the port used over which clients, typically RapidMiner Studio, will connect.

Default: 8080
Internal Port 输入the port used for internal communication between RapidMiner Server components.

Default: 5672
Server Memory (in MB) 输入the amount of memory you want allocated to RapidMiner Server, excluding the memory allocated to Job Containers. This amount may be limited based on yourlicense limits.
Number of bundled Job Containers Job Containers are responsible for running your processes. If this number ishigher than 0then Server will start adefault Job Agentfor local process execution.

Default: 1
Memory per Job Container (in MB) 输入the amount of memory you want allocated to each Job Container. This amount may be limited based on yourlicense limits.
Register as a service (Windows only) Select this option to register RapidMiner Server to run as Windows service. You must haveAdminprivileges for this setting to take effect. (Under UNIX you canautostart RapidMiner Server, but the method is dependent on your UNIX distribution.)
Service ID Enter an identifier for the version of RapidMiner Server; this is the ID by which Windows refers to the service. The default value is composed of the RapidMiner Server release and version number.
Service Name 输入the name to display in the services list.
JAVA_HOME folder Verify that the path to the Java directory, which was automatically completed based on the setting of JAVA_HOME, is correct. If it is not filled in or is not correct, browse to the directory containing your Java 7 or 8 installation. Be certain that if you have multiple Java versions, you select the folder that contains Java 7 or 8.

ClickNext IconNextto open theDatabase Configurationwindow.

Configuring RapidMiner Server's database connection

On this screen you configure and test RapidMiner Server's database connection.

Note:If your database system is not one of the available choices (MySQL, MSSQL, Oracle, PostgreSQL), see the RapidMiner Supportknowledgebase articlefor information on modifying your configuration file.

Enter your database settings:

Field Value
Database Host 输入the hostname or IP address for the local machine hosting the RapidMiner Server installation. For the local machine, enterlocalhostor 127.0.0.1.
Database port 输入the port number used to access the RapidMiner Server database.
Database schema 输入the name of your existing database or the name of thedatabase you created.
数据库用户名 输入the name of the user with login privileges to the RapidMiner Server database.
Database password 输入the password for the user with login privileges to the RapidMiner Server database.
Database System From the drop-down list, select the database system to be used for the RapidMiner Server database.
JDBC Driver location Specify the appropriate JDBC connector, a JAR file that contains the driver class information for the system to connect to a database from Java. If you want to use a driver different from those included, set the path for the new driver package file in this field.
JDBC Driver class Select the corresponding driver class from the dropdown menu.

ClickTest Connection IconTest Connectionto verify connectivity. If you receive a message that your database connection was successful, clickNext IconNext配置电子邮件设置。如果你收到一个犯错or, double-check your username and password entries.

Configuring email settings

Optionally, you can complete the fields of theE-Mail Serverwindow to register an email account. RapidMiner Server uses this address to send email notifications based on triggers, process results, and password resets.

If you do not plan to use this functionality, leave the fields blank and clickNext IconNext.

Note:Be certain to either complete all fields or leave all fields blank; partial email configuration prevents RapidMiner Server from starting.

If you do plan to configure an email server, enter your email server settings:

Field Value
SMTP Host 输入the name of the host server that sends email. The mail client connects to this server to send outgoing mail (for example,smtp.gmail.comorsmtp.mail.yahoo.com).
SMTP port 输入the port used to connect to the SMTP host. The default SMTP is 25 for unencrypted mail; for encrypted transfer, the default ports are 465 (SSL/TLS) or 587 (StartTLS).
Default Sender Enter an email address. This is the address that appears in the "From" field of the outgoing email.
SMTP username 输入the username given access to the mail server (for example, admin).
SMTP password 输入the password used to authenticate the named user.
Connection security Enable TLS or StartTLS, optional restricted to TLS 1.2 with the following cipher suites: TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
Authentication mechanism Choose how to authenticate to the SMTP server.

Complete the fields, Test the connection and clickNext IconNext.

Installing Radoop Proxy

This install step is relevant only if you haveRapidMiner Radoopextension installed on any RapidMiner Studio instance. You can installRadoop Proxyalong with RapidMiner Server, which is responsible for establishing tunnelled, secure connection to your Hadoop cluster. This is especially useful when you have a RapidMiner Server installed inside the same secure zone as your Hadoop cluster, letting the zone have less ports opened.

If you plan to use this functionality later on, checkEnable Radoop Proxy, and provide a validPortnumber. Please note that Radoop Proxy requires both this port and the subsequent port (for testing) to be available. If you wish to enable Radoop Proxy manually, or deploy it onto another machine, seethis page.

Starting the installation

ClickCheck IconInstallto begin the installation.

Note: If you do not have the correct administrative privileges, you receive a message telling you that theservicewas not registered to Windows services. If you receive the following message, however, the RapidMiner Server installation was successful:

Starting RapidMiner Server

After reading the information on theSuccessscreen, clickInstall IconOKto complete the installation. Start RapidMiner Server in one of the following ways:

Method Description
Start the RapidMiner Server manually In thebindirectory of your RapidMiner Server installation directory (for example,C:\RapidMinerServer\bin), find and execute thestandalone.sh(Unix) orstandalone.bat(Windows) file.
Start the RapidMiner Server service from the command line (Windows only) Enternet start at the command line to start the service.
Start the RapidMiner Server service through the Windows tool (Windows only) Browse to theServicesdirectory on your machine (or searchServicesfrom theStartmenu) and locate the RapidMiner Server service. Right-click the service name and select to either start the service immediately or, through thePropertiesoption, to automatically start the service at system start-up.

Read more:Run RapidMiner Server as a service(Windows or Linux)

When you start RapidMiner Server using the standalone script, the command window displays progress as the program populates the database with all its required tables. If this is the first start-up, the process may take several minutes.

Note:You can ignore the final message that the administration console service was not able to start.

When you start via the Windows service, you do not see the progress, just the finalStartedmessage in your Services window.

Once you have started the server, either via the services option or the standalone script, log in to the web interface. Open a web browser pointed at thehttp://:(for example,http://localhost:8080). The login credentials for first time use are:

  • User:admin
  • Password:changeit

Important:Please be certain tochange your password我mmediately.

Completing the installation

Once logged in, complete the final installation steps.

  1. From theSQL Dialectpull-down, verify that the database type displayed is the one you used to create the RapidMiner Server database.

  2. Verify the setting for the integrated Quartz scheduler, which is enabled by default.

  3. Specify the path to the plugin directory. You can install additional RapidMiner extensions by placing them in, or saving them to, this directory. Note that all extensions bundled with RapidMiner Studio are also bundled with RapidMiner Server (no installation is necessary). These bundled extensions are stored in a separate directory that is independent of the path specified here. Be sure that you have write permission to the directory.

  4. Specify the path to the uploads directory. This is the directory where RapidMiner Server stores temporary files needed for processes. The installation process creates a local uploads directory in the installation folder. However, if you install RapidMiner Server on a relatively small hard disk and, for example, use many file objects in processes or if you have large resulting files, consider creating a directory elsewhere in the cluster to store the temporary files. Be sure that you have write permission to the directory.

  5. ClickStart installation now. When the installation completes, the RapidMiner Server Home page appears:

Changing the administrator password

Your first action, once installation is complete, is to change the administrator password. It is important to change the password at this point because connecting to RapidMiner Studio requires that you enter RapidMiner Server login credentials. Changing your credentials later means that you will have to correct this connection as well. To change the password:

  1. Expand theAdministrationmenu on the left side of the window.

  2. SelectPreferences. The Preferences settings for useradmindisplay.

    完整的字段如下:

    Field Description
    Display name 在安装中,字段默认值admin. Leave it, or change it to any name you want displayed for the administrator. The display name appears in parentheses in the window title.
    Email address 输入the email address associated with the admin account.
    Password Enter a new password for the administrator account. The password must be at least 8 alphanumeric characters.
    Repeat password Re-enter the new password to confirm.
  3. ClickSubmit. The new display name appears, as well as a confirmation of password change.

Congratulations, your RapidMiner Server installation is complete. Next up, connecting to RapidMiner Studio.

Connecting RapidMiner Server to RapidMiner Studio

Once you have finished installing RapidMiner Server, you associate it as a repository for RapidMiner Studio. In RapidMiner Studio you will design and test processes; in RapidMiner Server you can deploy the process on a larger scale.

To create the association, first open RapidMiner Studio:

  1. In RapidMiner Studio, from theRepositoriestab, click theCreate Repository IconCreate repositorymenu:

  2. From theNew Repositorywindow, selectNew RapidMiner Server Repository. ClickInstall IconNext.

  3. From the resulting window, specify the parameters for the repository connection.

    Complete the parameter fields:

    Field Value
    Alias 输入the name to display in theRepositorylist in RapidMiner Studio.
    Repository URL 输入the RapidMiner Server URL (The one which you have already used in your browser to connect to the server).
    User Enter a valid username for a user with access to RapidMiner Server. On installation, useradmin我s accepted.
    Password 输入the password associated with the user. On installation, passwordchangeit我s accepted.
  4. ClickTest Connection IconTest Connectionto verify the credentials and test the connection to RapidMiner Server.

  5. ClickInstall IconFinishto add RapidMiner Server as a repository.

That's it! Get predictions at lightning speed, integrate your in-house data sources, and collaborate with coworkers and contributors throughout your organization and beyond. Welcome to RapidMiner Server. Have fun!