RapidMiner Server Settings and Services

To change the hostname settings, follow these steps:

1. Edit the file standalone/configuration/standalone.xml in the RapidMiner Server installation directory.

2. Locate the tags configuring the interface:

        <interface name="public">
            <inet-address value="${jboss.bind.address:127.0.0.1}">
        </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 file standalone/configuration/standalone.xml in the RapidMiner Server installation directory.

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

    <socket-binding name="http" port="8080"/>
   
    <socket-binding name="https" port="8443"/>
   

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 file standalone/configuration/standalone.xml in the RapidMiner Server installation directory.

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

    <extensions>
        .
        .
        .
    </extensions>
   

3. Immediately after the extensions tag (do not modify the extensions tag), add the following system-properties tag, where value defines the maximum URL length:

    <system-properties>
           <property name="org.apache.coyote.http11.Http11Protocol.MAX_HEADER_SIZE" value="65535"/>
    </system-properties>
   

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 the standalone.xml configuration file.

1. Edit the file standalone/configuration/standalone.xml in the RapidMiner Server installation directory.

2. Locate the mail subsystem element, for example:

    <subsystem xmlns="urn:jboss:domain:mail:1.0">
        <mail-session jndi-name="java:/Mail" debug="false" from="user@localhost.com">
            <custom-server name="smtp" outbound-socket-binding-ref="mail-smtp">
                <login name="username" password="password"/>
            </custom-server>
            <!-- pop3-server outbound-socket-binding-ref="mail-pop3"/ -->
        </mail-session>
    </subsystem>
   

3. Modify the from, username, and password fields as required. Be certain that the from field is not blank (otherwise sending emails will not work). The from and username fields should not be the same, unless required to be by your email provider. The from value cannot be an arbitrary address, it must be a registered alias that username can send as.

4. Locate the outbound socket element for example:

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

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 to Administration > System Settings. Click on the Email Configuration tab.

3. Enter an email address and click the Send test mail button. If the email address you entered does not soon receive an email (and you checked any junk and trash folders), consult the log files.

   

   Note: In the Email Configuration tab 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 the standalone.xml configuration file, you can configure the system settings of your RapidMiner server and set the com.rapidanalytics.mail.jndi_name property 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 file standalone/configuration/standalone.xml in the RapidMiner Server installation directory.

2. Locate the datasource subsystem element, for example:

    <datasource jta="true" jndi-name="java:/jdbc/RapidAnalyticsDS" pool-name="RapidAnalyticsDS" enabled="true" use-java-context="false" use-ccm="true">
   
    <connection-url>jdbc:mysql://localhost:3306/rapidminer_server</connection-url>
   
    <driver>mysql-connector-java-5.1.31.jar</driver>
    .
    .
    .
    </datasource>
   

3. Add the following line to the <datasource></datasource> element:

    <connection-property name="rewriteBatchedStatements">true</connection-property>
   

4. Save the file and restart RapidMiner Server.

1. In the RapidMiner Server installation directory, open bin/standalone.conf.bat.

2. Change the JAVA_HOME location by changing the following line, where JRE7 is the updated Java folder:

   set "JAVA_HOME=C:\Program Files\Java\<jre7>

3. Save the file and restart RapidMiner Server.

1. In the RapidMiner Server installation directory, open bin/standalone.conf.

2. Change the JAVA_HOME location by changing the following line, where JRE7 is the updated Java folder:

   JAVA_HOME="/opt/java/<jre7>"

3. Save the file and restart RapidMiner Server.

1. Starting from the base RapidMiner Server installation directory, navigate and open the file standalone/configuration/max-memory.conf.

2. The file should contain a number followed by the letter M. This sequence signifies the maximum amount of memory in MB that Rapidminer Server may use. For example the value 8192M means 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.

You had an opportunity, at installation, to register RapidMiner Server to run as a Windows service (by checking a box in the installer process). If you did not check Register as a service or you did not have admin privileges when you started the installer, RapidMiner Server is not registered to run as a service. To change the configuration so that RapidMiner Server runs as a service in the future:

1. As administrator, open a Windows command prompt.

2. From the terminal window, change to the bin folder in your RapidMiner Server installation folder.

3. Enter service.bat install at the prompt. This installs RapidMiner Server as a Windows service. (To uninstall the service later, enter service.bat uninstall from the same location.)

4. By default, the service is registered with the key RMS<version>SVC (for example RMS710SVC or RMSSVC in case of older versions than 7.1.0). (This can be modified in the service.bat file.) To start the service from a Windows command prompt, enter the following command with the service name. For example:

    net start RMS710SVC
   

   Similarly, to stop the service, enter:

    net stop RMS710SVC
   

Alternatively, you can use the Windows control panel to set, start, and monitor the service.

You can autostart RapidMiner Server under UNIX, but the method is dependent on your UNIX distribution. The following instructions apply to Ubuntu.

Linux system startup scripts are contained in /etc/init.d/. To start RapidMiner Server when an Ubuntu system boots, follow these steps:

1. Download the file rapidminerserver.sh to your computer and open it in an editor:

    \#!/bin/bash
    \### BEGIN INIT INFO
    \# Provides:          rapidminerserver
    \# Required-Start:    $local_fs $remote_fs $network $syslog
    \# Required-Stop:     $local_fs $remote_fs $network $syslog
    \# Default-Start:     3 4 5
    \# Default-Stop:      0 1 2 6
    \# Short-Description: Start/Stop RapidMiner Server
    \### END INIT INFO
    \# chkconfig: 345 85 15
   
    RAPIDMINER-SERVER_HOME=/opt/rapidminer-server-2
    RAPIDMINER-SERVER_USER=root
   
    case "$1" in
        start)
            echo "Starting RapidMiner Server..."
            start-stop-daemon --start --quiet --background --chuid ${RAPIDMINER-SERVER_USER} --exec ${RAPIDMINER-SERVER_HOME}/bin/standalone.sh
        ;;
        stop)
            echo "Stopping RapidMiner Server..."
            start-stop-daemon --start --quiet --background --chuid ${RAPIDMINER-SERVER_USER} --exec ${RAPIDMINER-SERVER_HOME}/bin/jboss-cli.sh -- --connect --command=:shutdown
        ;;
        *)
            echo "Usage: /etc/init.d/rapidminerserver {start|stop}"; exit 1;
        ;;
    esac
   
    exit 0
   

2. Change the RAPIDMINER-SERVER_USER variable to the Linux user who will run the service. The user you enter must already exist. To create the user, use the useradd command.

3. Change the RAPIDMINER-SERVER_HOME variable to point to your RapidMiner Server installation.

4. Save the script file as /etc/init.d/rapidminerserver.

5. Make the script file executable by calling:

    chmod 755 /etc/init.d/rapidminerserver
   

6. To configure Ubuntu to execute the script at boot time and shutdown, call:

    chkconfig --add rapidminerserver