Adding a Service

Minimum Required Role: Full Administrator

After initial installation, you can use the Add a Service wizard to add and configure new service instances. For example, you may want to add a service such as Oozie that you did not select in the wizard during the initial installation.

The binaries for the following services are not packaged in CDH 4 and CDH 5 and must be installed individually before being adding the service:
Service Installation Documentation
Accumulo Apache Accumulo Documentation
Impala (not in CDH 4) Installing Impala
Search (not in CDH 4) Installing Search
Kafka Installing Kafka
Key Trustee KMS Installing Key Trustee KMS
If you do not add the binaries before adding the service, the service will fail to start.
To add a service:
  1. On the Home > Status tab, click to the right of the cluster name and select Add a Service. A list of service types display. You can add one type of service at a time.
  2. Select a service and click Continue. If you are missing required binaries, a pop-up displays asking if you want to continue with adding the service.
  3. Select the services on which the new service should depend. All services must depend on the same ZooKeeper service. Click Continue.
  4. Customize the assignment of role instances to hosts. The wizard evaluates the hardware configurations of the hosts to determine the best hosts for each role. The wizard assigns all worker roles to the same set of hosts to which the HDFS DataNode role is assigned. You can reassign role instances if necessary.

    Click a field below a role to display a dialog box containing a list of hosts. If you click a field containing multiple hosts, you can also select All Hosts to assign the role to all hosts, or Custom to display the pageable hosts dialog box.

    The following shortcuts for specifying hostname patterns are supported:
    • Range of hostnames (without the domain portion)
      Range Definition Matching Hosts
      10.1.1.[1-4] 10.1.1.1, 10.1.1.2, 10.1.1.3, 10.1.1.4
      host[1-3].company.com host1.company.com, host2.company.com, host3.company.com
      host[07-10].company.com host07.company.com, host08.company.com, host09.company.com, host10.company.com
    • IP addresses
    • Rack name

    Click the View By Host button for an overview of the role assignment by hostname ranges.

  5. Review and modify configuration settings, such as data directory paths and heap sizes and click Continue. The service is started.
  6. Click Continue then click Finish. You are returned to the Home page.
  7. Verify the new service is started properly by checking the health status for the new service. If the Health Status is Good, then the service started properly.