Changes the configured host name and/or server administration port for a Platfora worker node.
Synopsis
platfora-node config --id number [--host hostname] [--port admin_port] | [-h]
Description
The platfora-node config changes the configured management port and/or host name of an existing Platfora worker node.
Required Arguments
--id number
This node ID number in the Platfora catalog database. Usually the master node is 0, the first worker node added is 1, the second worker node added is 2, and so on. You can run platfora-services status to see the IDs of all nodes in the Platfora cluster.
Optional Arguments
-h | --help
Shows the command-line syntax help and then exits. --host hostname
The updated host name or IP address of the worker node. -p | --port admin_port
The updated server administration port.
Examples
Update the port of the worker node ID number 2:
$ platfora-node config --id 2 --port 8004
platfora-services
Starts, stops, restarts, or checks the status of Platfora server processes. Can also be used to syncronize Platfora software and configuration files in multi-node installations. Requires one of the following sub- commands: start, stop, restart, status, or sync.
Synopsis
platfora-services [-h] [-q] [-v] [-V] start | stop | restart | status | sync [sub-command options]
Description
The platfora-services utility is used to manage Platfora server processes. It must be run with one of the following sub-commands:
• start - Starts the Platfora server processes. In multi-node installations, starts the master server first and then the worker servers in sequential order.
• stop - Stops the Platfora server processes. In multi-node installations, sequentially stops the worker servers first and then the master server.
• restart - Issues a stop immediately followed by a start. • status - Shows the status of the Platfora server processes.
• sync - Copies the Platfora software binaries and global configuration settings from the master to the worker nodes.
The following sub-commands are issued internally by the platfora-services utility. DO NOT USE without explicit directions from Platfora customer support.
• watchdog - Starts the watch dog daemon for the Platfora server process. • launch - Includes the specified Java class in the Platfora environment.
Finally, this utility ensures the clock on the master node is not skewed. The tolerance is 60 seconds. If this master node is not within the acceptable tolerance, the utility logs an error and, depending on the context, the node process is not started/added/enabled.
Required Arguments
Requires one of the following sub-commands: start, stop, restart, status, or sync. Optional Arguments
-h | --help
Shows the command-line syntax help and then exits. -q | --quiet
Runs in quiet mode. Do not send output messages to STDOUT. -v, -vv, -vvv | --verbose
Runs in verbose mode. Show all output messages. -V | --version
Shows the software version information and then exits.
platfora-services start
Starts the Platfora server processes. In multi-node installations, starts the master server first and then the worker servers in sequential order.
Synopsis
platfora-services start [-h] [-d [DEBUG]] [--hadoop_conf path] [-- platfora_conf path] [--logdir path] [--profile] [-n node_id] [- p management_port] [-w web_port] [--datadir path] [-P pid_path] [-
s jvm_size] [--no_watchdog] [--nowait] [--heapdump] [--gc] [--gclogging] [-jvmopts options]
Description
The platfora-services start command starts the Platfora server processes. If you do not specify any arguments, the command uses the configuration information specified during setup. This configuration is stored the Platfora metadata catalog. To view your current configuration, see your Global Settings in Platfora or the platfora.properties configuration file located in the $PLATFORA_CONF_DIR.
Required Arguments
No required arguments.
Optional Arguments
-h | --help
Shows the command-line syntax help and then exits. -d | --debug
Starts the Platfora server with the Java debugger listener enabled. --datadir path
The path of the Platfora data directory where the catalog database, lens data, and logs reside. Defaults to $PLATFORA_DATA_DIR or what was specified during setup.
--hadoop_conf path
Local directory path where the Hadoop configuration files reside. Defaults to what is specified for the
env.platfora.hadoopconf property. --heapdump
Enables the JVM to provide a heap dump to $PLATFORA_DATA/log/platfora-heapdump.hprof when an out of memory error occurs.
--gc G1|SmallHeap
Sets the garbage collection algorithm. --gclogging
Enables JVM garbage collection logging. --jvmopts options
Adds additional JVM options to the server process. --logdir path
The directory of the Platfora server log files. Defaults to $PLATFORA_DATA_DIR/logs. -n | --nodeid node_id
Starts the Platfora server process on the given node. The master node id is usually 0. Worker node ids can be determined by running platfora-services status.
--no_watchdog
Do not start a watch dog daemon process to monitor and restart the server process if needed. --nowait
Do not wait for the server startup tasks to complete before returning the command prompt. -P | --piddir pid_path
The path of the server PID file. Defaults to $PLATFORA_DATA_DIR/platfora.pid. --platfora_conf path
The directory that contains the Platfora server configuration files. Defaults to $PLATFORA_CONF_DIR or what was specified during setup.
-p | --port management_port
The API port of the Platfora server used by the management utilities. Defaults to what is specified for the platfora.server.management.port property.
--profile
Starts server with the Java profiler listener enabled. -s | --jvmsize jvm_size
The size of the Java Virtual Memory (JVM) to allocate to the Platfora server process (M=megabytes, G=gigabytes). Defaults to what is set for the env.platfora.jvm.maxsize property.
-w | --websvc_port web_service_port
The web service port of the Platfora application server. Defaults to what is specified for the
platfora.webservice.port property.
Examples
Start the Platfora server on all nodes in the cluster (master and workers) using the default settings: $ platfora-services start
Start the Platfora server on worker node 3 only with a 8 GB JVM: $ platfora-services start -n 3 -s 8G