คำถามติดแท็ก documentation

19
คุณทำเอกสารเครือข่ายอย่างไร
ฉันไม่แน่ใจว่าจะถามคำถามนี้อย่างไรเนื่องจากฉันไม่ได้อยู่ในสนาม สมมติว่าคุณเป็นผู้ดูแลระบบเครือข่ายและออกจากงานของคุณ ผู้ชายคนใหม่รู้ได้อย่างไรว่าจะเริ่มต้นอย่างไร

30
คุณบันทึกการทำงานกระบวนการและสภาพแวดล้อมของคุณอย่างไร
คุณใช้รูปแบบวิกิหรือไม่? ถ้าเป็นเช่นนั้นผลิตภัณฑ์ใด? (MediaWiki, Confluence, Sharepoint และอื่น ๆ ) คุณสร้างฐานความรู้หรือไม่? (เอกสารสั้นปัญหา / วิธีแก้ปัญหา) คุณพบข้อท้าทายอะไรบ้างในการสร้างเอกสารที่ใช้งานได้ดังนั้นคุณจะไม่ได้รับสายเมื่อคุณหยุดพักร้อน? สำหรับฉันฉันพบว่ามีองค์กร "ความเฉื่อย" จำนวนหนึ่งที่เกี่ยวข้องกับการทำเอกสาร ดูเหมือนว่าจะเป็นคนประเภทอื่นที่สามารถทำงานได้แล้วลองคิดดูว่าพวกเขาทำงานได้อย่างไรและอธิบายให้คนอื่นทำเช่นนั้นได้ - ประเภทของคุณ "go meta" และไม่ใช่ว่าทุกคนจะสบายใจในการทำเช่นนั้น ปรับปรุง คำตอบจนถึงขณะนี้รวมถึง ที่บรรจบกัน Flexwiki Fogbugz Mediawiki (พร้อมปลั๊กอินเช่น fckeditor) Sharepoint หัวข้อใดกรุณาติดต่อ เอกสาร Word / Excel / Visio สคริปเอกสาร แก้ไข:คุณไม่ได้ทำการจัดทำเอกสารเครือข่ายของคุณด้วยระบบการตรวจสอบของคุณหรือไม่? Nagios สนับสนุนให้ใช้คำสั่งผู้ปกครองเสมอเพื่อสะท้อนถึงโครงสร้างเครือข่ายของคุณและคำสั่งnotes_urlได้รับการออกแบบมาเพื่อให้คุณเชื่อมโยงกับวิกิหรือเอกสารที่ใช้เบราว์เซอร์อื่น ๆ ดังนั้นที่นี่ "เอกสาร" ถูกแยกระหว่าง "เอกสารที่มีชีวิต" ของระบบการตรวจสอบและเอกสารออฟไลน์ที่มีรายละเอียดมากขึ้นในวิกิ เนื่องจากฉันใช้เวลามากมายที่จ้องมอง Nagios …

14
หากคุณโดนรถบัส บริษัท ของคุณจะมีปัญหาหรือไม่?
ที่ทำงานฉันเป็นคนไอทีคนเดียว (ทำทุกอย่างแล้วทำตอนนี้พิมพ์ผู้ชาย) ในช่วง 10 ปีที่ผ่านมา ถ้าฉันถูกรถบัสชนพวกเขาจะถูกเมาอย่างสมบูรณ์ ฉันเคยพูดถึงผู้บริหาร / ประธานพิมพ์หลายครั้ง แต่พวกเขาไม่สนใจฉัน เลวร้ายเกินไปสำหรับพวกเขา ฉันจะทำอย่างไรเพื่อบรรเทาความเจ็บปวดของพวกเขา (หรือฉันควรสนใจด้วย) (ใช่นี่ควรเป็นวิกิชุมชน แต่ฉันไม่เห็นช่องทำเครื่องหมาย ... บางทีฉันอาจมีตัวแทนไม่เพียงพอ)

6
เริ่มต้นด้วยเอกสาร
เราไม่ได้ทำเอกสารใด ๆ ในที่ทำงานของฉัน ฉันใหม่สมบูรณ์และขอคำแนะนำบางอย่างเริ่มต้น ฉันมีคำถามสองสามข้อ: อะไรคือเอกสารสำคัญที่ดูแลระบบควรเขียนและบำรุงรักษา? และทำไมเหล่านี้จึงสำคัญ คุณทำเอกสารของคุณให้สอดคล้องกับระบบได้อย่างไร? คุณจะลดความซ้ำซ้อนของข้อมูลได้อย่างไร คำแนะนำแนวทางปฏิบัติที่ดีที่สุดรูปแบบการต่อต้าน?

9
เอกสารประกอบแบบ A-A-Manual และเอกสารประกอบ As-A-Checklist
ฉันเคยพูดคุยกับบุคคลอื่นในแผนกของฉันเกี่ยวกับเอกสารโดยเฉพาะระดับรายละเอียดและข้อกำหนด ในมุมมองของพวกเขาเอกสารเป็นรายการตรวจสอบอย่างง่ายของสิ่ง Y ที่ต้องทำเมื่อสิ่ง X ผิดพลาด ฉันไม่เห็นด้วย. ฉันคิดว่านี่เป็นทึกทักว่าปัญหาทั้งหมดใน IT สามารถถูกต้มลงในรายการตรวจสอบอย่างง่ายของกระบวนการกู้คืน ฉันคิดว่ามันไม่สนใจความซับซ้อนของสถานการณ์อย่างสมบูรณ์และเนื่องจากคนอื่น ๆ ในแผนกไม่ได้มีความเข้าใจอย่างลึกซึ้งเกี่ยวกับปัญหา (ซึ่งเป็นสาเหตุที่ฉันเขียนเอกสาร - ดังนั้นพวกเขาจึงมีบางสิ่งบางอย่างที่จะอ้างถึง ) ว่าเอกสารควรมีเนื้อหาพื้นหลังพื้นฐานบางอย่างเช่น: วัตถุประสงค์ของระบบ (ย่อย) ที่เป็นปัญหา ทำไมมันถูกกำหนดค่าในลักษณะที่ ความคาดหวังของเหตุการณ์ที่จะเกิดขึ้นเมื่อมีการใช้การตั้งค่า / ขั้นตอน ปัญหาที่อาจเกิดขึ้นซึ่งอาจทำให้กระบวนการล้มเหลว อย่างไรก็ตามฉันค่อนข้าง outvoted ในเรื่องนี้ดังนั้นเอกสารของฉันจะต้องเขียนใหม่ในแบบฟอร์มที่ระบุว่า "ขั้นตอน ABC ที่ใช้ในการสั่งซื้อจะแก้ไขปัญหา X" ฉันมักจะได้ยินถึงความโศกเศร้าที่ต้องใส่ลงในกระดาษหน้าเดียว ลองอธิบายการกำหนดค่า Squid ACL ให้กับใครบางคนในลักษณะนี้รวมถึงการแก้ไขปัญหาผ่านเอกสารหน้าเดียว นั่นเป็นเพียงหนึ่งในเอกสารครึ่งโหลที่ "รอการเขียน" เป็นรายการตรวจสอบการกู้คืน เป็นวิธีที่ฉันเรียกร้องให้ลงน้ำจริงๆหรือไม่? หรือว่าถูกต้องและฉันควรคำนึงถึงธุรกิจของฉันที่นี่และเขียนรายการตรวจสอบง่ายๆ ความกังวลของฉันคือว่าไม่ว่าคุณจะเขียนรายการตรวจสอบขั้นตอนได้ดีเพียงใดมันไม่ได้แก้ปัญหาที่ต้องใช้ SysAdmin เพื่อคิดสิ่งต่าง ๆ หากคุณใช้เวลาทำรายการตรวจสอบขั้นตอนการกู้คืนซึ่งไม่สามารถแก้ไขปัญหาได้ (เนื่องจากมีปัจจัยเพิ่มเติมที่ไม่ได้เป็นส่วนหนึ่งของเอกสารเนื่องจากจุดเน้นที่แคบของเอกสาร ) …

5
ฉันจะเขียนหน้าคนได้อย่างไร [ปิด]
ปิด คำถามนี้จะต้องมีมากขึ้นมุ่งเน้น ไม่ยอมรับคำตอบในขณะนี้ ปิดให้บริการใน5 ปีที่ผ่านมา ล็อคแล้ว คำถามและคำตอบของคำถามนี้ถูกล็อคเนื่องจากคำถามอยู่นอกหัวข้อ แต่มีความสำคัญทางประวัติศาสตร์ ขณะนี้ไม่ยอมรับคำตอบหรือการโต้ตอบใหม่ ฉันจะเขียนหน้าคนได้อย่างไร ฉันจะหาข้อมูลอ้างอิงของรหัสการจัดรูปแบบทั้งหมดได้จากที่ใด มีแบบฝึกหัดที่ดีในการเขียน man pages หรือไม่? วิธีที่สะดวกที่สุดในการเขียนหน้าคนคืออะไร? ฉันควรป้อนโดยตรงในโปรแกรมแก้ไขข้อความหรือไม่? มีบรรณาธิการ WYSIWYG หรือไม่ หรือฉันควรจะเขียนมันในรูปแบบที่แตกต่างกันแล้วแปลง? หน้าคนดีควรกฎอะไรบ้าง

5
คุณเอกสารการกำหนดค่าเซิร์ฟเวอร์ windows ได้อย่างไร?
ฉันมาจากพื้นหลัง Unix ที่จัดทำเอกสารการกำหนดค่าบริการ (ตัวอย่างเช่นอีเมล) อาจทำได้ง่ายเพียงแค่หยิบไฟล์กำหนดค่าข้อความสองสามตัวและข้อความอธิบายหรือย่อหน้าที่ 2 ต้องเผชิญกับการบันทึกการกำหนดค่าของกล่อง Windows จำนวนมาก (50+) ฉันตกใจที่พบว่ามันยากแค่ไหนที่จะได้รับมุมมองของการกำหนดค่าบริการ ฉันกำลังสร้างเครื่องจักรเหล่านี้ตั้งแต่เริ่มต้นดังนั้นฉันจึงต้องเผชิญกับความต้องการในการกำหนดค่าให้สอดคล้องกับทุกเครื่อง ฉันจะอิมเมจเซิร์ฟเวอร์ทั้งหมดที่ใช้งานจริงโดยใช้ Ghost หรือคล้ายกัน แต่การกำหนดค่าบริการที่แท้จริงเช่น AD หรือ Exchange นั้นเป็นกระบวนการที่ต้องทำด้วยมือและคลิกได้ง่าย ๆ ผู้คนแนะนำให้ฉันสร้างเอกสารประกอบการสร้างที่จะรับรองความสอดคล้องได้อย่างไร และประการที่สองคุณทำเอกสารการกำหนดค่าโดยไม่ต้องหันไปโหลดหน้าจอ ฯลฯ ได้อย่างไร ฉันกำลังพิจารณาที่จะใช้ Camtasia เพื่อดึงวิดีโอของกระบวนการกำหนดค่าซึ่งดูไร้สาระ ขอบคุณสำหรับความช่วยเหลือของคุณ! แก้ไข: คำตอบบางส่วนด้านล่างมีประโยชน์มากและฉันคิดว่าจะช่วยให้ฉันได้ไปยังที่ที่ฉันต้องการ โดยเฉพาะอย่างยิ่งการใช้ไฟล์คำตอบสำหรับการติดตั้งแบบสคริปต์จะช่วยในการสร้างการติดตั้งที่สอดคล้องกันและเครื่องมือ WMI บางอย่างจะมีประโยชน์มากสำหรับเอกสารประกอบ (LANsweeper, SYDisproject เป็นต้น) สิ่งที่ฉันต้องการจริงๆคือมีเครื่องมือที่สามารถแยกการกำหนดค่าทั้งหมดออกเป็นรูปแบบที่มนุษย์สามารถอ่าน / แก้ไขได้และยังดูดมันกลับมาอีกครั้ง โดยทั่วไปแล้ว Unix ได้ทำสิ่งนี้ด้วยไฟล์กำหนดค่าการจัดทำเอกสารด้วยตนเองดังนั้นจึงเป็นเรื่องที่น่าผิดหวังอย่างมากที่จะไม่ต้องมีสิ่งอำนวยความสะดวกเหมือนกันในระบบปฏิบัติการสมัยใหม่ที่ทันสมัย!

4
เอกสารด้านไอทีกับ MediaWiki
เรากำลังมองหาวิธีที่จะปรับปรุงเอกสารของเราและความสามารถของเราในการอนุญาตให้เข้าถึงข้อมูลรวมถึงการแก้ไขข้อมูลได้ง่าย ด้วยความคิดเหล่านี้เราจึงสร้างวิกิภายในขึ้นอยู่กับแพลตฟอร์ม MediaWiki สำหรับ Tier 1 ของเรา (Help Desk) นี่เป็นความสำเร็จที่ยิ่งใหญ่สำหรับฝ่ายช่วยเหลือและพวกเขาใช้สิ่งนี้อย่างกว้างขวางสำหรับการดำเนินงานประจำวัน ตอนนี้เรากำลังมองหาวิธีที่จะบันทึกสิ่งต่าง ๆ สำหรับ Tier 2 ของเรา (ผู้ดูแลระบบ) เราจำเป็นต้องมีข้อมูลสำหรับ Tier 2 แยกจากข้อมูลสำหรับ Tier 1 เนื่องจากความไวของข้อมูลและความจริงที่ว่ามันจะมีขั้นตอนสำหรับวิธีการสร้างเซิร์ฟเวอร์ของเรา ฯลฯ ฉันกำลังมองหาแนวคิดและข้อเสนอแนะที่เกี่ยวข้องกับวิธีที่เราสามารถบรรลุเป้าหมายดังต่อไปนี้: จัดทำเอกสารส่วนกลางจากแพลตฟอร์ม MediaWiki เนื้อหาแยกระหว่างระดับ 1 และชั้น 2 เราชอบรูปลักษณ์และความรู้สึกที่เรามีสำหรับเทียร์ 1 และสามารถใช้ได้กับเทียร์ 2 สิ่งนี้จะสามารถรันบนเซิร์ฟเวอร์เดียวกันได้หรือไม่หากเราต้องทำการติดตั้ง MediaWiki สองแบบที่แตกต่างกัน? นี่เป็นความคิดที่ดีที่จะใช้การติดตั้ง MediaWiki หลายเครื่องบนเครื่องเดียวกันหรือไม่? รองรับใบรับรอง FQDN และ SSL สำหรับการติดตั้งเอกสารแต่ละครั้ง มีวิธีการแบ่งหรือแยกส่วนของการติดตั้ง Tier 1 …

6
ฉันจะบันทึกสิ่งที่มีประโยชน์ที่ควรรู้ในฐานะระบบดูแลระบบของ Mac ได้ที่ไหน
เมื่อเร็ว ๆ นี้ฉันได้ทำการวิจัยเกี่ยวกับเครื่องมือบริการไดเรกทอรีบน Mac (dscl, dsimport, dsexport) และต้องการให้สามารถจัดทำเอกสารไว้ที่ใดที่หนึ่งเพื่อให้ทุกคนได้รับประโยชน์ (และอาจปรับปรุงงานของฉัน) ฉันไม่เห็นประโยชน์ในการวางเว็บไซต์ของตัวเองด้วยเหตุนี้หากมีเว็บไซต์ที่ดีอยู่แล้ว มี Wikis ที่ดี (หรือบางอย่างที่คล้ายกัน) ที่ฉันสามารถจัดทำเอกสารได้ด้วยข้อความและรูปภาพ (screencasts จะเจ๋งเหมือนกัน แต่ฉันไม่นับสถานที่สำหรับสิ่งนั้น) สิ่งที่มีประโยชน์ที่ต้องรู้ในฐานะผู้ดูแลระบบ Mac?

6
เครื่องมือฟรีสำหรับเอกสารดาต้าเซ็นเตอร์ [ปิด]
ปิด. คำถามนี้เป็นคำถามปิดหัวข้อ ไม่ยอมรับคำตอบในขณะนี้ ต้องการปรับปรุงคำถามนี้หรือไม่ อัปเดตคำถามเพื่อให้เป็นไปตามหัวข้อสำหรับข้อบกพร่องของเซิร์ฟเวอร์ ปิดให้บริการใน7 ปีที่ผ่านมา มีเครื่องมือฟรีที่ช่วยให้สามารถจัดทำเอกสารที่ดาต้าเซ็นเตอร์ได้ดีขึ้นหรือไม่สำหรับข้อมูลเช่นเซิร์ฟเวอร์ในชั้นวางกลุ่มพอร์ตที่เชื่อมต่อกับและอื่น ๆ

2
ทุกสิ่งที่ใกล้กับคู่มือ NSA สำหรับการรักษาความปลอดภัย RHEL 6 [ปิด]
ปิด. คำถามนี้เป็นคำถามปิดหัวข้อ ไม่ยอมรับคำตอบในขณะนี้ ต้องการปรับปรุงคำถามนี้หรือไม่ อัปเดตคำถามเพื่อให้เป็นหัวข้อสำหรับข้อบกพร่องของเซิร์ฟเวอร์ ปิดให้บริการใน5 ปีที่ผ่านมา บางคนในกลุ่มโครงสร้างพื้นฐานของเราต้องการอัปเกรดเพื่อเริ่มใช้ประโยชน์จากคุณสมบัติใหม่ใน RHEL 6 ในอดีตฉันอาศัยคู่มือ NSA (www.nsa.gov/ia/_files/os/redhat/rhel5-guide-) i731.pdf) เพื่อรักษาความปลอดภัยการติดตั้ง RHEL 5 และ CentOS 5 ฉันพบว่าคู่มือนี้มีค่า ใครบ้างที่มีประสบการณ์ในการรักษา RHEL / CentOS 6 ในลักษณะที่คล้ายกัน? ถ้าเป็นเช่นนั้นคุณใช้ประโยชน์จากทรัพยากรใด (เป็นลายลักษณ์อักษรหรือที่ปรึกษา)? ฉันได้ยินจากเพื่อนร่วมงานบางคนว่ารุ่น 6 แตกต่างจากรุ่น 5 อย่างมากในหลาย ๆ ทางดังนั้นฉันไม่ต้องการทิ้งช่องโหว่ไว้ในความปลอดภัยของเราเพราะฉันไม่ได้คำนึงถึงความแตกต่างเหล่านั้นอย่างเพียงพอ คู่มือของ Red Hat สำหรับ RHEL 6 ( http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Security_Guide/index.html ) นั้นเพียงพอจริงหรือ มีใครบ้างที่จะบอกว่าถ้าคุณไม่มีเหตุผลการทำงานที่น่าสนใจคุณควรหยุดการอัปเกรดจาก 5 เป็น 6 …

6
วิธีเอกสารการกำหนดค่าเซิร์ฟเวอร์ลินุกซ์?
ฉันมีเซิร์ฟเวอร์ลินุกซ์ประมาณ 20 เครื่องซึ่งฉันต้องการเอกสารการกำหนดค่า ฉันไม่ได้หมายถึงการกำหนดค่าบริการโดยละเอียด แต่เป็นบัญชีผู้ใช้ฐานข้อมูลบัญชีฐานข้อมูลที่อยู่ IP ที่ตั้งทางกายภาพพอร์ต SSH เป็นต้นฉันรู้ว่าข้อมูลทั้งหมดนี้ถูกเก็บไว้ในไฟล์ปรับแต่ง แต่ฉันต้องการรวบรวมทั้งหมด . ฉันกำลังพิจารณาเพียงแค่สร้างสเปรดชีตเพื่อบันทึกข้อมูลนี้ แต่สงสัยว่ามีสิ่งที่ดีกว่า (อาจเป็นแอป php / mysql ขนาดเล็ก) ซึ่งจะมีโครงสร้างและสมบูรณ์กว่าสเปรดชีตที่แฮ็กเข้าด้วยกัน คุณใช้อะไร

4
กำลังมองหาเอกสารที่ดีของไฟล์ odbc.ini และ odbcinst.ini บน Linux
ฉันเห็นข้อมูลบางส่วนข้อมูลเก่า แต่ไม่มีอะไรดีเท่ากับไฟล์ตัวอย่างจริงที่มีความคิดเห็นสั้น ๆ ที่ฉันมีในเครื่อง ฉันต้องการที่จะเข้าใจความสัมพันธ์ระหว่างแน่นอนและodbc.ini odbcinst.iniผิวเผินมันค่อนข้างชัดเจน - ที่ด้านบนของodbc.iniไฟล์มีส่วนดังนี้: [ODBC Data Sources] MYDSN = MyDriverName ... อย่างไรก็ตามฉันไม่แน่ใจว่าสามารถทำได้เช่นมีการตั้งค่าในไดรเวอร์หรือส่วน DSN 1) ฉันมีDriver = /path/to/file/.soทั้งบรรทัดในไฟล์และบางครั้งค่าต่างกัน มันสมเหตุสมผลหรือไม่ ถ้าเป็นเช่นนั้น 2) odbcinst.iniเป็น "ต้นแบบ" แบบ JavaScript odbc.iniหรือเปล่า? กล่าวอีกนัยหนึ่งถ้าฉันสร้าง DSN จำนวนหนึ่งด้วยการตั้งค่าทั่วไปฉันสามารถโปรโมตการตั้งค่าทั่วไปจากodbc.iniภายในได้odbcinst.iniหรือไม่ 3) ความแตกต่างระหว่างDriverและSetupในodbcinst.iniคืออะไร? พวกเขาดูเหมือนจะมีค่าเดียวกัน การตั้งค่าเฉพาะฐานข้อมูลเหล่านี้เป็นสากลหรือ?

4
มาตรฐานอุตสาหกรรมสำหรับการติดฉลากโครงสร้างพื้นฐานเครือข่าย
มีมาตรฐานอุตสาหกรรมใด ๆ ในปัจจุบันเช่น IEEE, ISO, ANSI .... ซึ่งระบุว่าโครงสร้างทางกายภาพของโครงสร้างอาคารควรติดป้ายที่ชั้นวางและแจ็คและวิธีการจัดวางเอกสารหรือไม่? ฉันรู้ว่ามี IEEE Std 200 แต่มันล้าสมัยและฉันพบมาตรฐาน ASME สำหรับอุปกรณ์ไฟฟ้า แต่ฉันไม่สามารถอ่านได้จริง

5
เอกสารสำคัญในเซิร์ฟเวอร์ไดเรกทอรีที่ใช้งานอยู่คืออะไร?
ปลายปีนี้ฉันจะมอบการสนับสนุนเซิร์ฟเวอร์ไดเรกทอรีที่ใช้งานในคริสตจักรของฉันให้คนอื่นและต้องการทราบว่าข้อมูลประเภทใดที่มีความสำคัญต่อเอกสารและการแบ่งปัน มีเอกสารตัวอย่างที่ดีที่ฉันสามารถใช้ได้หรือไม่?
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.