Danışmanlık: Müşteriler için site / çevre dokümantasyonu düzenliyor musunuz? [kapalı]


12

Zaman içinde çeşitli müşteriler için danışmanlık ve sözleşme mühendisliği çalışmaları yaptım. Daha yakın zamanlarda, müşteriler belirli türden belgeler talep etmektedir.

  • Yüklediğimiz yeni ağ zaman saati için hangi statik IP adreslerini kullanabilirim?
  • Web filtresine nasıl hariç tutma yaparım? CEO artık NRA web sitesine giremiyor !!
  • Planlı bir elektrik kesintisi için Linux sunucusunu kapatmamız gerekiyor. Komut yine ne?

Bunlar küçük işletmelerdir ve tipik olarak özel teknik personeli yoktur. Tek bir şirkette, Wiki / Confluence / Sharepoint, vb. Belgelerin ve çevre bilgilerinin merkezi bir havuzu olarak anlamlıdır, ancak bu bilgileri ayrık müşterilere ulaştırmak için tutarlı bir yöntem bulmakta zorlanıyorum .

Basit bir e-tablodan veya eski bilgilerle dolu korkunç bağlayıcıdan daha taşınabilir, güvenli ve zarif bir süreç için çekim yapıyorum .

  • Önemli IP adresleri, DHCP kapsamı, vb.
  • Ağ şeması (gerekirse).
  • Yönetici kullanıcı adları ve şifreleri ile yönetim URL'leri.
  • Yazılım lisans anahtarları.
  • Destek sözleşmeleri ve garanti bilgileri.
  • Satıcı destek iletişim bilgileri ve talimatları.

Burada başka danışmanlar olduğunu biliyorum. Müşteri dostu bir formatta birden fazla ortamda dokümantasyon bulundurmaya ilişkin herhangi bir öneriniz veya ipucunuz var mı? Nasıl mı sen bunu?

Yanıtlar:


12

Haziran 2004'ten bu yana üç kişilik bir müteahhitlik / danışmanlık hizmetinde ortak oldum. Her birimiz esas olarak kendi "hesaplarımızı" çalıştırıyoruz, ancak ortaklar arasında "yük devretme" sağlamak için birbirimize ait belgeleri korumamız gerekiyor. Müşterilerimizin çoğunda, birçoğu günlük bakım yapan bir çeşit dahili BT personeli vardır ve bu belgeleri onlara da etkili bir şekilde iletmemiz gerekir.

İki ortağım, başka bir firmada altımda çalışan olarak çalışmanın avantajına sahip (ve bunu söyleyebilirseniz) ve sonuç olarak, her ikisi de benim bir şeyler yapma fikrime aşılandılar. Müşterilerin yapılandırmaları arasındaki katı şeylerin (açıkçası, nerede olabileceği) bir nimettir. Açıkçası, ürünler değişir, bu nedenle yeni ürünleri / sürümleri vb. Tartışmak ve konuşlandırmadan önce tutarlı bir yapılandırma stratejisine karar vermek için çalışıyoruz. Bu büyük bir şirket için ölçeklenmezdi, ama açıkçası bunu bir hatadan ziyade bir özellik olarak görüyorum. (Çalışanları "mühendisleri" ve tek seferlik, yarı değerli "çözümler" ve Müşteriler arasındaki tutarsızlık için korkunç eğilimlerle daha büyük "yönetilen hizmetler" şirketleri hakkında sıralamaya başlamayacağım ...> smile <)

Ben şiddetle "korkulan bağlayıcı" karşı. Ben fiziksel belgeler güncel tutulması görmedim hiç . Bence belgelerin fiziksel kopyalarını oluşturmak için zaman harcamak Müşterinin parasını boşa harcar. Çalışan yapılandırmalardan "canlı" verilere dayalı dokümantasyonun nasıl oluşturulacağı üzerinde çalışmayı tercih ederim.

Bir örnek olarak, kesinlikle olacak değil IP adresi bilgilerinin elektronik tabloları korumak. DHCP ve DNS (ayrıntılar için aşağıya bakın) bunun içindir. Bu şeyler işe yaramıyorsa, büyük sorunlarımız var.

Müşterilerimizin "Tüm Grup İlkesi yapılandırmamızı gösteren bir belge oluştur" gibi şeyler istemiştik ve topuklularımı kazdım ve yapmayı reddettim. Yinelenen karşı teklifim (şu ana kadar çalıştığı gibi), Müşteri'yi kendilerine "self-servis" verebilecek yönetim araçlarına tanıtmak veya talep üzerine "canlı" müşteri dostu belgeler oluşturmak için yazılım kullanmak olmuştur.

Biz düz İngilizce şeyler heceleyerek titiz olmak için çok çalışıyoruz. Teknik olmayan bir BT kişisi, örneğin, bir bilgisayarın Active Directory grup üyeliğini inceleyebilir ve "Yazılım - Microsoft Office 2010 Pro'yu Yükle" ve "Grup İlkesi - Nakliye Kiosk Bilgisayarı Otomatik Oturum Açma" gibi şeyleri görebilir. Bu şeylerin ne anlama geldiğini açıklamak için herhangi bir belge gerekmez.

Kullandığımız bazı "canlı" veriler:

  • Tüm IP adresi tahsisi DHCP sunucularında saklanır - buna statik olarak adreslenmiş cihazlar da dahildir (yorumlarda belirtildiği gibi). MAC ve IP adresleri komut dosyaları veya manuel olarak kolayca sorgulanabilir ve tanım gereği, üretimde kullanılıyorsa verilerin güncel olması gerekir.

  • Her şey DNS'de bir isim ve PTR kaydı alır. Çoğu ev sahibi de HINFO kaydı alır. Ayrıntılı açıklamalar gerektiren şeyler TXT kaydı alır.

  • Mümkün olan her yerde "Notlar" alanlarının bol ve ayrıntılı kullanımı - Active Directory, bilgisayar açıklamaları, paylaşılan klasör açıklamaları, vb.

  • Ağ donanımı yapılandırmalarındaki yorumlar / açıklamalar (ACL'lerle ilgili yorumlar, bağlantı noktalarıyla ilgili açıklamalar, SNMP konumu / iletişim bilgileri, örneğin).

Metin dosyaları, wiki'ler vb. Şeylerde serbest form bilgi depolama fikri konusunda oldukça olumsuz biriyim. Ne zaman benim için çalışmak için yapılandırılmış bir depolama mekanizması olsun (bunu sorgulamak için yazılım yazmak zorunda olsa bile) bunu tercih ederim. Yapılandırma dosyaları, veritabanları, vb.

"Serbest biçimli" bilgileri depolamamız gerektiğinde kendi SVN veri havuzumuzu kullanırız. Müşteri tarafından dosyalanmış yıllar boyunca oluşturduğumuz tüm çeşitli bitleri ve statik belgeleri içerir. 2004'ten beri bunun için SVN kullanıyoruz ve bu bizim için bir işbirliği aracı olarak çok iyi çalıştı. Biz sürüm veritabanı şemaları, sysadmin komut dosyaları, Grup İlkesi nesne yedekleri, vb Ben sürüm kontrolü içine elimden gelen her şeyi kontrol etmeye çalışın.

Kasada dosya sistemi tabanlı dizin oluşturma araçlarıyla arama yapmak çok kolay. Her birimizin, yerel olarak her zaman kullanabileceğimiz deponun en az bir tam kopyasına sahip olduğumuzu biliyorum. Ayrıca, orada depolanan bir veriye kesinlikle ulaşmamız ve yalnızca tarayıcı erişimine sahip olmamız durumunda, depoya SSL üzerinden kimliği doğrulanmış WebDAV aracılığıyla erişilebilir hale getirdik.

Bunu asla yapmamız istenmedi, ancak Müşterinin kendi dosyalarını teslim almasına ve dosyalarıyla etkileşime girmesine izin vermek için SVN sunucusunda bir hesap oluşturmaktan memnuniyet duyarız (eğer çok eğimli bir dahili kaynağa sahiplerse) ). Oldukça açıklayıcı olan tüm statik Müşteri belgelerini (yazılım lisansı belgeleri, satın alma kayıtları, vb.) Saklamak için standart bir format kullanıyoruz.

SVN deposuyla birlikte e-postamızı da kendimiz barındırıyoruz. Şirketin alan adı e-posta almaya başladığından beri gelen / giden tüm e-postalar arşivlendi. Referans için iş ortaklarına BSMTP günlükleri olarak kullanılabilir (ve kişisel olarak, paha biçilmez olduğunu gördüm). Durum hiç ortaya çıkmadı, ancak bir Müşteriye, çalışanlarına herhangi bir yazışma günlüğüne, sormaları halinde herhangi bir yazışma günlüğüne erişim vermekten mutluluk duyacağımızı biliyorum. Ortaklar arasında dahili iletişim sağlamak daha zor olacaktır çünkü aynı mesajda birden fazla Müşteriye referans verebiliriz. (Muhtemelen bu konuda daha iyi olmalıyız ama henüz yapmadık.)

Şifreler sürecimizde önemli bir "siğil" dir. Güvenli dosyanın Müşteri ile paylaşılmasına izin vermek için her Müşteri için ayrı "Parola Güvenli" depolar (benzersiz kombinasyonlarla) kullanıyoruz. Tüm güvenli dosyalar için ana şifreleri, yalnızca iş ortakları tarafından bilinen bir kombinasyonla başka bir güvenli dosyada tutarız. Bu bölüm gerçekten biraz çalışmaya ihtiyaç duyuyor. Her Müşterinin, gerçek bir çok kullanıcılı şifre kasası uygulaması (bir denetim izi vb. İle) kullanarak yerinde bir kimlik bilgisi kasası barındırmasını istiyoruz, ancak bu fikri yaklaşık 10 yıldır sahile indiriyoruz. .

Zaman izleme kayıtlarımız titizlikle ayrıntılıdır ve Müşterilere istedikleri elektronik formatta sunulur (bu noktaya kadar ASCII metni ve PDF'dir). Müşteriler, faturalandırılabilir her bir etkinlik için başlatma / durdurma süreleri ve yapılan işin ayrıntılı bir açıklamasını alır. Bu hizmet notlarının şirket içinde çok değerli olduğunu düşünüyoruz çünkü ortakların Müşteri sitelerinde neler olup bittiğini takip etmemize izin veriyorlar. Bir sorun olması durumunda, bu kayıtlar bize yıllar boyunca karşılaştığımız tüm önceki sorunların ve çözümlerin bilgisine dayalı bir bilgi verir. Yıllar önce başka bir Müşteri için yazmayı unuttuğum notları bularak bir Müşteri için sorunları çözdüğümü söylemekten utanmıyorum.


Hızlı ve tedbirli bir şekilde yeniden: belge üretmek: "Eski işim" de (yıllar önce başka biri için çalışıyorum) şirket ödemesiz bir Müşteriye karşı yasal işlem başlattı. Biz ödenmeyen Müşteri bir karşı-takım iş sonunda olmak sona erdi. Dahili kayıtlarımız ve e-posta adresimiz: Müşterinin mahkemeye mahkum edilmesine ve mahkemeye çıkarılmasına karar vermiştir. Bu deneyim bana , kamuya açıklanmak istemediğiniz sabit bir ortamda hiçbir şey saklamama hakkında çok şey öğretti .

Bu Müşteri ile olan hayal kırıklıkları ve şirketimdeki diğer "mühendisler" ile ilgili bazı (erm) seçim kelimeleri ve cümleleri içeren bazı e-postalar yazmıştım . Açık mahkemede bu konular hakkında çapraz muayene olmak zorunda olduğum bir şey değildi.

Mevcut işimize başladığımızda ortaklarımız, tüm sabit kayıtların (e-posta, kısa mesajlar, sesli posta, SVN deposundaki dosyalar, zaman izleyicideki çalışma kayıtları, vb.) Her zaman "Müşteriye dönük" olarak kabul edileceğini kabul ettiler. eğer asla Müşteri'nin eline geçmeye niyetlenmemişlerse. Bunu yapmak zordu ve çok disiplin gerektiriyor ama bence buna değer. Kesinlikle Müşterilerimize bir profesyonellik havası yansıtmak istiyoruz ve yaşamak bunu yapmanın yoludur. Kesinlikle bir daha o mahkemede olduğum gibi utanmayacağım.


1
Mükemmel cevap. Danışman değilim ve sadece bir büyük şirkette çalışmama rağmen, çoğu şeye katılıyorum. DNS, izleme, kukla vb.Gibi şeyleri dolduran bir varlık veritabanının da iyi bir şey olabileceğini, ancak kullanmadığınız bilgileri saklamayın veya güncelliğini yitireceğini ve Faydasız.
Dennis Kaarsemaker

Bu canlı raporları oluşturmak için ne tür bir yazılım kullanıyorsunuz? Fiziksel konumlar, başarısızlık diyagramları vb.
Steve Butler

@SteveButler - Biraz özgürleştiğimde, sorduğunuz şeyi genişletmenin yanı sıra soruya yönelik düzenlemeyi de ele alacağım. Etrafımda hiç olmadığı kadar az şey var ...> gülümse <
Evan Anderson

2

Tanımladığınız gibi temel bilgiler için (Ağ Diyagramı hariç) tek bir Excel çalışma kitabı kullanıyoruz ve bunu müşterilerin adıyla bir ağ klasörüne kaydediyoruz. İnsanların neden bu yaklaşımı sevmediğini anlayabiliyorum, ancak işe yaradığını görüyorum çünkü bu, yanımda taşıyabileceğim, e-posta gönderebileceğim ve hızlı bir şekilde güncelleyebileceğim tek bir referans belgesi.

En büyük şikayetim sürüm kontrolünün olmaması olurdu, ancak henüz hayatı zorlaştırmadan iyi çalışan bir şey bulamadım.

"Basit bir e-tablodan daha taşınabilir, güvenli ve zarif bir işlem için çekim yapıyorum" a karşı koymak için:

Daha Taşınabilir: 500 Kilobaytlık Elektronik Tablodan daha taşınabilir ne olabilir ? İnternet bağlantısı garanti edilemediğinden bulut veya web tabanlı herhangi bir şey kullanmaktan korkarım.

Güvenli: Size vereceğim ve ben de çözümümüzü daha güvenli hale getirmek için çözümler istiyorum.

Zarif: Çalışma kitabımız için güzel bir şablon oluşturmak için zaman harcadık. Dediğim gibi, bu çok sayfalı bir çalışma kitabı, sadece dağınık bilgilerin büyük bir sayfası değil. BT belgelerinin çoğunun tablo biçiminde güzel bir şekilde uyduğunu düşünüyorum ve bir e-tablo bunu çok düzgün ve basit tutar.

Yapım belgelerini nasıl kaydettiğimiz ve sakladığımızla ilgili birçok sorunum olsa da, sağlam, iyi biçimlendirilmiş bir e-tabloda gerçekten hata bulamıyorum. Ayrıca bazı büyük BT Hizmetleri şirketleriyle çalıştığımızı ve aynı şekilde çalıştıklarını da ekleyeceğim . Yine, parlak - Siteye dönüyorum, belgeleri talep ediyorum ve süre boyunca kullanabileceğim tek bir elektronik tablo alıyorum.


2

Bu korkunç bağlayıcının büyük avantajı:

  • Teknik olmayan müşteriler bunu anlayabilir, sitede tutabilir ve alışkın oldukları gibi güvende tutabilir ve diğer tüm önemli evraklarla zaten yapabilirler.
  • Müşterileriniz, sizin için bir yedek, profesyonel bir şey ve müşteri olarak indiğinizde size hızlı bir başlangıç ​​ve referans verecek bir şey tutmaları durumunda kolayca teslim edebilirler.
  • Başlangıçta her saha ziyaretinin öne çıkan basit bakım günlüğü somut bir şeydir.
  • Bağlayıcı ayrıca BSA veya başka bir satıcının ziyaret etmesi durumunda lisans kodları ve etkinleştirme anahtarları içeren CD / DVD'leri ve sertifikaları da tutar.

Kullandığınız dijital sistem ne olursa olsun, değerli bir şey yaptığınızda bağlayıcıyı güncellemek için kendinizi disipline ettiğiniz sürece artık önemli değildir.

Ve neredeyse tüm desteğinizi uzaktan yaparsanız, elbette sizin için tamamen işe yaramaz.

Bir wiki kullanmanın büyük bir hayranıydım, çünkü kolayca korunur, ILO'ya köprüler ve yönetim arabirimleri, uzak masaüstü ve SSH oturumları kolayca izlenir. Serbest form, sahip olmak isteyeceğim bilgilerin çoğuna uygundur:

  • site açıklaması: "ağ yazıcısı (OKI 1234 MFP) John'un masasının yanındaki yazıcı, HP mürekkep püskürtmeli yazıcı modeli 0123 Bobs'ta oturuyor, patronun ofisi" bir telefon aramasını cevaplamayı çok daha kolaylaştırıyor: " mürekkebin bitmesi durumunda tekrar hangi kartuşu sipariş etmeliyiz? ".

  • Her cihaz için ideal bir resim, tür ve konfigürasyon, amacı vb.

  • Wiki'lerin bu korkunç bağlayıcıya aktarma ve dahil etme için basılı kopya veya dijital belgeler üretmesi için bazı iyi ihracat modülleri var


Güzel nokta. Müşterilerimin% 90'ına uzaktayım, ancak sık sık seyahat ediyorum. Kurum içi bir şeye karşı barındırdığım merkezi bir wiki önerir misiniz?
ewwhite

Wiki'yi barındırdığınızda, sık sık seyahat ettiğinizde ihtiyatlı görünecek şekilde dizüstü bilgisayarınızla senkronize edilecek şekilde ayarlanması çok daha kolay hale gelir.
HBruijn

0

Excel'de Dan'ın iyi, taşınabilir bir çözüm olduğuna katılıyorum ve endişelerin bir şekilde yanlış yönlendirildiğini düşündüğüm güvenlik kısmı dışında bunun için mükemmel bir durum olduğunu düşünüyorum:

Kişinin dağıtmak istediği yöntem ne olursa olsun, güvenli bir çözüm ele alınabilir (örn. Şifreli e-posta, güvenli paylaşılan depolama alanı vb.). Aynı durum sürüm kontrolü için de geçerlidir (örn. Gölge kopyalar, svn vb.).

Bununla birlikte, sadece yapıcı eleştiri yoluyla ve tüm saygıyla, paylaşılan bir Excel elektronik tablosu ile büyük bir dezavantajın eşzamanlılık sınırlamaları olduğunu ekleyebilirim. İki veya daha fazla yöneticiniz olduğu gün, her seferinde yalnızca bir tanesini düzenleme için açabilmek veya daha sonra birleştirilmesi gereken birden fazla kopyaya sahip olmak (bu veriler güncel ve hangisi değil?). Ve bu gerçekten bir acı.

Daha iyi bir çözüm, Access'i (sadece taşınabilirliği ele almak için), MS SQL'i, MariaDB'yi ya da süslemenizi ne olursa olsun, küçük bir veritabanına ön uç olarak Excel'i (veya istediğinizi) kullanmaktır.

Bunu sadece başka bir tarafa bilgi aktarmak için uygun olmayan (= Excel) bir çözüm olarak savunuyorum, aynı zamanda devam eden dokümantasyon çabalarını sürdürmek için de uygun.

Kısacası, sadece birkaç yöneticiyle bile (daha büyük mağazalardan bahsetmemek bile), dokümantasyon veri depolaması için Excel'e güvenen bir departmanın genişleyen bir dokümantasyona sahip bir borç olduğu. Yalnızca bir yönetici olmadığı sürece henüz bir istisna görmedim.

Ancak, veritabanına dayalı depolama kullanan bir borç, sıkı, güncel bir dokümantasyon tutma fırsatına sahiptir. O zaman bu sadece bir çaba meselesidir. Bir Excel artıları ve eksileri ile uygulanabilir bir db-frontend, ama hiçbir şekilde tek seçenek.


Bunun birden fazla müşteriyle bir danışmanlık durumu için olduğunu hatırlayın. Eşzamanlılık sorunu olmayacak.
ewwhite

0

Bu aradığınız şey olmayabilir, ama işte buradayım.

Müşterilerimin her biri için tüm belgeleri oluşturmak için Microsoft Office kullanıyorum. Excel (ip adres bilgileri, anahtar bağlantı noktası eşleme, raf düzeni), Word (yapılandırma bilgileri, faturalar, SOW şablonları) ve Visio (diyagramlar) kullanıyorum. Danışmanlık adlı üst klasör ve her istemci için bir alt klasör ile bir klasör hiyerarşisi oluşturuyorum. İstemci belgeleri oluştururken veya güncellerken bunları iPhone'umla ( Gitmek için Belgeler'i kullanarak ), USB flaş sürücüyü ve DropBox hesabıyla (iki faktörlü kimlik doğrulama kullanarak) senkronize ediyorum . Bu şekilde gittiğim her yerde ve her yerde tüm belgelere (bir şekilde veya başka şekilde) erişebiliyorum.

Ayrıca OfficeTime adlı bir proje yönetimi / raporlama / faturalama / zaman izleme uygulaması da kullanıyorum . Bir iPhone uygulaması ve eşlik eden bir Windows uygulaması var, bu yüzden sitedeyken iPhone'umda proje bilgilerine, faturalandırmaya, çalışma saatlerine vb. Erişebiliyorum ve eve geldiğimde masaüstümle senkronize ediyorum.


0

Bu mükemmel bir çözüm olmasa da, Device42'ye bir göz atmalısınız .

Yapabilecekleriniz: IP'ler ve Cihazlar müşterilerle ilişkilendirilebilir. Ayrıca, çeşitli müşteriler arasında çakışan IP aralıkları için VRF gruplarınız olabilir.

IP'ler / Cihazlar için ayrıntılı bir izni yoktur (yalnızca küresel role dayalı erişim), bu nedenle son müşterilerin doğrudan erişmesine izin veremezsiniz. Ancak, cihaz ve IP bilgileriyle her müşteri için rapor oluşturabilir ve gerektiğinde son istemciye gönderebilirsiniz.

Bu, en azından merkezi bir depodaki tüm bilgileri düzenlemek için bir arayüz sağlayacaktır. Varlık bilgilerini, IP bilgilerini, sözleşme bilgilerini ve şifreleri saklayabilirsiniz.

Ayrıca REST API çağrılarında çoğu bilgi sağlar, ancak bireysel müşterilere bir şey bağlayabileceğinizden emin değildir.


Oldukça uygun değil, daha büyük ortamlar için ilginç bir varlık yönetimi platformu.
ewwhite

1
Katılıyorum, ihtiyaçlarınıza göre mükemmel bir uyum değil. Müşterilere de rol tabanlı erişim eklemek için onlara bir özellik isteği ekledim. Tüm müşteri ekipmanlarını ve IP adreslerini takip etmek bizim için bir bulut servis sağlayıcısı için iyi çalışır, ancak aynı zamanda müşterilere portal bilgilerine erişebilmelerini isteriz, böylece bilgilerine kendileri erişebilirler.
Sonu Bansal
Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.