随着时间的流逝,我开始为各种客户提供咨询和合同工程工作。最近,客户要求提供某些类型的文档。
- Which static IP addresses can I use for the new network time clock we're installing?
- How do I put an exclusion in the web filter? The CEO can't get to the NRA website anymore!!
- We need to shut down the Linux server for a planned power outage. What's the command again?
这些是小型企业,通常没有专门的技术人员。在单个公司中,Wiki / Confluence / Sharepoint等都可以作为文档和环境信息的中央存储库,但是我一直在寻找一种一致的方法来将这些信息传递给离散的客户,这很困难。
I'm shooting for a process that's more portable, secure and elegant than a simple spreadsheet or the dreaded binder full of outdated information.
- 重要的IP地址,DHCP作用域等
- 网络图(如果需要)。
- 管理用户名和密码以及管理URL。
- 软件许可证密钥。
- 支持合同和保修信息。
- 供应商支持联系方式和说明。
我知道这里还有其他顾问。关于以客户友好的格式在多个环境中维护文档的任何建议或技巧?你怎么做呢?
我同意Dan认为Excel是一个很好的可移植解决方案,并且我认为他是一个很好的例子,但安全方面除外,我认为这种担心有些误导了:
无论希望使用哪种方法分发,都可以涵盖一种安全解决方案(例如,加密电子邮件,安全共享存储等)。版本控制(例如卷影副本,svn等)也是如此。
但是,仅通过建设性批评并在所有方面尊重我,我想补充一下,共享Excel电子表格的主要缺点是其并发限制。当您有两名或以上的管理员时,他们会被迫在一次选择之间进行选择,一次只能打开一个页面进行编辑,要么要保存多个副本然后进行合并(这是是最新的,哪个不是?)。这确实是一个痛苦。
更好的解决方案是使用Excel(或您希望使用的任何工具)作为所选小型数据库的前端,无论是Access(只是为了解决可移植性),MS SQL,MariaDB还是您喜欢的任何工具。
我主张将其作为一种解决方案,该解决方案不仅适合于将信息传递给另一方(= Excel),而且还适合于维护正在进行的文档。
简而言之,我的观点是,即使只有几个管理员(更不用说大型商店),依靠Excel进行文档数据存储的部门还是一个庞大的文档部门。除非只有一名管理员,否则从未见过例外。
但是使用数据库驱动的存储的部门有机会保留最新的详细文档。那么这只是一个努力的问题。 Excel是具有优点和缺点的可行的数据库前端,但绝不是唯一的选择。
对于您正在描述的核心信息(“网络图”除外),我们使用单个Excel工作簿,并将其保存到带有客户名称的网络文件夹中。虽然我可以理解为什么人们不喜欢这种方法,但我发现它非常有用,因为它是一个参考文档,可以随身携带到网站中,通过电子邮件发送和快速更新。
我最大的抱怨是缺乏版本控制,但是我还没有找到任何可行的方法而又不费劲。
为了反驳“我正在为一个比简单的电子表格更便携,安全和优雅的过程而努力”:
更可移植:与500 Kb的电子表格相比,有什么可移植性更高?我不敢使用任何基于云或基于Web的内容,因为无法保证互联网连接。
安全:我会给您的,我也希望获得使我们的解决方案更安全的解决方案。
优雅:我们花了一些时间为工作簿创建一个不错的模板。就像我说的那样,这是一个多页工作簿,而不仅仅是分散的信息的巨大页面。我认为大多数IT文档都非常适合表格形式,而电子表格使这一过程变得非常整洁和简单。
尽管我在如何记录和存储构建文档方面存在很多问题,但在可靠,格式正确的电子表格中我确实找不到问题。我还要补充一点,我们与一些大型IT服务公司合作,它们的工作方式几乎相同。再次,它很棒-我到现场,索取文档,并获得一个整洁的电子表格,供我在整个过程中使用。
这种可怕的粘合剂的最大优点是:
不管您使用什么数字系统,只要您学会了做任何值得的事情,只要自己训练自己更新资料夹,就不再重要了。
当然,如果您几乎远程进行所有支持,活页夹对您完全没有用。
我一直很喜欢使用Wiki,因为它易于维护,可以轻松访问到ILO和管理界面的超链接,远程桌面和SSH登录。自由格式适合我想要的大多数信息:
自2004年6月以来,我一直是三人合同/咨询服务的合作伙伴。我们每个人都主要使用自己的“帐户”,但是我们需要相互维护文档,以允许合作伙伴之间进行“故障转移”。我们的大多数客户都具有某种内部IT员工,其中许多人执行一定数量的日常维护,我们也需要有效地与他们交流文档。
我的两个合伙人的优势(如果可以这样称呼)是在另一家公司担任我的员工,因此,他们俩都被灌输给了我自以为是的做事方式。客户的配置之间的严格一致性(显然可以做到)是天赐的。显然,产品会发生变化,因此我们会讨论新产品/版本等,并在部署之前决定一致的配置策略。这不会扩展到大型公司,但是坦率地说,我认为这是功能而不是错误。 (我不会再开始抱怨大型的“托管服务”公司及其员工“工程师”,以及一次过一次,半成品的“解决方案”以及客户之间不一致的可怕趋势……>微笑<)
我强烈反对“可怕的活页夹”。我从未见过物理文档保持最新。我认为花时间制作文档的物理副本浪费了客户的钱。我宁愿花时间研究如何基于运行配置中的“实时”数据生成文档。
例如,我绝对不会维护IP地址信息电子表格。这就是DHCP和DNS的用途(有关详细信息,请参见下文)。如果这些事情不起作用,那么我们就会遇到重大问题。
我们已经让客户要求诸如“制作一个显示所有组策略配置的文档”之类的事情,而我却步履蹒跚,拒绝这样做。我反复提出的反建议(到目前为止是有效的)是向客户介绍管理工具,这些工具可以使他们“自助”或使用软件按需生成“实时的”客户友好文档。
我们非常努力地谨慎操作,以简单的英语拼写出来。非技术IT联系人可以例如查看计算机的Active Directory组成员身份,并查看诸如“软件-安装Microsoft Office 2010 Pro”和“组策略-信息亭计算机自动登录”之类的信息。不需要任何文档即可解释这些含义。
这是我们使用的一些“实时”数据:
对于在文本文件,Wiki等内容中存储自由格式信息的想法,我持相当否定的态度。结构有助于良好的搜索。每当我可以使用结构化的存储机制为我工作时(即使这意味着我必须编写软件来查询它),我都会喜欢它。我可以从配置文件,数据库等中解析出的注释,在遇到几乎立即过期的手动生成的文档时,总会吸引我。
当我们必须存储“自由格式”信息时,我们使用我们自己的SVN存储库。它包含了我们多年来创建的由客户提交的所有各种静态文档。自2004年以来,我们一直在使用SVN,它作为我们的协作工具非常有效。我们对数据库架构,sysadmin脚本,组策略对象备份等进行版本控制。我尝试将所有可以检查的内容都放入版本控制中。
使用基于文件系统的索引工具来搜索我的结帐非常容易。我知道我们每个人随时都有至少一个完整的存储库副本可供我们在本地使用。我们还使存储库可以通过SSL上经过身份验证的WebDAV进行访问,以防万一我们必须访问存储在其中的数据并且仅具有浏览器访问权限。
我们从未被要求这样做,但是我们很乐意在SVN服务器上创建一个帐户,以允许客户检出并与他们自己的文件进行交互(如果他们拥有如此倾向的内部资源) )。我们使用标准化的格式来存储所有静态的客户文档(软件许可文档,购买记录等),这很容易解释。
除了SVN存储库,我们还自托管电子邮件。自公司域开始接收电子邮件以来,所有传入/传出电子邮件均已存档。它可以作为BSMTP日志提供给合作伙伴以供参考(并且,就我个人而言,我认为它非常宝贵)。这种情况从未出现过,但是,我知道我们很乐意为客户提供与员工之间的往来邮件记录,如果他们有要求的话。在合作伙伴之间提供内部沟通会更加困难,因为我们很可能在同一封邮件中引用多个客户。 (我们可能应该对此有所改善,但事实并非如此。)
密码是我们流程中的主要“陷阱”。我们为每个客户使用单独的“密码安全”存储库(具有唯一的组合),以允许与客户共享安全文件。我们将所有安全文件的主密码保存在另一个安全文件中,并且只有合作伙伴知道这些密码。这部分确实需要一些工作。我想我们希望每个客户都使用一个真正的多用户密码保险库应用程序(带有审计跟踪等)来托管一个现场凭证保险库,但是我们已经将这个想法付诸实践近十年了。
我们的时间跟踪记录非常详细,并以他们想要的任何电子格式(到目前为止,已经是ASCII文本和PDF)提供给客户。客户获得每个收费事件的开始/停止时间,以及所执行工作的详细说明。我们认为这些服务说明在内部非常有价值,因为它们使我们能够跟上合作伙伴客户现场的最新情况。如果出现问题,这些记录将使我们了解这些年来我们遇到的所有以前的问题和解决方案。我不感到羞耻地说我已经通过找到我几年前忘写另一位客户的笔记而解决了一位客户的问题。
除了快速和谨慎外,还需要重新制作文档:在我的“老工作”(几年前为其他人工作)中,公司针对非付费客户提起了法律诉讼。我们最终陷入了来自非付费客户的反诉讼业务。我们的内部记录和电子邮件回复:该客户在法庭上受到传唤和骚扰。这段经历教会了我很多关于不将任何内容公开存储在固定介质中的知识。
我写了一些电子邮件,其中包含一些(erm)选择单词和短语,以表达我对这位客户以及公司其他“工程师”的不满。我根本不喜欢在公开法庭上对这些事情进行盘问。
当我们开始目前的业务时,合作伙伴同意将所有固定记录(电子邮件,文本消息,语音邮件,SVN存储库中的文件,时间跟踪器中的工作记录等)始终视为“面向客户”,甚至如果它们从未打算最终落入客户之手。这很难做到,需要很多纪律,但我认为这是值得的。我们当然想向我们的客户投射一种敬业精神,而实践就是做到这一点的方法。我一定再也不会像以前那样在法庭上感到尴尬了。
While this is not a perfect solution, but you should take a look at Device42.
您可以执行以下操作: IP和设备可以与客户关联。 而且,您可以具有VRF组,以在各个客户之间重叠IP范围。
它没有对IP /设备的精细权限(仅基于全局角色的访问),因此您不能允许最终客户直接访问。但是您可以为每个客户创建带有设备和IP信息的报告,并在需要时将其发送给最终客户端。
这至少将为您提供一个界面,以组织中央存储库中的所有信息。您可以存储资产信息,IP信息,合同信息和密码。
它还在REST API调用中提供了大多数信息,但不确定是否可以基于此为单个客户提供信息。
这可能不是您要找的东西,但这是我的工作。
I use Microsoft Office to create all of the documents for each of my customers. I use Excel (ip address information, switch port mapping, rack layout), Word (configuration information, invoices, SOW templates) and Visio (diagrams). I create a folder hierarchy with the parent folder named Consulting and a child folder named for each client. As I create or update client documents I sync them to my iPhone (using Documents To Go), USB thumb drive and DropBox account (using two factor authentication). That way I have access to all of the documentation (one way or another) anywhere and everywhere I go.
I also use a project management/reporting/invoicing/time tracking app called OfficeTime. There's an iPhone app and a companion Windows app, so I have access to project information, invoicing, hours, etc. on my iPhone when I'm on site and sync to my desktop when I get home.