-
# cd /home
-
# sh latest
Installation（安装）
Overview（概述）
cPanel和WHM使用的是综合的安装程序，与安装复杂的cPanel和WHM程序包相比省了很多力气。安装cPanel和WHM，你需要：
·一个安装了supported operating systems（支持的操作系统）之一的基本服务器。
·一个cPanel证书（如果没有这个证书文件，cPanel和WHM不能运行）。
注意：你可以从authorized cPanel distributor or partner（授权的cPanel经销商或合作伙伴）那里获得证书。你也可以得到一个free 15-day test license（15天的免费试用证书）。
Before You Begin（在你开始之前）
cPanel和WHM只能安装到安装好操作系统的空白服务器上。你的服务器上不能有任何准备保留的数据。这些数据包括但不限于网页，配置文件，用户账户和脚本。安装程序可能会对你的系统做不少改动，包括为你下载和配置需要的程序包。由于cPanel对系统的改动量相当大，因此建议，如果要卸载cPanel和WHM软件，请重新格式化服务器。
推荐使用带有基本安装选项的操作系统全新安装cpanel和whm。需要有开发工具库（gcc,C等）和wget。
·cPanel和WHM会安装Apache，MySQL，exim，PHP等。你不需要预先安装这些服务程序。
·你应该保证你的程序包管理（或端口）系统配置无误（yum，apt-get，up2date，ports）。
·你还需要确定/etc/resolv.conf下包含的是可以让你正常解析域名的有效解析服务器。
例 > 如果你想对此进行测试，可以尝试：dig domain.com@serverip
句法：用一个有名的域名替换“domain.com”部分，用/etc/resolv.conf目录下的一个解析服务器的IP地址替换“serverip”部分。
这个服务器的主机名应该是一个特别的名字，不能用于服务器的其他地方。千万不要将主机名设定为一个已用的名称（www，ftp，mail等）或者设定为服务器上的一个账户名（www.domain.com）。这就是说你的主机名绝对不能是一个域名，尤其不能是你的域名！！
如果你已经获得了cpanel许可证，而且你希望cPanel来为你安装，你可以通过request it提出请求。请一定要提供你的IP地址，服务器以及服务器安装的操作系统的根密码。我们不收安装费。
下面是推荐的分区
| Item | Setting |
| /boot | 35 MB (Megabytes) |
| /usr | 8192+ MB (8192MB if you have a 80GB drive, 10240MB for a 100GB drive, 20480MB for a 200GB drive, etc.) |
| /var | 2500+ MB |
| /tmp | 512+ MB |
| / | 2048 MB |
| /home | Grow to fill disk |
| swap | 2x memory size |
注意：不同的分区方案适用于不同的主机类型。有些服务器可能要求按照与一般的服务器不同的方式分配空间。推荐方案意在为更多的主机类型提供足够的空间，但却不能代替真实的体验。这个分区方案可以根据你实际的设置需要进行修改。
“/tmp”是一个比较特殊的目录，它要求对系统所有用户和进程都可写。一般来说，一个目录如果所有用户和进程都可写的话，会有很大的安全隐患，但是这个目录不一样。为了将不安全目录带来的安全隐患降到最低，需要确认并可能重装带有“no exec”选项的分区。另外，安装程序将确认附加信息（sticky bit）设置在这个目录下且其他许可正确无误。如果“/tmp”没有安装在一个独立的分区，安装程序会创建一个512M的文件系统磁盘图像并用“no exec”指令将“/tmp”安装到新创建的磁盘图像上。在大多数情况下，512M对于“/tmp”分区已经足够了；不过你的系统可能需要更大的空间。因此建议，在安装cPanel之前为“/tmp”的mount point（根据具体的尺寸大小而定）留有一个单独的分区。
Custom Configurations（自定义配置）
cPanel在cPanel和WHM软件中提供了很多工具，便于解决自定义服务器和客户端的配置。像这些工具中的easyapache，你可以用来配置模块，编译选项，httpd.conf修改等。其中还有一系列的钩子（hooks）/usr/local/cpanel/hooks/ ，便于你根据不同的事件进行不同的操作。我们的宗旨是让操作更灵活，让你的服务器按照你所希望的那样来运行。
目前不推荐使用以下配置，cPanel也不支持：
·Network Address Translation（NAT，网络地址转换）
·www.cpanel.net的可支持操作系统列表中未列出的操作系统
在使用cPanel和WHM时，如果使用以上任一配置将可能并且很可能导致一些预想不到的结果。我们强烈建议您不要使用。
Minimum System Requirements（最低系统要求）
·P266
·256Meg的RAM（内存）
·20GB的空间（托管多个账户需要的分区空间。新文件需要的空间不到500MB）
To Install cPanel and WHM（安装cPanel和WHM）
确认你是作为root登录的，然后执行以下命令：
安装程序开始了，不同的机器可能需要30到60分钟不等。如果出现提问又没有默认的回答，请按Enter或q键。安装完成后，你需要设置WebHost Manager——查看Logging on for the First
Time获取更多信息。
注意：你必须在连接稳定的网络上安装cPanel。如果在安装cPanel过程中shell session断开，那么安装就失败了。你可以使用sh latest重新开始安装，不过我们建议先将你的机器格式化后再开始安装，以确保安装不会出问题。
Logging On For The First Time（第一次登录）
如果你是第一次登录WebHost Manager，你需要在服务器上完成一些基本设置。完成之后，你就可以正常登录到WebHost Manager了。查看Logging On获取更多信息。
Steps（步骤）
1. 在网络浏览器中输入你WebHost Manager的地址。地址格式应该是http://www.yourdomain.com:2086/或https://www.yourdomain.com:2087/。
2. 在User Name和Password栏中输入你的用户名（root）和密码（服务器的根密码）。
3. 点击OK。
4. 在第一页上点击Next（下一步）。
5. 阅读法律协议，点击I Agree（我同意）或I Disagree（我不同意）按钮。
6. 在Main Shared Virtual Host IP栏中输入你准备用于设置虚拟主机的IP地址。所有账户都会被自动创建到这个IP地址上（除了有独立IP地址的账户）。
注意：这个IP地址用于共享IP域名。你可以向服务器添加其他IP地址用于独立IP域名，不过应该将所有共享IP域名放到这个IP地址上。
7. 在Server Contact E-Mail Address和Server Contact Pager Address栏中输入服务器管理员的详细联系信息。
8. 在Default cPanel Theme栏中输入你准备使用的默认的cPanel主题名。所有新创建的没有指定主题的账户都将显示这一主题。查看31-Themes部分获取更多有关主题的信息。
9. 如果你使用eth0以外的设备作为互联网的主要连接，请在Alternate Main Ethernet Device栏中输入设备名。
10. 在Default Home Directory和Home Directory Prefix栏中分别输入将创建所有新用户账号的默认用户目录和与其他用户分区匹配的前缀。如果你输入一个前缀“home”，所有含有“home”的目录都将被用来存储账号。这也就是说，即便你将默认的用户目录设定为/home，但如果你输入“home”作为用户目录前缀，那么在/home /home2 /usr/home /home3以及其他名称中含有“home”的目录下都会创建新账户。因此，你绝对不能用名称中含有“home”的目录来存储备份。
11. 在Hostname栏中输入服务器当前的主机名。
注意：这个服务器的主机名应该是一个特别的名称，不能用于服务器的其他地方。千万不要将主机名设定为一个已用的名称（www，ftp，mail等）或者设定为服务器上的一个账户名（www.domain.com）。这就是说你的主机名绝对不能是一个域名，尤其不能是你的域名！！
12. 输入你希望收到的Apache日志的类型。有以下两个选项：
·Combined——记录所有信息，包括参照页，用户代理和被请求的文件。
·Access——只记录被请求的文件信息。
注意：这些日志文件是登录到你服务器文件或站点的日志。日志中包含的更多信息可以告诉你是谁在访问服务器。不过要注意，记录越多的日志就需要越大的CPU来创建和查看日志。
13. 创建新账户时，在Minimum UID栏中输入待分配的用户ID最小值。通常，低于500的值会保留给系统用户使用，其他用户不能占用。因此，我们不建议将Minimum UID设定在500以下。
注意：系统中每个用户都会分配到一个用户ID值。这些数值与用户名一起成为系统辨别每个用户的标识。
14. 在Primary Nameserver，Secondary Nameserver，Tertiary Nameserver和Fourth Nameserver栏中输入四个解析服务器名称。Primary Nameserver和Secondary Nameserver是必填项。
注意：这些解析服务器在工作之前需要到注册商那里进行注册。如果可能的话，你的解析服务器不该在这个服务器上。使用服务器上的解析服务器或者外部的解析服务器可以帮助解析你服务器上的域名。解析服务器越多，DNS信息不能用的可能性就越小。
15. 选择是否为Apache脚本/cgi-bin/创建别名/usr/local/apache/cgi-bin/。y=Yes，n=no。这个别名意味着，Apache会将/cgi-bin/目录下的所有文件当作cgi脚本来处理。
16. 在AIM Password和AIM Username栏中输入你AIM（AOL Instant Messenger）的用户名和密码。
17. 在Server Contact ICQ，ICQ ID和ICQ Password栏中分别输入你的ICQ用户身份号码，ICQ ID和ICQ密码。
18. 如果需要，在Master Nameserver栏中输入主要解析服务器的IP地址。
如果启用这一选项，你的服务器将成为辅助服务器。在启用这一选项后，最好与主要解析服务器建立信任关系。
查看8-DNS Functions部分（根据中文手册的页面编排添加链接）获取更多有关建立信任关系的信息。
19. 如果这个服务器属于一个服务器集群（cluster），在Master Cluster Server中输入主要集群服务器的IP地址。
20. 点击Save（保存）。
21. 点击Finish（完成）。
22. 点击Continue（继续）。
Troubleshooting（疑难解答）
你可以随时修改最初的服务器设置。查看Editing your server setup获取更多信息。
Logging On（登录）
你需要登录后才能使用WebHost Manager来管理你的网络服务器。记住，WebHost Manager给了用户很高的访问权限，只能让可信赖的人员使用。
Steps（步骤）
1. 在网络浏览器中输入你WebHost Manager的地址。地址格式应该是http://www.yourdomain.com:2086/或https://www.yourdomain.com:2087/。
2. 在User Name和Password栏中输入你的用户名（root）和密码（服务器的根密码）。
3. 点击OK。
4. 接着你会看到WebHost Manager的主页面。
Troubleshooting（疑难解答）
如果你的浏览器用http://www.yourdomain.com:2086/或https://www.yourdomain.com:2087/都无法登录，请尝试http://www.yourdomain.com/whm。
Change Log（变更记录）
WebHost Manager Change Log显示了cPanel和WHM以往版本的变更记录和你正在运行的WHM的变更记录。日志会显示所有的纠错记录，新功能，以及自cPanel和WHM上一个版本的变更之处。
Steps（步骤）
1. 登录到WebHost Manager。如果需要，点击查看Logging on。
2. 点击导航菜单顶部的Change Log。