该Dashboard是一种运行在Rails上的Ruby应用程序，它还不是可以添加到系统版本中的程序包，但是我们可以从Puppet Labs以RPM或者DEB包的形式获得该软件。我们也可以选择从资源进行安装。

　 　作为前提条件，Dashboard需要Puppet已经安装，并且使用存储的配置运行。Dashboard可以在最近出现的大多数Puppet版本上工 作，0.24.8版及更高版本都可以。它还需要Ruby、Rake工具以及一个MySQL数据库（以后的版本会支持更多的数据库）。

添加Yum或者Apt仓库

　　首先，我们需要添加Puppet Labs Yum，或者添加Apt仓库。对于Yum来说，我们需要为Puppet Labs创建一个Yum报告条目：

$ vi /etc/yum.repos.d/puppetlabs.repo

　　为该条目添加以下内容：

[puppetlabs]
name=Puppet Labs Packages
baseurl=http://yum.puppetlabs.com/base/
enabled=1
gpgcheck=1
gpgkey=http://yum.puppetlabs.com/RPM-GPG-KEY-puppetlabs

　　然后通过Yum安装。

$ sudo yum install puppet-dashboard

　　安装过程会提示你安装Puppet Labs释放键（release key），这是安装过程的一部分。

　　对于Apt，我们需要给/etc/apt/sources.list文件添加条目：

deb http://apt.puppetlabs.com/ubuntulucid main
deb-src http://apt.puppetlabs.com/ubuntulucid main

　　然后再给Apt添加Puppet Labs GPG键。

$ gpg --recv-key 4BD6EC30
$ gpg -a --export 4BD6EC30 | sudo apt-key add -

　　接下来，我们运行更新：

$ sudo apt-get update

　　然后安装软件包：

$ sudo apt-get install puppet-dashboard

　　在装有红帽和Ubuntu系统的主机上，Puppet Dashboard的安装目录为/usr/share/puppet-dashboard。

配置Rails应用程序

　　下一步，我们需要配置Rails应用程序，首先从数据库开始。目前Dashboard只支持MySQL数据库，那么我们就创建一个：

$ mysql --u root p
mysql> CREATE DATABASE dashboard CHARACTER SET utf8;
mysql> CREATE USER ‘dashboard‘@‘localhost‘ IDENTIFIED BY ‘password‘;
mysql> GRANT ALL PRIVILEGES ON dashboard.* TO ‘dashboard‘@‘localhost‘;

　　在此我们已经创建了一个名为dashboard的数据库，添加了一名叫做dashboard的用户，并让该用户对这个数据库拥有某些特权。你应该用适当的密码代替代码中的“密码”字符。

　　接下来，我们需要告诉Dashboard有关数据库的信息。为了做到这一点，我们需要对/usr/share/puppet-dashboard/config目录下的database.yml文件进行配置。

　　该软件包含有一个示例文件，名字为database.yml.example，我们可以对它进行复制和编辑：

$ cp database.yml.example database.yml
$ vi database.yml

　　在该文件中更新生产节（用你自己的密码代替password字符），代码如下：

production:
adapter: mysql
database: dashboard
username: dashboard
password: password
encoding: utf8

　　这个节需要YAML格式验证，所以请确保你保留了现有的缩进。

　　最后，我们需要用表格和基础数据来填充我们的新数据库。我们用Rake任务来完成这个工作。在/usr/share/puppet-dashboard目录下，运行以下命令：

$ rake RAILS_ENV=production db:migrate

　　现在Dashboard全部配置完成，我们可以运行该Rails应用程序了。运行Rails应用程序有很多方法。一种方法是使用内部Webrick服务器（这对于生产不是很好，因为它并不能很好的扩展）。

　　在/usr/share/puppet-dashboard目录下，运行：

$ sudo ./script/server -e production

　　这个命令会在端口3000上运行Dashboard，你可以通过一个网页浏览器进行访问：

http://your.host.name:3000

　　你还可以配置带有Passenger的Apache或者Nginx来运行Dashboard，这种做法是一种更稳定、扩展性更好的生产选择。在这里你可以找到一个Apache Passenger配置文件示例。

　　下篇文章中，我们将介绍如何把Puppet报告导入Puppet Dashboard。