Skip to content
Snippets Groups Projects
  • Charles Yeh's avatar
    9e48cdfb
    [SPARK-11218][CORE] show help messages for start-slave and start-master · 9e48cdfb
    Charles Yeh authored
    Addressing https://issues.apache.org/jira/browse/SPARK-11218, mostly copied start-thriftserver.sh.
    ```
    charlesyeh-mbp:spark charlesyeh$ ./sbin/start-master.sh --help
    Usage: Master [options]
    
    Options:
      -i HOST, --ip HOST     Hostname to listen on (deprecated, please use --host or -h)
      -h HOST, --host HOST   Hostname to listen on
      -p PORT, --port PORT   Port to listen on (default: 7077)
      --webui-port PORT      Port for web UI (default: 8080)
      --properties-file FILE Path to a custom Spark properties file.
                             Default is conf/spark-defaults.conf.
    ```
    ```
    charlesyeh-mbp:spark charlesyeh$ ./sbin/start-slave.sh
    Usage: Worker [options] <master>
    
    Master must be a URL of the form spark://hostname:port
    
    Options:
      -c CORES, --cores CORES  Number of cores to use
      -m MEM, --memory MEM     Amount of memory to use (e.g. 1000M, 2G)
      -d DIR, --work-dir DIR   Directory to run apps in (default: SPARK_HOME/work)
      -i HOST, --ip IP         Hostname to listen on (deprecated, please use --host or -h)
      -h HOST, --host HOST     Hostname to listen on
      -p PORT, --port PORT     Port to listen on (default: random)
      --webui-port PORT        Port for web UI (default: 8081)
      --properties-file FILE   Path to a custom Spark properties file.
                               Default is conf/spark-defaults.conf.
    ```
    
    Author: Charles Yeh <charlesyeh@dropbox.com>
    
    Closes #9432 from CharlesYeh/helpmsg.
    9e48cdfb
    History
    [SPARK-11218][CORE] show help messages for start-slave and start-master
    Charles Yeh authored
    Addressing https://issues.apache.org/jira/browse/SPARK-11218, mostly copied start-thriftserver.sh.
    ```
    charlesyeh-mbp:spark charlesyeh$ ./sbin/start-master.sh --help
    Usage: Master [options]
    
    Options:
      -i HOST, --ip HOST     Hostname to listen on (deprecated, please use --host or -h)
      -h HOST, --host HOST   Hostname to listen on
      -p PORT, --port PORT   Port to listen on (default: 7077)
      --webui-port PORT      Port for web UI (default: 8080)
      --properties-file FILE Path to a custom Spark properties file.
                             Default is conf/spark-defaults.conf.
    ```
    ```
    charlesyeh-mbp:spark charlesyeh$ ./sbin/start-slave.sh
    Usage: Worker [options] <master>
    
    Master must be a URL of the form spark://hostname:port
    
    Options:
      -c CORES, --cores CORES  Number of cores to use
      -m MEM, --memory MEM     Amount of memory to use (e.g. 1000M, 2G)
      -d DIR, --work-dir DIR   Directory to run apps in (default: SPARK_HOME/work)
      -i HOST, --ip IP         Hostname to listen on (deprecated, please use --host or -h)
      -h HOST, --host HOST     Hostname to listen on
      -p PORT, --port PORT     Port to listen on (default: random)
      --webui-port PORT        Port for web UI (default: 8081)
      --properties-file FILE   Path to a custom Spark properties file.
                               Default is conf/spark-defaults.conf.
    ```
    
    Author: Charles Yeh <charlesyeh@dropbox.com>
    
    Closes #9432 from CharlesYeh/helpmsg.
start-slave.sh 3.08 KiB
#!/usr/bin/env bash

#
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements.  See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License.  You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#

# Starts a slave on the machine this script is executed on.
#
# Environment Variables
#
#   SPARK_WORKER_INSTANCES  The number of worker instances to run on this
#                           slave.  Default is 1.
#   SPARK_WORKER_PORT       The base port number for the first worker. If set,
#                           subsequent workers will increment this number.  If
#                           unset, Spark will find a valid port number, but
#                           with no guarantee of a predictable pattern.
#   SPARK_WORKER_WEBUI_PORT The base port for the web interface of the first
#                           worker.  Subsequent workers will increment this
#                           number.  Default is 8081.

if [ -z "${SPARK_HOME}" ]; then
  export SPARK_HOME="$(cd "`dirname "$0"`"/..; pwd)"
fi

# NOTE: This exact class name is matched downstream by SparkSubmit.
# Any changes need to be reflected there.
CLASS="org.apache.spark.deploy.worker.Worker"

if [[ $# -lt 1 ]] || [[ "$@" = *--help ]] || [[ "$@" = *-h ]]; then
  echo "Usage: ./sbin/start-slave.sh [options] <master>"
  pattern="Usage:"
  pattern+="\|Using Spark's default log4j profile:"
  pattern+="\|Registered signal handlers for"

  "${SPARK_HOME}"/bin/spark-class $CLASS --help 2>&1 | grep -v "$pattern" 1>&2
  exit 1
fi

. "${SPARK_HOME}/sbin/spark-config.sh"

. "${SPARK_HOME}/bin/load-spark-env.sh"

# First argument should be the master; we need to store it aside because we may
# need to insert arguments between it and the other arguments
MASTER=$1
shift

# Determine desired worker port
if [ "$SPARK_WORKER_WEBUI_PORT" = "" ]; then
  SPARK_WORKER_WEBUI_PORT=8081
fi

# Start up the appropriate number of workers on this machine.
# quick local function to start a worker
function start_instance {
  WORKER_NUM=$1
  shift

  if [ "$SPARK_WORKER_PORT" = "" ]; then
    PORT_FLAG=
    PORT_NUM=
  else
    PORT_FLAG="--port"
    PORT_NUM=$(( $SPARK_WORKER_PORT + $WORKER_NUM - 1 ))
  fi
  WEBUI_PORT=$(( $SPARK_WORKER_WEBUI_PORT + $WORKER_NUM - 1 ))

  "${SPARK_HOME}/sbin"/spark-daemon.sh start $CLASS $WORKER_NUM \
     --webui-port "$WEBUI_PORT" $PORT_FLAG $PORT_NUM $MASTER "$@"
}

if [ "$SPARK_WORKER_INSTANCES" = "" ]; then
  start_instance 1 "$@"
else
  for ((i=0; i<$SPARK_WORKER_INSTANCES; i++)); do
    start_instance $(( 1 + $i )) "$@"
  done
fi