系统说明书 文章模板

系统说明标题

-- Jerry Marx [DateTime(2004-09-06T01:45:07Z)] TableOfContents

040916 讨论

• 讨论内容已经由Xie yanbo发到mail list
• Xie yanbo正式出任unit test子项目负责人
• Xie yanbo向HD提出17个关于compass的问题,期待HD在maillist回答.

040915 讨论

• 放空！中午 Jerry 没有出现在MSN 或是大家都直接UC 了！？？！
  • Zoomq 当前整理时没有收到昨天录音的信息，今天……
• ["WCstory"] -- Woodpecker.Compass 用户故事！

  • 嗬嗬嗬！缩写的确是 W.C 实在！！！ 又有重名的事儿！还是赶紧想法子哪！

040914 讨论

• am HD在线从MSN 移动到UC 中进行详细讲解

  • [http://220.248.2.35:7080/share/Python/Compass/discuss/20040914am-uc.txt UC文本记录]

  • 录音整理后发布

Zoom.Quiet

重新整理类设计关系图

• 正常事务流程
  • attachment:compass0914.gif

  • [http://wiki.woodpecker.org.cn/moin.cgi/Compass_2fCompassDiscuss?action=AttachFile&do=view&target=compass0914.png 全图观看]

  • [http://wiki.woodpecker.org.cn/moin.cgi/Compass_2fCompassDiscuss?action=AttachFile&do=view&target=compass0914.dot.txt Dot脚本源代码]

• 管理事务流程
  • attachment:compassadmin.gif

  • [http://wiki.woodpecker.org.cn/moin.cgi/Compass_2fCompassDiscuss?action=AttachFile&do=view&target=compassadmin.png 全图观看]

  • [http://wiki.woodpecker.org.cn/moin.cgi/Compass_2fCompassDiscuss?action=AttachFile&do=view&target=compassadmin.dot.txt Dot脚本源代码]

040913 讨论

• [http://220.248.2.35:7080/share/Python/Compass/discuss/CompassDis090413am.xml MSN 讨论文本记录]

Zoom.Quiet

总结UML图和讨论为Compass调用结构关系图

• attachment:compass.gif

  • [http://wiki.woodpecker.org.cn/moin.cgi/Compass_2fCompassDiscuss?action=AttachFile&do=view&target=compass.png 全图观看]

  • [http://wiki.woodpecker.org.cn/moin.cgi/Compass_2fCompassDiscuss?action=AttachFile&do=view&target=compass.dot.txt dot 脚本源代码]

Xie yanbo 9月13日

“compass的server会以守护进程的方式运行在中心服务器上,当然实际 系统分布为了避免单点故障问题不会只有一台中心服务器,但是服务器的 冗余是放在四层或者七层交换的后面,对于我们开发人员来说是透明的, 所以在开发者的角度看我们只需要处理一个中心服器.

“compass的client会以守护进程的方式运行在运行网络服务的的各台 服务器上.为服务提供一个API使得服务可以注册/注销自己或者查询需要 的其他服务器,然后由compass client和compass server交互.”

我想这里的 Server、Client 的概念已经和我们平常所熟知的概念很不 一样了，根据 Twisted 编程规范之命名原则：

• http://wiki.woodpecker.org.cn/moin.cgi/PyTwisted_2fWorkingOnTheTwistedCodeBase_2fCodingStandard#head-3e7742fb7e942241fed7eda5389fc5c736d411b9

我们应该给 Compass Server 和 Compass Client 重新起名。按照我的 理解，建议如下命名：

• Compass Server => Service.Dispatcher 调度员服务

  Compass Client => Service.Agent 中介者服务

Jerry Marx 9月6日

由于我自己机器的问题,我一直不能在UC上发言.我有一些想法我就发在列表里面了,免得集中起来的时候浪费大家的时间

第一个要通报的消息就是compass(指南针)这个项目要启动了.项目的主页在这里: http://wiki.woodpecker.org.cn/moin.cgi/Compass

当然目前还处在前期的准备工作阶段. 目前的工作我想主要有以下几个:

1. Twisted相关文档的翻译和学习.
   • 其中优先级最高的是以下几章: Tutorial(这部分翻译工作已经完成)

     http://wiki.woodpecker.org.cn/moin.cgi/TwistedTUT

     Low-Level Networking and Event Loop(这部分翻译快要完成,由Jerry [email protected] 负责) http://wiki.woodpecker.org.cn/moin.cgi/PyTwisted_2fLowLevelNetworkingEventLoop

     High-Level Twisted(这部分由令狐虫 [email protected] 负责) http://wiki.woodpecker.org.cn/moin.cgi/PyTwisted_2fHighLevelTwisted

     Working on the Twisted Code Base(这部分由BigBaboo [email protected] 负责) http://wiki.woodpecker.org.cn/moin.cgi/PyTwisted_2fWorkingOnTheTwistedCodeBase

     Utilities(这部分由Jerry [email protected] 负责) 当然欢迎大家参与,为了避免重复劳动,参与翻译的时候可以先和相关负责人联系.

     Twisted的原文在安装了Twisted后就可以在本地浏览 开始 -> 程序 -> Twisted -> manual 或者在这个地址: http://twistedmatrix.com/documents/current/howto/

2. 对于Outter的学习
   • compass是基于Twisted的网络应用,当然要用到Outter.基本框架应该就是用Outter来生成了. 这方面还需要Outter组的大力支持
3. 对于compass的理解和认识
   • 这个就不多说了.开发人员必须对于系统的理解达成一致以后才能协调开发.这方面还需要多交流.

我先说说我对于compass的认识吧

1. 首先compass的第一个目标就是为OpenUSS服务,提供服务注册/查找/注销/依赖关系...等等的支持.
2. compass系统是一个分布式的,由一系列运行在各个服务器上的守护进程组成.其中包括一个中心的server和一系列的client.server和client的交互回采用推/拉两种方式,力图使网络负载最小化.
3. compass的server会以守护进程的方式运行在中心服务器上,当然实际系统分布为了避免单点故障问题不会只有一台中心服务器,但是服务器的冗余是放在四层或者七层交换的后面,对于我们开发人员来说是透明的,所以在开发者的角度看我们只需要处理一个中心服务器.
4. compass的client会以守护进程的方式运行在运行网络服务的的各台服务器上.为服务提供一个API使得服务可以注册/注销自己或者查询需要的其他服务器,然后由compass client和compass server交互.
5. 服务数据库当然是由server来维护,但是为了避免server负载过重,也许只会把server设计为一个路过者而将具体的数据库管理再委托给另外的进程(也许运行在另一台机器上),不过这个对于client来说是透明的. 上面只是我自己的一点很粗浅的认识,希望大家指正.