标签: documentation

我一直看到带有两个参数语法的 HAProxy 配置示例。实际上，1.4.18 提供的默认配置文件包含以下内容：

listen  appli1-rewrite 0.0.0.0:10001
    cookie  SERVERID rewrite
    balance roundrobin
    server  app1_1 192.168.34.23:8080 cookie app1inst1 check inter 2000 rise 2 fall 5
    server  app1_2 192.168.34.32:8080 cookie app1inst2 check inter 2000 rise 2 fall 5
    server  app1_3 192.168.34.27:8080 cookie app1inst3 check inter 2000 rise 2 fall 5
    server  app1_4 192.168.34.42:8080 cookie app1inst4 check inter 2000 rise 2 fall 5

我注意到完全没有任何绑定选项，所以我相信这是绑定的简写吗？

HAProxy 文档 ( http://haproxy.1wt.eu/download/1.5/doc/configuration.txt ) 包含一个与此语法无关的示例，但没有在任何地方指定、记录或解释它。

该文档只是显示listen <name>：

All proxy names must be formed from upper and …

我正在使用 Jenkins 构建 HTML 文档并将其部署到本地 Apache Web 服务器以供我们的开发人员使用。当我在终端中运行命令时，一切都安装正确（证明服务器设置正确）。但是，当从 Jenkins 内部运行相同的命令时，它们会被调用但没有任何变化。它不会删除html.zip（第 18 行），不会将文件移动到 中/var/html/www/subdir，并且不会报告curl请求失败之外的任何错误。我对我做错了什么有点迷茫。

我应该注意，我将整个脚本称为sudo. 我知道这是不安全的，但我想我会先尝试让脚本工作，然后再更改。为了确保user在安装文档时不会遇到问题，我暂时允许它以 sudo 身份运行任何命令而无需密码。同样，我知道这是不安全的，但本着试图消除变量的精神，我添加了这个。

Jenkins 像这样调用这个脚本： sudo ./documentation-publisher.sh

目前对脚本的权限限制最少，777。调用ls -l脚本报告： -rwxrwxrwx 1 devop developers 1144 Dec 3 10:29 documentation-publisher.sh

我尝试了这篇文章中关于在脚本中显式设置路径的建议，但没有发现任何差异。使用的每个命令的显式路径也不会改变行为。

#!/bin/sh -x

echo "Archiving generated HTML for transfer..."
cd Example/docs/html/
zip -r html.zip ./
scp -i ~/.ssh/id_rsa html.zip user@my.host.example.com:/home/user 
ssh -i ~/.ssh/id_rsa user@my.host.example.com 

echo "Extracting generated HTML into www directory..."
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games
unzip -o …

假设一家大型企业在（在此处插入随机位置）开设了一个新办公室，并希望新同事尽快跟上进度。我们也可以说，这家企业是一个非常典型的企业，环境复杂，历史悠久，几乎完全缺乏文档。

已经决定的是，新同事将收到针对最典型任务的 howto 风格的文档，并将获得一些更复杂系统的类似架构文档。

关于改进这个过程的任何想法？更具体地说，这样的 howto 文档应该是什么样子才有帮助？

文档中是否有专门用于示例的 IP 地址范围？（例如 DNS 的 example.com）

我有一本Pulling Strings with Puppet书（写于 2007 年），但考虑到它有一堆模棱两可的语言，我想知道从那以后发生了多少变化？我在语言教程的顶部找到了这个发行说明页面和一个（简短的）总结表，但都没有日期，所以我不知道从哪里开始（更详细的注释使阅读变得相当枯燥）。

有谁知道有一个页面列出了自那本书出版以来发生的变化？

只是一些关于迁移到 XtraDB 的问题，我在任何地方都找不到。

我的团队一直在使用 MyISAM dbs 进行生产，并且想知道迁移到 Percona 的 XtraDB 有多难，您将如何进行？

我必须先将 MyISAM 迁移到 InnoDB 还是可以直接迁移到 XtraDB？

我在我的 Fedora 机器上安装了带有 XtraDB 包的 Percona 服务器，但文档对如何使用它不是很有帮助，所以我想知道 Percona 只是搭载在标准的 MySQL 安装上还是一个单独的实体？

关于如何解决我的问题的文档链接会很棒。

看起来它甚至没有记录在 samba 网站本身上，还是我错过了？

我曾使用Wink为员工创建有关设置和使用各种程序的 Flash 教程。这是一个不错的工具，但有时我希望我有更多选择。

您是否使用过一种或多种工具来完成您认为必不可少的此类工作？我不必是 Flash，但首选易于分发且没有功能问题的东西。

我正在从事一个项目，我想为各种项目执行主机文档。这些项目的一部分将来自 Powershell，其余的将来自 NMAP。对于 Powershell 部分，我正在尝试构建一些类似于SYDI-Server 的本土产品项目。它将使用 Powershell 代替 WMI，并允许使用更大、更简单的方法从远程机器获取各种结果。此外，SYDI-Server 项目已经有一段时间没有更新了。NMAP 部分将用于在远程主机上执行一两次扫描并返回结果，以便 Powershell 可以使用或使用这些结果并将它们添加到正在生成的最终报告中。这个想法与报告是从 Powershell 输出的 MS Word 文档类似，该文档包含主机文档所需的所有元素。

说了这么多，有没有办法让数据从 Powershell 共享或来回发送到 NMAP？有没有办法在 Powershell 中使用或解析 NMAP 的结果以进行进一步操作？

我管理着 500 多个站点，需要一种更好的可视化方式来记录和引导人们浏览给定的数据中心。

我正在考虑拍摄几张（数百张）照片并将它们拼接在一起，以便我可以更好地了解布局和环境。

微软很少有有趣的程序。一种是不受支持的 exe，称为Image Composite Editor，另一种称为 Photosynth，它支持照片的交互式 3D 显示。缺点是图像存储在 Microsoft 的服务器上，我不确定它们是默认为公共视图还是私有视图。

您是如何应对这一挑战的，您使用了哪些工具来解决它？

我发现 Find 手册的概要难以阅读 替代文本 http://files.getdropbox.com/u/175564/syntax_manual.png

假设您正在查找具有 777 权限的目录。 Pixelbeat的建议是

find -type d ! -perm -777

我的 OS/X 给出了以下内容

find: illegal option -- t
find: illegal option -- y
find: illegal option -- p
find: illegal option -- e
find: d: No such file or directory

在使用概要作为帮助时我不确定的事情

• 无法看到将选项放在哪里-type：我可以清楚地测试这个，但我想学习更好地阅读手册，这样我就不需要寻求帮助了。
• 无法理解为什么我们需要两行概要：似乎强调许多路径是可选的
• 为什么 Pixelbeat 在命令中使用感叹号？

让我们再举一个 Grep 手册的例子。

替代文字 http://files.getdropbox.com/u/175564/grep_manual.png

它有一个清晰的概要，虽然我只会用一行。我可以直接看到我们可以通过 grep

grep -r "masi" .

你如何阅读类似于 Find 手册的手册？

我正在 ms word 中创建它，以创建一个带有标签的 3 环活页夹，其中包含有关我们 Web 服务器的所有文档。

我应该包括哪些主要类别？

我们有2台服务器，都是windows，1台用于web，1台用于sql server，web 1，运行iis7和coldfusion。

我没有受过系统管理员的培训，只是我学到的东西。比如我宁愿有更多的信息而不是没有信息，例如我们刚迁移服务器时，我们错过了很多事情，因为没有文档。

所以我想做一个彻底的工作？我不介意这是一个 wiki，但我的老板和同事对 wiki 和如何使用 em 不太熟悉。我倾向于成为我们小组中的肛门者，想要点所有的 i 并记录所有内容。

有什么建议？

我正在为公司网络上的一个小域做系统管理员。我们有自己的 DNS、AD、DHCP 服务器等，并同时使用 HyperV 和 ESX。

对于这种设置，我到底需要记录什么？例如，我已经记录了所有密码（我更喜欢使用一种密码保险箱形式，但我公司的其他人不同意，无论如何我在本地使用密码保险箱）。我还记录了 DHCP 服务器的范围和租用期。还要记录什么？

谢谢