Versions Compared

Old Version 4

changes.mady.by.user Sumit Mohanty

Saved on

compared with

New Version 5

changes.mady.by.user Aravindan Vijayan

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Non-mandatory fields are described in italics.

The top level fields to describe a service are as follows:

FieldWhat is it used forSample Values
name

...

 the name of the service. A name has to be unique among all the services that are included in the stack definition containing the service.
HDFS
displayName

...

the display name of the service
HDFS
version

...

the version of the service. name and version together uniquely identify a service. Usually, the version is the version of the service binary itself.
2.1.0.2.0
components

...

the list of component that the service is comprised of<check out HDFS metainfo>
osSpecifics

...

OS specific package information for the service<check out HDFS metainfo>
commandScript

...

service level commands may also be defined. The command is executed on a component instance that is a client<check out HDFS metainfo>
comment

...

a short description describing the service
Apache Hadoop Distributed File System
requiredServices

...

what other services that should be present on the cluster<check out HDFS metainfo>
configuration-dependencies

...

configuration files that are expected by the service (config files owned by other services are specified in this list)<check out HDFS metainfo>

 


service/components - A service contains several components. The fields associated with a component are:

...

FieldWhat is it used forSample Values
namename of the component
HDFS
displayNamedisplay name of the component.
HDFS
category

...

type of the component - MASTER, SLAVE, and CLIENT
2.1.0.2.0
commandScript

...

application wide commands may also be defined. The command is executed on a component instance that is a client<check out HDFS metainfo>
cardinality

...

allowed/expected number of instances

...

For example, 1-2 for MASTER, 1+ for Slave
reassignAllowedwhether the component can be reassigned / moved to a different host.true / false
versionAdvertiseddoes the component advertise its version - used during rolling/express upgrade

...

timelineAppid: the default category used to store generated metrics data

Apache Hadoop Distributed File System
timelineAppidThis will be the component name under which the metrics from this component will be collected.<check out HDFS metainfo>
dependencies
the list of components that this component depends on<check out HDFS metainfo>
customCommands

...

a set of custom commands associated with the component in addition to standard commands. RESTART_LLAP (Check out HIVE metainfo)
restartRequiredAfterRackChangeRestart Required After Rack Changetrue / false

service/osSpecifics - OS specific package names (rpm or deb packages)

...

FieldWhat is it used forSample Values
osFamilythe os family for which the package is applicable

...

any => all
amazon2015,redhat6,debian7,ubuntu12,ubuntu14,ubuntu16
packages list of packages that are needed to deploy the service
<check out HDFS metainfo>
package/name

...

name of the package (will be used by the yum/zypper/apt commands)
Eg hadoop-lzo.

 

service/commandScript - the script that implements service check

...

FieldWhat is it used forSample Values
script
the relative path to the script
<commandScript>
  <script>scripts/service_check.py</script>
  <scriptType>PYTHON</scriptType>
  <timeout>300</timeout>
</commandScript>
scriptType
the type of the script, currently only supported type is PYTHON
timeout
custom timeout for the command - this supersedes ambari default 

service/component/dependencies/dependency

FieldWhat is it used forSample Values
name
name of the component it depends on
<dependency>
  <name>HDFS/ZKFC</name>
  <scope>cluster</scope>
  <auto-deploy>
    <enabled>false</enabled>
  </auto-deploy>
  <conditions>
    <condition xsi:type="propertyExists">
      <configType>hdfs-site</configType>
      <property>dfs.nameservices</property>
    </condition>
  </conditions>
</dependency>
scope

cluster / host. specifies whether the dependent component

should be present in the same cluster or the same host.

auto-deploy
custom timeout for the command - this supersedes ambari default 
conditions

 Conditions in which this dependency exists. For example, the presence

of a property in a config.

service/component/commandScript - the script that implements components specific default commands (

...

Similar to service/commandScript )

service/component/logs - provides log search integration.

logId
 
<log>
  <logId>hdfs_namenode</logId>
  <primary>true</primary>
</log>
 
the type of the script, currently only supported type is PYTHON
primary
primary log id or not.  

service/component/customCommand - custom commands can be added to components.

...