컨설팅 : 고객을위한 사이트 / 환경 문서를 구성 하시겠습니까? [닫은]


12

시간이 지남에 따라 다양한 고객을 대상으로 컨설팅 및 계약 엔지니어링 작업을 수행했습니다. 최근에는 고객이 특정 유형의 문서를 요구하고 있습니다.

  • 설치할 새 네트워크 시간 시계에 사용할 수있는 고정 IP 주소는 무엇입니까?
  • 웹 필터에 제외를 어떻게 넣습니까? CEO는 더 이상 NRA 웹 사이트에 접속할 수 없습니다 !!
  • 정전을 계획하려면 Linux 서버를 종료해야합니다. 명령이 또 뭐야?

이들은 중소 기업이며 일반적으로 전담 기술 직원이 없습니다. 단일 회사 내에서 Wiki / Confluence / Sharepoint 등은 모두 문서 및 환경 정보의 중앙 저장소로 이해가되지만이 정보를 개별 고객에게 제공하는 일관된 방법을 찾는 데 어려움을 겪고 있습니다.

간단한 스프레드 시트 나 오래된 정보로 가득한 끔찍한 바인더 보다 휴대 성이 뛰어나고 안전하며 우아한 프로세스를 촬영하고 있습니다 .

  • 중요한 IP 주소, DHCP 범위 등
  • 네트워크 다이어그램 (필요한 경우)
  • 관리 사용자 이름 및 비밀번호 및 관리 URL
  • 소프트웨어 라이센스 키.
  • 지원 계약 및 보증 정보.
  • 공급 업체 지원 연락처 및 지침.

다른 컨설턴트가 있다는 것을 알고 있습니다. 여러 환경에서 문서를 고객에게 친숙한 형식으로 유지 관리하기위한 제안이나 팁이 있습니까? 어떻게 당신이 그것을 할?

답변:


12

저는 2004 년 6 월부터 3 인 계약 / 컨설팅 서비스의 파트너였습니다. 우리는 주로 자체 "계정"을 사용하지만 파트너 간의 "페일 오버"를 허용하려면 서로에 대한 문서를 유지해야합니다. 대부분의 고객은 일종의 내부 IT 직원을 보유하고 있으며, 그 중 상당수는 일상적인 유지 관리 작업을 수행하며 문서도 효과적으로 전달해야합니다.

저의 두 파트너는 다른 회사에서 저의 직원으로 일했다는 이점이 있습니다 (그러면 전화를 걸 수 있음). 고객 구성 사이의 엄격한 일관성 (물론 분명한 일이 될 수있는)은 신의 선물입니다. 분명히 제품이 변경되므로 새로운 제품 / 버전 등을 논의하고 배포하기 전에 일관된 구성 전략을 결정하도록 caucus에 문의하십시오. 이것은 대기업으로 확장되지는 않지만 솔직히 말하면 버그가 아닌 기능으로 간주됩니다. (저는 직원 "엔지니어"와 일회성, 반 도움이되는 "솔루션"및 고객 간의 불일치에 대한 끔찍한 경향이있는 더 큰 "관리 서비스"회사에 대해 뛰기 시작하지 않습니다 ...> smile <)

나는 "두려운 바인더"에 심하게 반대합니다. 나는 실제 문서가 최신 상태로 유지 본 적이 없어 이제까지 . 나는 실제 문서 사본을 만드는 데 시간을 소비하는 것이 고객의 돈을 낭비한다고 생각합니다. 실행중인 구성에서 "실시간"데이터를 기반으로 문서를 생성하는 방법을 연구하는 데 많은 시간을 할애하고 싶습니다.

예를 들어, 나는 IP 주소 정보의 스프레드 시트를 절대 유지 하지 않을 것 입니다. 이것이 바로 DHCP와 DNS (구체적인 사항은 아래 참조)입니다. 이러한 것들이 작동하지 않으면 우리는 큰 문제가 있습니다.

고객에게 "모든 그룹 정책 구성을 보여주는 문서 만들기"와 같은 요청을했으며 발 뒤꿈치를 파서 거부했습니다. 반복적 인 제안은 지금까지 작동했지만 고객에게 "셀프 서비스"를 제공하거나 소프트웨어를 사용하여 주문형 "실시간"고객 친화적 인 문서를 생성 할 수있는 관리 도구를 소개하는 것이 었습니다.

우리는 평범한 영어로 물건을 철자하는 것에 대해 세심한주의를 기울입니다. 예를 들어 비 기술적 인 IT 담당자는 컴퓨터의 Active Directory 그룹 구성원을 검토하고 "소프트웨어-Microsoft Office 2010 Pro 설치"및 "그룹 정책-배송 키오스크 컴퓨터 자동 로그온"과 같은 항목을 볼 수 있습니다. 그 의미를 설명하는 문서는 필요하지 않습니다.

다음은 우리가 사용하는 "실시간"데이터입니다.

  • 모든 IP 주소 할당은 DHCP 서버에 저장됩니다. 여기에는 정적으로 주소가 지정된 장치도 포함됩니다 (주석에 언급되지 않음). MAC 및 IP 주소는 스크립트 또는 수동으로 쉽게 쿼리 할 수 ​​있으며, 데이터가 프로덕션 환경에서 사용되는 경우 데이터를 최신 상태로 유지해야합니다.

  • 모든 것은 DNS에서 이름과 PTR 레코드를 얻습니다. 대부분의 호스트는 HINFO 레코드도 얻습니다. 자세한 설명이 필요한 것은 TXT 레코드를 얻습니다.

  • Active Directory, 컴퓨터 설명, 공유 폴더 설명 등 "Notes"필드를 적절하고 장황하게 사용합니다. 또한 보안 그룹 이름과 같은 사항도 자세하고 명확합니다.

  • 네트워크 장비 구성에 대한 설명 / 설명 (ACL에 대한 설명, 포트에 대한 설명, SNMP 위치 / 연락처 정보)

텍스트 파일, 위키 등의 자유 형식 정보 저장에 대한 아이디어는 상당히 부정적입니다. 구조화 된 스토리지 메커니즘을 사용할 수있을 때마다 (질문을 내기 위해 소프트웨어를 작성해야하더라도) 그것을 선호합니다. 구성 파일, 데이터베이스 등을 구문 분석 할 수있는 의견은 거의 즉시 만료되는 수동 생성 문서에 대항 할 때 항상 승리합니다.

"자유 형식"정보를 저장해야 할 때 자체 SVN 저장소를 사용합니다. 여기에는 고객이 제출 한 지난 몇 년 동안 작성한 다양한 정적 문서 조각이 모두 포함되어 있습니다. 우리는 2004 년부터이를 위해 SVN을 사용해 왔으며 우리를위한 협업 도구로 매우 효과적이었습니다. 데이터베이스 스키마, sysadmin 스크립트, 그룹 정책 개체 백업 등의 버전을 관리합니다. 버전 제어에 대해 가능한 모든 것을 확인하려고합니다.

파일 시스템 기반 인덱싱 도구를 사용하여 체크 아웃을 쉽게 검색 할 수 있습니다. 본인은 언제든지 현지에서 사용할 수있는 리포지토리 사본을 하나 이상 보유하고 있음을 알고 있습니다. 또한 인증 된 WebDAV를 통해 SSL을 통해 저장소에 액세스 할 수 있도록했습니다. 여기에는 저장된 데이터에 접근해야하고 브라우저 액세스 만 가능한 경우가 있습니다.

우리는 요청을 한 적이 없지만 SVN 서버에서 고객이 자신의 파일을 체크 아웃하고 상호 작용할 수 있도록 계정을 만들게되어 기쁩니다 (내부 리소스가있는 경우) ). 우리는 설명이 필요없는 모든 정적 고객 문서 (소프트웨어 라이센스 문서, 구매 기록 등)를 저장하기 위해 표준화 된 형식을 사용합니다.

SVN 저장소와 함께 이메일도 자체 호스팅합니다. 회사 도메인에서 이메일 수신을 시작한 이후 모든 수신 / 발신 이메일이 보관되었습니다. 파트너에게 참조하기 위해 BSMTP 로그로 사용할 수 있습니다 (개인적으로는 귀중한 것으로 나타났습니다). 상황은 결코 일어나지 않았지만, 직원이 요청한 경우 고객과의 통신 로그를 고객에게 제공하게되어 기쁩니다. 동일한 메시지에서 여러 고객을 참조 할 수 있기 때문에 파트너 간의 내부 커뮤니케이션을 제공하는 것이 더 어려울 수 있습니다. (우리는 아마 그것에 대해 더 좋을 것입니다. 그러나 우리는 그렇지 않았습니다.)

비밀번호는 프로세스에서 중요한 "사마귀"입니다. 각 고객에 대해 개별 "비밀번호 안전"저장소 (고유 조합)를 사용하여 안전 파일을 고객과 공유 할 수 있습니다. 모든 안전한 파일의 마스터 암호는 다른 안전한 파일에 파트너에게만 알려진 조합으로 유지합니다. 이 부분에는 실제로 약간의 작업이 필요합니다. 실제 다중 사용자 암호 저장소 응용 프로그램 (감사 추적 등)을 사용하여 각 고객 호스트에 현장 자격 증명 저장소를 만들고 싶다고 생각하지만 거의 10 년 동안 해변에서 아이디어를 발굴했습니다. .

우리의 시간 추적 기록은 세 심하게 상세하며 고객이 원하는 전자 형식 (ASCII 텍스트 및 PDF)으로 제공됩니다. 고객은 각 청구 가능 이벤트에 대한 시작 / 중지 시간과 수행 된 작업에 대한 자세한 설명을받습니다. 이러한 서비스 노트는 파트너의 고객 사이트에서 발생하는 상황에 대해 최신 정보를 유지할 수있게하므로 내부적으로 매우 가치있는 것으로 간주합니다. 문제가 발생하면이 기록은 수년 동안 우리가 겪었던 모든 이전 문제와 해결책에 대한 지식 기반을 제공합니다. 몇 년 전에 다른 고객의 편지를 잊어 버린 메모를 찾아서 한 고객의 문제를 해결했다고 말하는 것이 부끄럽지 않습니다.


재빨리주의 할 점 : 문서 작성 : 몇 년 전 다른 사람을 위해 일하던 나의 "오래된 직장"에서 회사는 비 지불 고객에 대한 법적 조치를 취했습니다. 우리는 비 지불 고객으로부터의 소송의 비즈니스 엔드에있게되었습니다. 당사의 내부 기록 및 이메일에 따르면, 고객은 법원에 소환되어 기각되었습니다. 그 경험은 당신이 공개하고 싶지 않은 고정 매체에 아무것도 저장하지 않는 것에 대해 많은 것을 가르쳐주었습니다 .

이 고객 및 회사의 다른 "엔지니어"와의 불만에 대해 몇 가지 선택 단어와 문구가 포함 된 이메일을 작성 했습니다. 공개 법정에서 이러한 것들에 대해 검토를 받아야하는 것은 전혀 즐거웠습니다.

현재 비즈니스를 시작했을 때 파트너는 모든 고정 레코드 (이메일, 문자 메시지, 음성 메일, SVN 저장소의 파일, 시간 추적기의 작업 레코드 등)가 항상 "고객 대면"으로 간주 된다는 데 동의했습니다. 그들이 고객의 손에 들어 가려고 의도하지 않은 경우. 이 작업은 어렵고 많은 훈련이 필요하지만 그만한 가치가 있다고 생각합니다. 우리는 확실히 고객들에게 전문성있는 공기를 투영하고 싶어하며 그것을 실천하는 방식입니다. 나는 다시 그 법정에있는 것처럼 당황하지 않을 것입니다.


1
훌륭한 답변입니다. 저는 컨설턴트가 아니며 한 대기업에서만 일하지만 대부분의 일에 동의합니다. DNS, 모니터링, 꼭두각시 등을 채우는 자산 데이터베이스도 좋은 일이 될 수 있지만 사용하지 않는 정보는 저장하지 마십시오. 쓸모없는.
Dennis Kaarsemaker

라이브 보고서를 생성하기 위해 어떤 종류의 소프트웨어를 사용합니까? 물리적 위치, 장애 조치 다이어그램 등과 같은 것은 어떻습니까?
Steve Butler

@SteveButler-약간 해방되면 질문에 대한 수정뿐만 아니라 요청하는 내용을 확장합니다. 그 어느 때보 다도 나보다 적다 ...> smile <
Evan Anderson

2

설명하는 것과 같은 핵심 정보 (네트워크 다이어그램 제외)는 단일 Excel 통합 문서를 사용하고이를 고객 이름으로 네트워크 폴더에 저장합니다. 사람들이이 방법을 좋아하지 않는 이유를 이해할 수는 있지만 사이트, 전자 메일 및 업데이트에 대한 단일 참조 문서이기 때문에 유용합니다.

가장 큰 불만은 버전 제어가 부족하지만 인생을 힘들게하지 않고 잘 작동하는 것을 찾지 못했습니다.

"간단한 스프레드 시트보다 휴대가 쉽고 안전하며 우아한 프로세스를 위해 촬영하고 있습니다":

더 많은 휴대용 : 무슨 500 킬로바이트 스프레드 시트보다 더 이식? 인터넷 연결을 보장 할 수 없기 때문에 클라우드 나 웹 기반을 사용하는 것이 두렵습니다.

보안 :이 솔루션을 사용하면 솔루션을보다 안전하게 만드는 솔루션을 원합니다.

우아함 : 우리는 통합 문서를위한 멋진 템플릿을 만드는 데 시간을 보냈습니다. 내가 말했듯이, 이것은 흩어져있는 정보의 거대한 페이지가 아니라 다중 시트 통합 문서입니다. 대부분의 IT 문서는 표 형식으로 잘 맞으며 스프레드 시트는이를 매우 깔끔하고 단순하게 유지한다고 생각합니다.

빌드 문서를 기록하고 저장하는 방법에 많은 문제가 있지만 실제로 형식이 지정된 스프레드 시트에서 결함을 찾을 수 없습니다. 또한 우리는 일부 대형 IT 서비스 회사와 협력하며 거의 같은 방식으로 일한다고 덧붙입니다. 다시 말하지만, 그것은 훌륭합니다-나는 사이트로 돌아와서 문서를 요청하고 지속 시간 동안 사용할 수있는 단 하나의 깔끔한 스프레드 시트를 얻습니다.


2

그 두려운 바인더의 큰 장점은 다음과 같습니다.

  • 비 기술적 인 고객은이를 이해하고, 현장에 보관하며, 모든 종류의 다른 중요한 서류 작업에 익숙한 것처럼 안전하게 유지할 수 있습니다.
  • 고객이 고객을 대신하여 교체품, 전문적으로 수행해야 할 작업 및 고객으로 착륙했을 때 신속하게 시작하고 참조 할 수있는 경우를 대비하여 고객이 쉽게 인계 할 수 있습니다.
  • 각 사이트 방문의 주요 내용으로 시작되는 간단한 유지 관리 로그는 확실한 내용입니다.
  • 바인더는 또한 BSA 또는 다른 공급 업체가 방문하는 경우 라이센스 코드 및 활성화 키가있는 CD / DVD 및 인증서를 보유합니다.

어떤 디지털 시스템을 사용하더라도 가치있는 일을 할 때마다 바인더를 업데이트하도록 자신을 훈련시키는 한 더 이상 중요하지 않습니다.

그리고 거의 모든 지원을 원격으로 수행하는 경우 바인더는 물론 완전히 쓸모가 없습니다.

Wiki를 쉽게 유지 관리하고, ILO에 대한 하이퍼 링크 및 관리 인터페이스, 원격 데스크톱 및 SSH 로그인을 쉽게 수행 할 수 있기 때문에 Wiki를 사용하는 데 큰 관심을 보였습니다. 자유형은 내가 갖고 싶은 대부분의 정보에 적합합니다.

  • 사이트 설명 : "네트워크 프린터 (OKI 1234 MFP)는 John의 책상 옆에있는 프린터입니다. HP 잉크젯 프린터 모델 0123은 Bobs에 있으며 보스의 사무실에는 전화가 있습니다." 잉크가 부족한 경우 어떤 카트리지를 다시 주문해야합니까? "

  • 각 장치의 페이지, 그림, 유형 및 구성이 이상적이며 목적 등

  • Wiki가 하드 카피 또는 디지털 문서를 생성하여 핸드 오버 및 끔찍한 바인더에 포함시키기위한 적절한 내보내기 모듈이 있습니다.


좋은 지적입니다. 저는 고객의 90 %와 멀리 떨어져 있지만 자주 여행을합니다. 내가 호스팅하는 중앙 위키와 온 프레미스를 제안 하시겠습니까?
ewwhite

위키를 호스팅 할 때 랩탑과 동기화하도록 설정하기가 훨씬 쉬워 지므로 자주 여행 할 때 신중하게 보일 것입니다.
HBruijn

0

나는 Dan이 Excel의 훌륭한 휴대용 솔루션이라는 데 동의하며 걱정이 다소 잘못되었다고 생각하는 보안 부분을 제외하고는 그가 훌륭한 해결책을 제시한다고 생각합니다.

배포하고자하는 방법이 무엇이든, 보안 솔루션 (예 : 암호화 된 이메일, 보안 공유 스토리지 등)이 포함될 수 있습니다. 버전 관리 (예 : 쉐도우 복사본, svn 등)도 마찬가지입니다.

그러나 건설적인 비판과 모든 측면에서 공유 Excel 스프레드 시트의 주요 단점은 동시성 제한이라고 덧붙입니다. 관리자가 두 명 이상인 날에는 편집을 위해 시트를 열 수 있거나 병합해야 할 여러 사본을 저장 한 다음 한 번에 하나를 선택해야합니다 (어떤 데이터가 최신이며 어떤 것이 아닌가?). 그리고 그것은 정말로 고통입니다.

더 나은 솔루션은 엑셀 (또는 원하는 것)을 선택한 작은 데이터베이스에 대한 프론트 엔드로 사용하는 것입니다 (액세스 (휴대 성을 처리하기 위해), MS SQL, MariaDB 등).

본인은 정보를 다른 당사자 (= Excel)에게 전달하는 데 적합 할뿐만 아니라 지속적인 문서화 노력을 유지하는 데 적합한 솔루션으로 이것을 옹호합니다.

요컨대, 소수의 관리자 (더 큰 상점은 말할 것도없고)조차도 문서 데이터 저장을 위해 Excel을 사용하는 부서는 문서가 무척 많다고 생각합니다. 관리자가없는 한 예외는 아직 보지 못했습니다.

그러나 데이터베이스 기반 스토리지를 사용하는 부서는 최신 문서를 엄격하게 유지할 수 있습니다. 그것은 노력의 문제 일뿐입니다. Excel은 장단점이있는 작업 가능한 db-frontend이지만 유일한 옵션은 아닙니다.


이것은 여러 고객과의 상담 상황에 대한 것임을 상기하십시오. 동시성 문제는 없습니다.
ewwhite

0

이것은 당신이 찾고있는 것이 아닐 수도 있지만 여기에 내가하는 일이 있습니다.

Microsoft Office를 사용하여 각 고객에 대한 모든 문서를 만듭니다. Excel (ip 주소 정보, 스위치 포트 매핑, 랙 레이아웃), Word (구성 정보, 송장, SOW 템플릿) 및 Visio (다이어그램)를 사용합니다. Consulting이라는 상위 폴더와 각 클라이언트의 하위 폴더를 사용하여 폴더 계층을 만듭니다. 클라이언트 문서를 생성하거나 업데이트 할 때 문서를 iPhone ( Documents To Go 사용 ), USB 썸 드라이브 및 DropBox 계정 (2 단계 인증 사용)에 동기화합니다 . 그렇게하면 어디에서나 모든 문서에 액세스 할 수 있습니다.

또한 OfficeTime 이라는 프로젝트 관리 /보고 / 인보이스 / 시간 추적 앱을 사용 합니다. iPhone 앱과 함께 제공되는 Windows 앱이 있으므로 사이트에있을 때 iPhone에서 프로젝트 정보, 송장 발행, 근무 시간 등에 액세스하고 집에있을 때 데스크탑과 동기화 할 수 있습니다.


0

이것이 완벽한 솔루션은 아니지만 Device42를 살펴 보십시오 .

수행 할 수있는 작업은 다음과 같습니다. IP 및 장치를 고객과 연결할 수 있습니다. 또한 다양한 고객의 IP 범위가 겹치는 VRF 그룹을 ​​보유 할 수 있습니다.

IP / 디바이스에 대한 세분화 된 권한 (전역 역할 기반 액세스 만)이 없으므로 최종 고객이 직접 액세스 할 수 없습니다. 그러나 장치 및 IP 정보를 사용하여 고객별로 보고서를 작성하고 필요할 때마다 최종 클라이언트로 보낼 수 있습니다.

적어도 중앙 저장소에 모든 정보를 구성 할 수있는 인터페이스가 제공됩니다. 자산 정보, IP 정보, 계약 정보 및 비밀번호를 저장할 수 있습니다.

또한 REST API 호출에서 대부분의 정보를 제공하지만이를 기반으로 개별 고객을 위해 무언가를 연결할 수 있는지 확실하지 않습니다.


그것은 적합하지 않지만 더 큰 환경을위한 흥미로운 자산 관리 플랫폼입니다.
ewwhite

1
동의하십시오. 필요에 따라 적합하지 않습니다. 고객을 기반으로 역할 기반 액세스를 추가하기 위해 기능 요청을 제출했습니다. 클라우드 서비스 제공 업체는 모든 고객 장비 및 IP 주소를 추적하는 데 효과적이지만 고객이 자신의 정보에 직접 액세스 할 수 있도록 포털 액세스를 제공하고자합니다.
Sonu Bansal
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.