hadoop_add_classpath

• Synopsis

hadoop_add_classpath object [before|after]

• Description

Add a file system object (directory, file, wildcard, …) to the classpath. Optionally provide a hint as to where in the classpath it should go.

• Returns

0 = success (added or duplicate)

1 = failure (doesn’t exist or some other reason)

hadoop_add_colonpath

• Synopsis

hadoop_add_colonpath envvar object [before|after]

• Description

Add a file system object (directory, file, wildcard, …) to the colonpath. Optionally provide a hint as to where in the colonpath it should go. Prior to adding, objects are checked for duplication and check for existence. Many other functions use this function as their base implementation including hadoop_add_javalibpath and hadoop_add_ldlibpath.

• Returns

0 = success (added or duplicate)

1 = failure (doesn’t exist or some other reason)

hadoop_add_javalibpath

• Synopsis

hadoop_add_javalibpath object [before|after]

• Description

Add a file system object (directory, file, wildcard, …) to the Java JNI path. Optionally provide a hint as to where in the Java JNI path it should go.

• Returns

0 = success (added or duplicate)

1 = failure (doesn’t exist or some other reason)

hadoop_add_ldlibpath

• Synopsis

hadoop_add_ldlibpath object [before|after]

• Description

Add a file system object (directory, file, wildcard, …) to the LD_LIBRARY_PATH. Optionally provide a hint as to where in the LD_LIBRARY_PATH it should go.

• Returns

0 = success (added or duplicate)

1 = failure (doesn’t exist or some other reason)

hadoop_add_param

• Synopsis

hadoop_add_param envvar checkstring appendstring

• Description

Append the appendstring if checkstring is not present in the given envvar

• Returns

Nothing

hadoop_add_profile

• Synopsis

hadoop_add_profile shellprofile

• Description

Register the given shellprofile to the Hadoop shell subsystem

• Returns

Nothing

hadoop_deprecate_envvar

• Synopsis

hadoop_deprecate_envvar oldvar newvar

• Description

Replace oldvar with newvar if oldvar exists.

• Returns

Nothing

hadoop_java_exec

• Synopsis

hadoop_java_exec command class [options]

• Description

Execute the Java class, passing along any options. Additionally, set the Java property -Dproc_command.

• Returns

Nothing

hadoop_java_setup

• Synopsis

hadoop_java_setup 

• Description

Configure/verify ${JAVA_HOME}

• Returns

may exit on failure conditions

hadoop_os_tricks

• Synopsis

hadoop_os_tricks 

• Description

Routine to configure any OS-specific settings.

• Returns

may exit on failure conditions

hadoop_status_daemon

• Synopsis

hadoop_status_daemon pidfile

• Description

Determine the status of the daemon referenced by pidfile

• Returns

(mostly) LSB 4.1.0 compatible status

hadoop_stop_daemon

• Synopsis

hadoop_stop_daemon command pidfile

• Description

Stop the non-privileged command daemon with that that is running at pidfile.

• Returns

Nothing

hadoop_stop_secure_daemon

• Synopsis

hadoop_stop_secure_daemon command daemonpidfile wrapperpidfile

• Description

Stop the privileged command daemon with that that is running at daemonpidfile and launched with the wrapper at wrapperpidfile.

• Returns

Nothing

hadoop_translate_cygwin_path

• Synopsis

hadoop_translate_cygwin_path varnameref [true]

• Description

Converts the contents of the variable name varnameref into the equivalent Windows path. If the second parameter is true, then varnameref is treated as though it was a path list.

• Returns

Nothing

hadoop_validate_classname

• Synopsis

hadoop_validate_classname classname

• Description

Verify that a shell command was passed a valid class name

• Returns

0 = success

1 = failure w/user message

hadoop_verify_confdir

• Synopsis

hadoop_verify_confdir 

• Description

Validate ${HADOOP_CONF_DIR}

• Returns

will exit on failure conditions

hadoop_verify_user

• Synopsis

hadoop_verify_user subcommand

• Description

Verify that ${USER} is allowed to execute the given subcommand.

• Returns

will exit on failure conditions

hadoop_debug

• Synopsis

hadoop_debug string

• Description

Print a message to stderr if –debug is turned on

• Returns

Nothing

hadoop_error

• Synopsis

hadoop_error string

• Description

Print a message to stderr

• Returns

Nothing

hadoop_exit_with_usage

• Synopsis

hadoop_exit_with_usage exitcode

• Description

Print usage information and exit with the passed exitcode

• Returns

This function will always exit.

hadoop_populate_slaves_file

• Synopsis

hadoop_populate_slaves_file filename

• Description

Set the slave support information to the contents of filename

• Returns

will exit if file does not exist

hadoop_rotate_log

• Synopsis

hadoop_rotate_log filename [number]

• Description

Rotates the given file until number of files exist.

• Returns

$? will contain last mv’s return value

hadoop_actual_ssh

• Synopsis

hadoop_actual_ssh hostname command [...]

• Description

Via ssh, log into hostname and run command

• Returns

Nothing

hadoop_add_common_to_classpath

• Synopsis

hadoop_add_common_to_classpath 

• Description

Add the common/core Hadoop components to the environment

• Returns

hadoop_add_to_classpath_userpath

• Synopsis

hadoop_add_to_classpath_userpath 

• Description

Add the user’s custom classpath settings to the environment

• Returns

Nothing

hadoop_common_slave_mode_execute

• Synopsis

hadoop_common_slave_mode_execute commandarray

• Description

Utility routine to handle –slaves mode

• Returns

Nothing

hadoop_connect_to_hosts

• Synopsis

hadoop_connect_to_hosts command [...]

• Description

Connect to ${HADOOP_SLAVES} or ${HADOOP_SLAVE_NAMES} and execute command.

• Returns

Nothing

hadoop_connect_to_hosts_without_pdsh

• Synopsis

hadoop_connect_to_hosts_without_pdsh command [...]

• Description

Connect to ${SLAVE_NAMES} and execute command under the environment which does not support pdsh.

• Returns

Nothing

hadoop_daemon_handler

• Synopsis

hadoop_daemon_handler [start|stop|status|default] command class daemonpidfile daemonoutfile [options]

• Description

Manage a non-privileged daemon.

• Returns

Nothing

hadoop_do_classpath_subcommand

• Synopsis

hadoop_do_classpath_subcommand [parameters]

• Description

Perform the ‘hadoop classpath’, etc subcommand with the given parameters

• Returns

will print & exit with no params

hadoop_exec_hadooprc

• Synopsis

hadoop_exec_hadooprc 

• Description

Read the user’s settings. This provides for users to override and/or append hadoop-env.sh. It is not meant as a complete system override.

• Returns

Nothing

hadoop_finalize

• Synopsis

hadoop_finalize 

• Description

Finish all the remaining environment settings prior to executing Java. This is a wrapper that calls the other finalize routines.

• Returns

Nothing

hadoop_finalize_catalina_opts

• Synopsis

hadoop_finalize_catalina_opts 

• Description

Finish Catalina configuration prior to execution

• Returns

Nothing

hadoop_finalize_classpath

• Synopsis

hadoop_finalize_classpath 

• Description

Finish Java classpath prior to execution

• Returns

Nothing

hadoop_finalize_hadoop_heap

• Synopsis

hadoop_finalize_hadoop_heap 

• Description

Finish Java heap parameters prior to execution

• Returns

Nothing

hadoop_finalize_hadoop_opts

• Synopsis

hadoop_finalize_hadoop_opts 

• Description

Finish configuring Hadoop specific system properties prior to executing Java

• Returns

Nothing

hadoop_finalize_libpaths

• Synopsis

hadoop_finalize_libpaths 

• Description

Finish Java JNI paths prior to execution

• Returns

Nothing

hadoop_import_shellprofiles

• Synopsis

hadoop_import_shellprofiles 

• Description

Import shellprofile.d content

• Returns

Nothing

hadoop_parse_args

• Synopsis

hadoop_parse_args [parameters, typically "$@"]

• Description

generic shell script opton parser. sets HADOOP_PARSE_COUNTER to set number the caller should shift

• Returns

Nothing

hadoop_secure_daemon_handler

• Synopsis

hadoop_secure_daemon_handler [start|stop|status|default] command class daemonpidfile daemonoutfile wrapperpidfile wrapperoutfile wrappererrfile [options]

• Description

Manage a privileged daemon.

• Returns

Nothing

hadoop_setup_secure_service

• Synopsis

hadoop_setup_secure_service 

• Description

None

• Returns

Nothing

hadoop_shellprofiles_classpath

• Synopsis

hadoop_shellprofiles_classpath 

• Description

Apply the shell profile classpath additions

• Returns

Nothing

hadoop_shellprofiles_finalize

• Synopsis

hadoop_shellprofiles_finalize 

• Description

Apply the shell profile final configuration

• Returns

Nothing

hadoop_shellprofiles_init

• Synopsis

hadoop_shellprofiles_init 

• Description

Initialize the registered shell profiles

• Returns

Nothing

hadoop_shellprofiles_nativelib

• Synopsis

hadoop_shellprofiles_nativelib 

• Description

Apply the shell profile native library additions

• Returns

Nothing

hadoop_start_daemon

• Synopsis

hadoop_start_daemon command class pidfile [options]

• Description

Start a non-privileged daemon in the foreground.

• Returns

Nothing

hadoop_start_daemon_wrapper

• Synopsis

hadoop_start_daemon_wrapper command class pidfile outfile [options]

• Description

Start a non-privileged daemon in the background.

• Returns

Nothing

hadoop_start_secure_daemon

• Synopsis

hadoop_start_secure_daemon command class daemonpidfile daemonoutfile daemonerrfile wrapperpidfile [options]

• Description

Start a privileged daemon in the foreground.

• Returns

Nothing

hadoop_start_secure_daemon_wrapper

• Synopsis

hadoop_start_secure_daemon_wrapper command class daemonpidfile daemonoutfile wrapperpidfile warpperoutfile daemonerrfile [options]

• Description

Start a privileged daemon in the background.

• Returns

Nothing

hadoop_verify_logdir

• Synopsis

hadoop_verify_logdir 

• Description

None

• Returns

Nothing

hadoop_verify_piddir

• Synopsis

hadoop_verify_piddir 

• Description

None

• Returns

Nothing

hadoop_verify_secure_prereq

• Synopsis

hadoop_verify_secure_prereq 

• Description

Verify that prerequisites have been met prior to excuting a privileged program.

• Returns

This routine may exit.