RapidMiner Server Settings and Services

Use[GET] $RMServerHost/api/rest/system-settingsas endpoint URL andapplication/jsonas content type.

An example response might look like the following and return status code200:

[ { "name": "com.rapidanalytics.version.configured", "value": "9.5.000" }, { "name": "exampleProperty", "value": "exampleValue" } ]

Use[POST] $RMServerHost/api/rest/system-settingsas endpoint URL andapplication/jsonas content type. If the request has been handled successfully, a204will be returned.

The request payload should look like the following:

{ "name": "exampleProperty", "value": "exampleValue" }

To change a property via REST endpoint, invoke the same endpoint like for adding a property. If the property with already exists, its value will be overwritten.

Use[DELETE] $RMServerHost/api/rest/system-settings/$nameOfPropertyas endpoint URL. If the request has been handled successfully, a204will be returned.

To change the hostname settings, follow these steps:

1. Edit the fileconfiguration/standalone.xmlin yourRapidMiner Server home directory。

2. Locate the tags configuring the interface:

3. Edit the bind address (the IP address after the colon, 127.0.0.1 in the above example) as required. You can enter a hostname instead of an IP address if desired.

4. Save the file and restart RapidMiner Server.

To change the port settings, follow these steps:

1. Edit the fileconfiguration/standalone.xmlin yourRapidMiner Server home directory。

2. Locate the tags configuring the socket bindings (these define the HTTP and HTTPS ports):

3. Edit the port numbers as required.

4. Save the file and restart RapidMiner Server.

Note: On Linux, you must be running as root to change port numbers below 1024 (this includes the standard HTTP(S) ports 80 and 443).

If you use single sign on in RapidMiner Server, you must change the HTTP header size. This is because the Kerberos token string is usually quite long, exceeding the default header size.

To change the header size:

1. Edit the fileconfiguration/standalone.xmlin yourRapidMiner Server home directory。

2. Locate the extensions tag definitions (they are most likely at the beginning of the file):

    . . . 

3. Immediatelyafterthe extensions tag (do not modify the extensions tag),addthe following system-properties tag, wherevaluedefines the maximum URL length:

4. Save the file and restart RapidMiner Server.

If you did not configure the SMTP server during installation or need to change the outgoing email address, you can do it by editing thestandalone.xmlconfiguration file.

1. Edit the fileconfiguration/standalone.xmlin yourRapidMiner Server home directory。

2. Locate the mail subsystem element, for example:

3. Modify thefrom,username, andpasswordfields as required. Be certain that thefromfield is not blank (otherwise sending emails will not work). Thefromandusernamefields should not be the same, unless required to be by your email provider. Thefromvalue cannot be an arbitrary address, it must be a registered alias thatusernamecan send as.

4. Locate the outbound socket element for example:

   < outbound-socket-binding name = " mail-smtp " > <远程-destination host="localhost" port="25"/> 

5. Modify the host and port fields as required.

6. Save the file and restart RapidMiner Server.

To verify the settings:

1. Log in to RapidMiner Server as administrator.

2. Go toAdministration > System Settings。Click on theEmail Configurationtab.

3. Enter an email address and click theSend test mailbutton. If the email address you entered does not soon receive an email (and you checked any junk and trash folders), consult thelog files。

   

   Note: In theEmail Configurationtab you may see the message “The property com.rapidanalytics.mail.jndi_name is undefined. Assuming JNDI name ‘java:/Mail’. No mail session is configured under this JDNI name.”

   JNDI is the Java Naming and Directory Interface, used, for example, if RapidMiner Server runs on a JBoss shared with other applications. Typically this message can be ignored. If you changed the JNDI name in thestandalone.xmlconfiguration file, you canconfigure the system settings你的RapidMiner服务器and set thecom.rapidanalytics.mail.jndi_nameproperty to the new JNDI name.

RapidMiner Server version 2.5 improves repository performance when storing large example sets. To include this improvement when performing an EAR upgrade:

1. Edit the fileconfiguration/standalone.xmlin yourRapidMiner Server home directory。

2. Locate the datasource subsystem element, for example:

    jdbc:mysql://localhost:3306/rapidminer_server mysql-connector-java-5.1.31.jar . . . 

3. Add the following line to theelement:

   true

4. Save the file and restart RapidMiner Server.

1. In the RapidMiner Server installation directory, openbin/standalone.conf.bat。

2. Change the JAVA_HOME location by changing the following line, whereJRE7is the updated Java folder:

   set "JAVA_HOME=C:\Program Files\Java\

3. Save the file and restart RapidMiner Server.

1. In the RapidMiner Server installation directory, openbin/standalone.conf。

2. Change the JAVA_HOME location by changing the following line, whereJRE7is the updated Java folder:

   JAVA_HOME="/opt/java/"

3. Save the file and restart RapidMiner Server.

1. Starting from yourRapidMiner Server home directory, navigate and open the fileconfiguration/max-memory.conf。

2. The file should contain a number followed by the letterM。This sequence signifies the maximum amount of memory in MB that Rapidminer Server may use. For example the value8192Mmeans that RapidMiner Server may allocate up to 8,192 MB of RAM.

3. To modify this setting simply replace the number with the desired amount of memory in MB, that RapidMiner Server may use.

4. Save the file and restart RapidMiner Server.