Hadoop YARN Timeline Reader Install

The Timeline Reader is a stand-alone server daemon and doesn't need to be co-located with any other service.

module.exports = header: 'YARN TR HBase Embedded Install', handler: ({options}) ->

Register

  @registry.register 'hconfigure', 'ryba/lib/hconfigure'
  @registry.register 'hdp_select', 'ryba/lib/hdp_select'
  @registry.register ['file', 'jaas'], 'ryba/lib/file_jaas'
  @registry.register ['yarn','service', 'create'], 'ryba/lib/actions/yarn/service/create'
  @registry.register ['hdfs','put'], 'ryba/lib/actions/hdfs/put'
  @registry.register ['hdfs','chown'], 'ryba/lib/actions/hdfs/chown'
  @registry.register ['hdfs','mkdir'], 'ryba/lib/actions/hdfs/mkdir'      
  @registry.register 'ranger_policy', 'ryba/ranger/actions/ranger_policy'

Identities

By default, the "hadoop-yarn-timelineserver" package create the following entries:

cat /etc/passwd | grep yarn
yarn:x:2403:2403:Hadoop YARN User:/var/lib/hadoop-yarn:/bin/bash
cat /etc/group | grep hadoop
hadoop:x:499:hdfs

  @system.group header: 'Hadoop Group', options.hadoop_group
  @system.group header: 'Group', options.group
  @system.user header: 'User', options.user

Wait

  @call once: true, 'masson/core/krb5_client/wait', options.wait_krb5_client
  @call once: true, 'ryba/hadoop/hdfs_nn/wait', options.wait_hdfs_nn, conf_dir: '/etc/hadoop/conf'

IPTables

IPTables rules are only inserted if the parameter "iptables.action" is set to "start" (default value).

  @tools.iptables
    header: 'IPTables'
    if: options.iptables
    rules: [
      { chain: 'INPUT', jump: 'ACCEPT', dport: options.hbase_site['hbase.master.port'], protocol: 'tcp', state: 'NEW', comment: "Yarn HBase Master RPC" }
      { chain: 'INPUT', jump: 'ACCEPT', dport: options.hbase_site['hbase.master.info.port'], protocol: 'tcp', state: 'NEW', comment: "Yarn HBase Master HTTP" }
      { chain: 'INPUT', jump: 'ACCEPT', dport: options.hbase_site['hbase.regionserver.port'], protocol: 'tcp', state: 'NEW', comment: "Yarn HBase RS RPC" }
      { chain: 'INPUT', jump: 'ACCEPT', dport: options.hbase_site['hbase.regionserver.info.port'], protocol: 'tcp', state: 'NEW', comment: "Yarn HBase RS HTTP" }
    ]

Service

Install the "hadoop-yarn-timelineserver" service, symlink the rc.d startup script in "/etc/init.d/hadoop-hdfs-datanode" and define its startup strategy.

  @call header: 'Service', ->
    @service
      name: 'hadoop-yarn-timelinereader'
    @hdp_select
      name: 'hadoop-yarn-client' # Not checked
      name: 'hadoop-yarn-timelinereader'
    @service.init
      header: 'Systemd Script HBase Master'
      target: '/usr/lib/systemd/system/hadoop-yarn-hbase-master.service'
      source: "#{__dirname}/../resources/hadoop-yarn-hbase-master-systemd.j2"
      local: true
      context: options: options
      mode: 0o0644
    @service.init
      header: 'Systemd Script HBase RegionServer'
      target: '/usr/lib/systemd/system/hadoop-yarn-hbase-regionserver.service'
      source: "#{__dirname}/../resources/hadoop-yarn-hbase-regionserver-systemd.j2"
      local: true
      context: options: options
      mode: 0o0644
    @system.tmpfs
      header: 'Run dir'
      mount: "#{options.pid_dir}"
      uid: options.ats_user.name
      gid: options.hadoop_group.name
      perm: '0775'

Layout

  @call header: 'Layout', ->
    leveldb_jar = null
    @system.mkdir
      target: "#{options.conf_dir}"
    @system.mkdir
      target: "#{options.pid_dir}"
      uid: options.user.name
      gid: options.hadoop_group.name
      mode: 0o775
    @system.mkdir
      target: "#{options.log_dir}"
      uid: options.user.name
      gid: options.hadoop_group.name
      parent: true

Configuration

Update the "hbase-site.xml" and "hbase-env.sh" configuration file.

  @hconfigure
    header: 'HBase Site'
    target: "#{options.conf_dir}/hbase-site.xml"
    properties: options.hbase_site
    backup: true
    user: options.ats_user.name
    group: options.hadoop_group.name
  @file
    header: 'HBase Log4j'
    target: "#{options.conf_dir}/log4j.properties"
    source: "#{__dirname}/../resources/hbase-log4j.properties"
    local: true
  # @call header: 'Environment', ->
  #   YARN_TIMELINESERVER_OPTS = options.opts.base
  #   YARN_TIMELINESERVER_OPTS += " -D#{k}=#{v}" for k, v of options.opts.java_properties
  #   YARN_TIMELINESERVER_OPTS += " #{k}#{v}" for k, v of options.opts.jvm
  #   @file.render
  #     target: "#{options.conf_dir}/yarn-env.sh"
  #     source: "#{__dirname}/../resources/yarn-env.sh.j2"
  #     local: true
  #     context:
  #       security_enabled: options.krb5.realm?
  #       hadoop_yarn_home: options.home
  #       java64_home: options.java_home
  #       yarn_log_dir: options.log_dir
  #       yarn_pid_dir: options.pid_dir
  #       hadoop_libexec_dir: ''
  #       hadoop_java_io_tmpdir: "#{options.log_dir}/tmp"
  #       yarn_heapsize: options.heapsize
  #       apptimelineserver_heapsize: options.heapsize
  #       yarn_ats_jaas_file: "#{options.conf_dir}/yarn-ats.jaas"
  #       # ryba options
  #       YARN_TIMELINESERVER_OPTS: YARN_TIMELINESERVER_OPTS
  #     uid: options.user.name
  #     gid: options.hadoop_group.name
  #     mode: 0o0755
  #     backup: true
  # @file.render
  #   header: 'Env'
  #   target: "#{options.conf_dir}/hadoop-env.sh"
  #   source: "#{__dirname}/../resources/hadoop-env.sh.j2"
  #   local: true
  #   context:
  #     HADOOP_LOG_DIR: options.log_dir
  #     HADOOP_PID_DIR: options.pid_dir
  #     java_home: options.java_home
  #   uid: options.user.name
  #   gid: options.hadoop_group.name
  #   mode: 0o750
  #   backup: true
  #   eof: true
  @call ->
    HBASE_MASTER_OPTS = options.opts.master_base
    HBASE_MASTER_OPTS += " -D#{k}=#{v}" for k, v of options.opts.master_java_properties
    HBASE_MASTER_OPTS += " #{k}#{v}" for k, v of options.opts.master_jvm
    HBASE_REGIONSERVER_OPTS = options.opts.regionserver_base
    HBASE_REGIONSERVER_OPTS += " -D#{k}=#{v}" for k, v of options.opts.regionserver_java_properties
    HBASE_REGIONSERVER_OPTS += " #{k}#{v}" for k, v of options.opts.regionserver_jvm
    @file.render
      header: 'Env'
      target: "#{options.conf_dir}/hbase-env.sh"
      source: "#{__dirname}/../resources/hbase-env.sh.j2"
      local: true
      context:
        HBASE_MASTER_OPTS: HBASE_MASTER_OPTS
        HBASE_REGIONSERVER_OPTS: HBASE_REGIONSERVER_OPTS
        HBASE_CONF_DIR: options.conf_dir
        HBASE_LOG_DIR: options.log_dir
        HBASE_RUN_DIR: options.pid_dir
        JAVA_HOME: options.java_home
      uid: options.ats_user.name
      gid: options.hadoop_group.name
      mode: 0o750
      backup: true
      eof: true

HDFS Layout

  @hdfs.mkdir
    header: 'HDFS root dir'
    nn_url: options.nn_url
    target: "#{options.hbase_site['hbase.rootdir']}"
    owner: 'yarn-ats'
    group: options.hadoop_group.name
    krb5_user: options.hdfs_krb5_user 
    mode: '755'

Kerberos

Create the Kerberos service principal by default in the form of "yarn-ats-hbase/{host}@{realm}" and place its keytab inside "/etc/security/keytabs/yarn-ats.hbase-master.service.keytab" with ownerships set to "mapred:hadoop" and permissions set to "0600".

  @krb5.addprinc options.krb5.admin,
    header: 'hbase ats rs'
    principal: options.hbase_site['hbase.regionserver.kerberos.principal'].replace '_HOST', options.fqdn
    randkey: true
    keytab: options.hbase_site['hbase.regionserver.keytab.file']
    uid: options.ats_user.name
    gid: options.ats_group.name
    mode: 0o0600
  @system.copy
    header: 'hbase ats master'
    source: options.hbase_site['hbase.regionserver.keytab.file']
    target: options.hbase_site['hbase.master.keytab.file']
    mode: 0o0600
    uid: options.ats_user.name
    gid: options.ats_group.name     

Kerberos JAAS

The JAAS file is used by the ResourceManager to initiate a secure connection with Zookeeper.

  @file.jaas
    header: 'Kerberos HBase Master JAAS'
    target: "#{options.conf_dir}/yarn_hbase_master_jaas.conf"
    content: 
      Client:
        principal: options.hbase_site['hbase.master.kerberos.principal'].replace '_HOST', options.fqdn
        keyTab: options.hbase_site['hbase.master.keytab.file']
      'com.sun.security.jgss.krb5.initiate':
        principal: options.hbase_site['hbase.master.kerberos.principal'].replace '_HOST', options.fqdn
        keyTab: options.hbase_site['hbase.master.keytab.file']
    uid: options.ats_user.name
    gid: options.ats_group.name
    mode: 0o600
    gid: options.hadoop_group.name
  @file.jaas
    header: 'Kerberos HBase RS JAAS'
    target: "#{options.conf_dir}/yarn_hbase_regionserver_jaas.conf"
    content: 
      Client:
        principal: options.hbase_site['hbase.regionserver.kerberos.principal'].replace '_HOST', options.fqdn
        keyTab: options.hbase_site['hbase.regionserver.keytab.file']
      'com.sun.security.jgss.krb5.initiate':
        principal: options.hbase_site['hbase.regionserver.kerberos.principal'].replace '_HOST', options.fqdn
        keyTab: options.hbase_site['hbase.regionserver.keytab.file']
    uid: options.ats_user.name
    gid: options.ats_group.name
    mode: 0o600

Dependencies

path = require 'path'
mkcmd = require '../../lib/mkcmd'