InstallationGuide.html

<!doctype html>
<html>
<head>
  <meta charset="utf-8">

  <!-- Always force latest IE rendering engine or request Chrome Frame -->
  <meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible">

  <!-- Use title if it's in the page YAML frontmatter -->
  <title>Installation Guide | Pivotal CF Docs</title>

  <link href="../stylesheets/master.css" media="screen,print" rel="stylesheet" type="text/css" />
  <link href="../stylesheets/breadcrumbs.css" media="screen,print" rel="stylesheet" type="text/css" />
  <link href="../stylesheets/search.css" media="screen,print" rel="stylesheet" type="text/css" />
  <link href="../stylesheets/portal-style.css" media="screen,print" rel="stylesheet" type="text/css" />
  <link href="../stylesheets/printable.css" media="print" rel="stylesheet" type="text/css" />

  <script src="../javascripts/all.js" type="text/javascript"></script>
  <link href='/images/favicon.ico' rel='shortcut icon'>

</head>

<body class="pivotalax pivotalax_InstallationGuide">
<div class='wrap'>
  <script src="//use.typekit.net/clb0qji.js" type="text/javascript"></script>
  <script type="text/javascript">
      try {
          Typekit.load();
      } catch (e) {
      }
  </script>
  <script type="text/javascript">
      document.domain = "gopivotal.com";
  </script>
  <header class="navbar desktop-only" id="nav">
    <div class="navbar-inner">
        <div class="container-fluid">
            <div class="pivotal-logo--container">
                <a class="pivotal-logo" href="http://gopivotal.com"><span></span></a>
            </div>

            <ul class="nav pull-right">
                <li class="navbar-link">
                    <a href="http://www.gopivotal.com/paas" id="paas-nav-link">PaaS</a>
                </li>
                <li class="navbar-link">
                    <a href="http://www.gopivotal.com/big-data" id="big-data-nav-link">BIG DATA</a>
                </li>
                <li class="navbar-link">
                    <a href="http://www.gopivotal.com/agile" id="agile-nav-link">AGILE</a>
                </li>
                <li class="navbar-link">
                    <a href="http://www.gopivotal.com/oss" id="oss-nav-link">OSS</a>
                </li>
                <li class="nav-search">
                    <a href="http://www.gopivotal.com/search-pivotal"><span></span></a>
                </li>
            </ul>
        </div>
        <a href="http://www.gopivotal.com/contact">
            <img id="get-started" src="http://www.gopivotal.com/sites/all/themes/gopo13/images/get-started.png">
        </a>
    </div>
  </header>
  <div class="main-wrap">
    <div class="container-fluid">
      <div class="container">
        <div id="sub-nav" class="nav-container desktop-only">
          <ul class="menu">
            <li class="first expanded js-maintopic"><a id='home-nav-link' href="/pivotalax/index.html">Home</a></li>
        		<li class="first expanded js-maintopic"><a href="/pivotalax/PivotalAXVersion1_0.html">Overview of Pivotal Analytics</a></li>
        		<li class="first expanded js-maintopic"><a href="/pivotalax/InstallationGuide.html">Installation Guide</a></li>
        		<li class="first expanded js-maintopic"><a href="/pivotalax/SystemRequirementsandSizingGuidelines.html">System Requirements and Sizing</a></li>
        		<li class="first expanded js-maintopic"><a href="/pivotalax/AdministrationGuide.html">Administration Guide</a></li>
        		<li class="first expanded js-maintopic"><a href="/pivotalax/DataSourceManagementGuide.html">Data Source Management Guide</a></li>
        		<li class="first expanded js-maintopic"><a href="/pivotalax/DataVisualizationGuide.html">Data Visualization Guide</a></li>
        		<li class="first expanded js-maintopic"><a href="/pivotalax/DataIngestionAPIs.html">Data Ingestion APIs</a></li>
          </ul>
        </div><!--end of sub-nav-->
        <div class="body-container content">

          <!-- Google CSE Search Box -->
          <script>
              (function() {
                  var cx = '005804290371689664731:n1ix15a_ysy';
                  var gcse = document.createElement('script');
                  gcse.type = 'text/javascript';
                  gcse.async = true;
                  gcse.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') +
                          '//www.google.com/cse/cse.js?cx=' + cx;
                  var s = document.getElementsByTagName('script')[0];
                  s.parentNode.insertBefore(gcse, s);
              })();
          </script>
          <gcse:search></gcse:search>

          <ul class="breadcrumbs"><li><a href="./">Pivotal AX Version 1.0 Documentation</a></li> <li class="active"><span>Installation Guide</span></li></ul>

          <h3 class="title-container">Installation Guide</h3>

          
          <h1>Overview of Installation</h1>

<p>Installation of Pivotal AX requires working with your internal networking environment, a VMware vSphere ESXi environment, a Pivotal HD installation, and the Pivotal AX software. The <strong>Main Installation Steps</strong> table below describes the installation process and provides links to the procedures you should follow. -</p>

<p>When you install Pivotal AX, you first deploy a single virtual machine (VM) in a VMware vSphere environment. This single VM contains a pre-installed Pivotal Cloud Foundry  (CF) application called Pivotal CF Operations Manager that enables the installation of Pivotal AX and other CF services. You access this software using a Web browser with a network connection to this single VM.  Operations Manager allows you to describe server, Hadoop, networking, authentication, and other configuration parameters for your installation. The software then provisions and deploys multiple VMs in the vSphere environment based on the information you provide.</p>

<p>Before you begin installing Pivotal AX, make sure you have the required hardware and software available. See <a href="SystemRequirementsandSizingGuidelines.html">System Requirements and Sizing Guidelines</a>.</p>

<h1>Main Installation Steps</h1>

<table border="1"><tbody><tr><th class="confluenceTh">Step</th><th class="confluenceTh" colspan="1">Task</th><th class="confluenceTh">Link</th></tr><tr><td class="confluenceTd" colspan="1"><strong>1.</strong> Review System Requirements</td><td class="confluenceTd" colspan="1">Understand the hardware and software requirements for running Pivotal AX.</td><td class="confluenceTd" colspan="1"><a href="SystemRequirementsandSizingGuidelines.html">System Requirements and Sizing Guidelines</a></td></tr><tr><td class="confluenceTd" colspan="1"><strong>2.</strong> Download the software</td><td class="confluenceTd" colspan="1"><p>Download the following files from the Pivotal Network Web site:</p><ul><li>Pivotal CF Virtual Appliance (OVA file) - <code>pivotal-cf-1.0.0.1.ova</code></li><li>Pivotal AX Binary -<code> pax-1.0.0.0.zip</code></li></ul></td><td class="confluenceTd" colspan="1"><a class="external-link" href="https://network.gopivotal.com" rel="nofollow">Pivotal Network</a></td></tr><tr><td class="confluenceTd" colspan="1"><strong>3.</strong> Deploy hardware appropriate for your business</td><td class="confluenceTd" colspan="1">Understand the type of analysis you want to perform and the amount of data you need to analyze to determine the number and capacity of hardware and virtual machines required to run Pivotal AX.</td><td class="confluenceTd" colspan="1"><a href="SystemRequirementsandSizingGuidelines.html#SystemRequirementsandSizingGuidelines-sizing">Sizing Guidelines</a></td></tr><tr><td class="confluenceTd"><strong>4</strong>. Prepare a vSphere ESX cluster for use with Pivotal AX</td><td class="confluenceTd" colspan="1"><p>You deploy Pivotal AX on one or more VMware ESXi server(s). The size and number of ESX servers required depend on the amount of data and type of analysis you need to perform.</p><p>You use a vSphere client to configure your ESXi environment for use with Pivotal AX. See your VMware vSphere documentation for more information.</p><p>For help with determining the correct number and size of servers, see <a href="SystemRequirementsandSizingGuidelines.html#SystemRequirementsandSizingGuidelines-sizing">Sizing Guidelines</a>.</p></td><td class="confluenceTd"><a class="external-link" href="http://pubs.vmware.com/vsphere-55/index.jsp?lang=en_US" rel="nofollow">VMware vSphere 5.5 Documentation Center</a></td></tr><tr><td class="confluenceTd" colspan="1"><strong>5.</strong> Deploy the Pivotal CF Operations Manager template as a virtual machine</td><td class="confluenceTd" colspan="1"><p>You use a OVA template file to create a virtual machine that runs the Pivotal CF Operations Manager. You use Operations Manger to install Pivotal AX, and optionally, other Cloud Foundry services.</p><p><span>After you configure and start this virtual machine, the Pivotal CF Operations Manager application starts. You access this application using a Web browser that connects to services running on this virtual machine.</span></p></td><td class="confluenceTd" colspan="1"><a href="DeployingthePivotalCFOperationsManagerVirtualMachine.html">Deploying the Pivotal CF Operations Manager Virtual Machine</a></td></tr><tr><td class="confluenceTd"><strong>6</strong>. Run the Pivotal CF Operations Manager</td><td class="confluenceTd" colspan="1"><p>Using the Pivotal CF Operations Manager Web application, you enter configuration values for Operations Manager.</p></td><td class="confluenceTd"><a href="ConfiguringPivotalCFOperationsManagertoInstallPivotalAX.html">Configuring Pivotal CF Operations Manager to Install Pivotal AX</a></td></tr><tr><td class="confluenceTd"><strong>7.</strong> Prepare a Pivotal HD installation for use with Pivotal AX</td><td class="confluenceTd"><p>Pivotal AX requires a Pivotal HD (Hadoop) cluster. See your Pivotal HD documentation for installation and configuration information.</p><p>If your Pivotal HD deployment was installed using the Pivotal Command Center, see <a href="PreparingyourPivotalHDDeploymentforPivotalAX.html">Preparing your Pivotal HD Deployment for Pivotal AX</a> for further instructions.</p><p>If your Pivotal HD deployment was installed using the Pivotal CF Operations Manager, skip this step.</p></td><td class="confluenceTd"><a href="PreparingyourPivotalHDDeploymentforPivotalAX.html">Preparing your Pivotal HD Deployment for Pivotal AX</a></td></tr><tr><td class="confluenceTd" colspan="1"><strong>8</strong>. Configure Pivotal AX</td><td class="confluenceTd" colspan="1"><p>Using the Pivotal CF Operations Manager Web application, you enter configuration values for your Pivotal AX installation. Operations Manager uses this configuration information and connects to your vSphere cluster and provisions the virtual machines needed for your deployment, installs the Pivotal AX software, and starts the application. Depending on the size of your deployment this step may take up to several hours to complete and does not require user interaction.</p></td><td class="confluenceTd" colspan="1"><a href="ConfiguringPivotalAX.html">Configuring Pivotal AX</a></td></tr></tbody></table>

<h1>Required Information for Installation</h1>

<p>You will need the following information available before you begin the installation:</p>

<ul>
<li>  IP Address of the vSphere installation where you will deploy Pivotal AX. </li>
<li>  SMTP (outgoing mail server) connection information (IP address, port number, user name, and password)</li>
<li>  Proxy server connection information (needed only if proxy servers are required in your network) </li>
<li><p>Pivotal HD connection information—IP addresses and port numbers for the following Pivotal HD components:</p>

<ul>
<li>  HDFS namenode</li>
<li>  Hbase master</li>
<li>  Hive server</li>
<li>  Jobtracker</li>
<li>  Yarn resource manager</li>
<li>  Yarn scheduler</li>
<li>  Map Reduce History Server</li>
<li>  Host mappings (host name and IP address) of all nodes in your Pivotal HD cluster</li>
</ul></li>
<li><p>Networking information. See <a href="SystemRequirementsandSizingGuidelines.html">Networking Requirements</a>.</p></li>
<li><p>HDFS endpoint connection information </p></li>
<li><p>YARN resource manager connection information </p></li>
<li><p>Hbase master connection information </p></li>
<li><p>Name and email address of at least one administrative user for Pivotal AX</p></li>
<li><p>Email alias for user support</p></li>
<li><p>Email address to receive new user notifications</p></li>
</ul>


        </div><!-- end of body-container content-->
      </div><!-- end of container -->
    </div><!--end of container-fluid-->
  </div><!--end of main-wrap-->

  <div class="site-footer desktop-only">
      <div class="container-fluid">
          <div class="site-footer-links">
              <span class="version"><a href='/'>Pivotal Documentation</a></span>
              <span>&copy;
                  <script>
                      var d = new Date();
                      document.write(d.getFullYear());
                  </script>
                  <a href='http://gopivotal.com'>Pivotal Software</a> Inc. All Rights Reserved.
              </span>
          </div>
      </div>
  </div>

  <script type="text/javascript">
      (function() {
          var didInit = false;
          function initMunchkin() {
              if(didInit === false) {
                  didInit = true;
                  Munchkin.init('625-IUJ-009');
              }
          }
          var s = document.createElement('script');
          s.type = 'text/javascript';
          s.async = true;
          s.src = document.location.protocol + '//munchkin.marketo.net/munchkin.js';
          s.onreadystatechange = function() {
              if (this.readyState == 'complete' || this.readyState == 'loaded') {
                  initMunchkin();
              }
          };
          s.onload = initMunchkin;
          document.getElementsByTagName('head')[0].appendChild(s);
      })();
  </script>
  <script type="text/javascript">

    var _gaq = _gaq || [];
    _gaq.push(['_setAccount', 'UA-39702075-1']);
    _gaq.push(['_setDomainName', 'gopivotal.com']);
    _gaq.push(['_trackPageview']);

    (function() {
      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
    })();

  </script>
</body>
</html>