常见问题与回答（FAQ）

一般问题

• openCRX是否是一个真正开源的项目?
• 我如何支持openCRX的开发
• openCRX 开发计划是什么?
• openCRX项目的目标是什么?
• openCRX 的开发团队规模如何?
• 在研究openMDX之前，哪里有 Model Driven Architecture (MDA) 的资料?

下载与源码资源库

• 哪里可以 下载 openCRX 发布包?
• openCRX CVS repository在哪里?

协同工作的特性

• 哪些 CalDAV 客户端 可以用于连接openCRX?

技术问题

• 论坛中的FAQ帖子
• 我需要看 README吗?在哪里?
• 我应该/能够使用哪些 DB?
• 运行openCRX需要 应用服务器吗?
• 运行openCRX的硬件配置是什么?
• 如何 优化openCRX的性能?
• 我可以使用哪些 AppServer?
• openCRX/openMDX/JDK/AppServer 的版本兼容性如何?
• 我可以使用哪些浏览器?
• 如何从前面的版本 升级 openCRX?
• 如何添加 其它的语言?
• 如何加载一个 特定语言的登录页面?

openCRX是否是一个真正开源的项目?

答案是 yes。 openCRX一直都使用 OSI 认证的 BSD-style license 来发布。我们没有任何隐藏，也没有任何私有代码。

另外，不要低估了这个问题的重要性。许多CRM 程序声称是开源而实际上不是那样。阅读OSI的 博客Will The Real Open Source CRM Please Stand Up? 就明白了。

^top

我如何支持openCRX的开发?

更多精英的参与是 openCRX 团队的愿望. 假如你愿意参与或者合作请浏览 我们的社区. 感谢任何形式的支持．

你想通过赞助来支持openCRX 的开发，你可以联系我们

^top

openCRX 开发计划是什么?

当前的开发计划在 这里.

^top

openCRX项目的目标是什么?

把openCRX 打造成CRM和ERP的 核心参考模型。

^top

openCRX 的开发团队规模如何?

核心团队有3个人 (尽管因为和openMDX团队的紧密合作，我们可以算作4个人openMDX team)。请不要跳到类似"太小，没有实力等等"的结论上，这说明你还不了解MDA (Model Driven Architecture)。对于生产力的影响，它可能是10倍的提高。 而且，也要考虑我们无需付出同步几百个开发人员的额外消耗。

除了核心团队还有许多翻译者(参看 有效的本地语言列表)以及几十位参与者提供了改进openCRX的重要工作。

^top

在研究openMDX之前，哪里有 Model Driven Architecture (MDA) 的资料?

There is a lot of material available at OMG's MDA site. If you just want to get a quick overview, try An introduction to Model Driven Architecture by Allan Brown and Jim Conallen:

• An introduction to Model Driven Architecture (Part I)
• An introduction to Model Driven Architecture (Part II)
• An introduction to Model Driven Architecture (Part III)

You might also want to read the openMDX Introduction available from the openMDX website.

^top

哪里可以下载 openCRX 发布包?

openCRX 发布包可以从Sourceforge下载

^top

openCRX CVS repository在哪里?

This project's CVS repository can be checked out through anonymous (pserver) CVS with the following instruction set. The CVS tree is publicly accessible for anonymous read-only access, approved contributors will also be given commit access to appropriate packages. When prompted for a password for anoncvs, enter anoncvs.

Linux / Unix / BSD	Windows
CVSROOT=:pserver;username=anoncvs;password=anoncvs:cvs.opencrx.org:/CVSROOT export CVSROOT cvs login    # enter anoncvs when prompted for a password cvs checkout opencrx	TortoiseCVS Settings

^top

哪些 CalDAV 客户端 可以用于连接openCRX?

Please note that you're preferred client might still work with openCRX, even if it is not listed below.

• Mozilla's Sunbird and Mozilla's Lightning, the calendaring add-on for Mozilla's Thunderbird, are not only the best-tested cross-platform CalDAV clients, they also work flawlessly with openCRX. We tested Sunbird 0.7pre and Lightning 0.5 (with Thunderbird 2.0). These CalDAV clients work very well in a setting where you're always online (i.e. connected with the openCRX server) as changes to remote calendars are submitted immediately. Neither Sunbird nor Lightning are well suited for working offline.
• Chandler Desktop by OSAF (Open Source Applications Foundation) works very well with openCRX in both online and offline settings. We tested Chandler 0.7.0.1.
• Mulberry kind of works - seems a bit sluggish, though.

We have not been able to get OpenConnector's CalDAV feature to work properly with Outlook and openCRX, but based on the information published on the project's website (www.openconnector.org) you will probably have to wait for a later version of hope for Microsoft to get their act together and add CalDAV support to Outlook (apparently, Microsoft joined CalConnect on 15 August 2007).

Additional information about CalDAV is available from http://www.caldav.org/ or read what Wikipedia is saying about CalDAV.

^top

我需要看 README吗?在哪里?

是的，你必须阅读README 因为它包括了重要信息(例如，如何构建运行时包). openCRX README 在发布包 的目录core.

^top

我应该/能够使用哪些 DB?

能够使用的数据库很容易回答: openCRX v1.11 已经通过以下数据库的测试

	MySQL (v5.0 or newer) [不建议在生产环境中使用，除非你自己很擅长优化MySQL]
	PostgreSQL (v8.0 or newer)
	MS SQL (both MS SQL 2000 and MS SQL 2005)
	Oracle (v9 or newer)
	DB2 (v9.1 or newer)
	MaxDB (formerly SAP DB) [not supported]
	Firebird [not supported]

应该使用的数据库就比较难说了，因为不了解你的需求和条件限制。以下表格可能有助于你做出决策，答案归结于以下三个问题:

• 你需要多高的性能，有关并发用户、数据库大小等等?
• 你在数据库上有多少预算(只对于非开源数据库有意义，例如Oracle)
• 如果你已经给openCRX使用了一个数据库，为什么要换另外一个?

有关免费 数据库: 由于来自开源数据库的压力，多个商业数据库厂商提供了免费版本。然而在你下结论前，看看产品说明还是很有意义的。理解限制、条件和版权，才能避免意外的束缚于某个产品(例如: 任何对于数据库大小有限制的免费产品迟早会妨碍到你的使用和业务，openCRX一定会添加数据 - 4GB 可能听起来不少，但是一旦你添加10万个联系人和20万份订单，可能就会遭遇到那种限制...)。免费数据库中最高性能的是DB2 Express-C.

* 请注意我们不建议在生产环境中使用MySQL 。 缺少游标支持导致了对于大数据量大情形许多表的扫描性能低下。MySQL v5.x 也许解决了一部分问题。如果你是个很有经验的MySQL DBA，那么可以优化一番它的执行效率

请注意上面表格中的“限制”并不是硬性的数值，但是它们是基于我们的经验以及用户期望的响应时间的假定。

openCRX 包括了所有需要的配置、部署文件，MySQL, PostgreSQL, MS SQL, DB2, 和 Oracle.

^top

运行openCRX需要 应用服务器吗?

openCRX 需要一个应用服务器。然而以后的某个版本你可以部署servlet 到Tomcat而openCRX 后端部署在openMDX LightweightContainer。这种情况适用于小型安装环境，例如开发、测试或者单用户环境(例如，一台笔记本)。对于其他部署环境一个应用服务器 是必需的。

^top

我可以使用哪些 AppServer?

任何兼容J2EE的AppServer 都可以。openCRX 已经通过JBoss, BEA Weblogic, IBM WebSphere,和Sun Java System Application Server的测试。openCRX 的发布包已经包括了以下应用服务器所有必需的配置、部署文件

• JBoss
• BEA Weblogic
• IBM WebSphere
• Sun Java System Application Server

安装指南也是有效的。

openCRX 可以部署在JOnAS纯属谣言。

^top

运行openCRX的硬件配置是什么?

openCRX是企业级的J2EE 应用，如果你把它装在老古董PIII-500 和128MB 内存的机器上，那就很不妙。以下信息可以帮助你得到一个粗略的需求评估:

* 并发用户 意思是同时向服务器发出请求的用户 - 在一般情况下一个并发用户相当于3 到 5 个典型的用户。

一个提供合理负载的环境可以考虑使用多层部署，设置集群可以承受更重的负载；集群也可以提高有效性和提供容错机制。下面的图显示了一个集群的4层部署环境，可以提供成千上万的并发用户的使用：

^top

如何优化openCRX的性能?

如果openCRX没有达到预期的性能，下面的列表可以提供一个合适的改进方向:

• 确定你已经使用了足够的硬件 (详情请看硬件需求)
• 使用合适的数据库
• 检查你的部署环境 - 一个独立的服务器(2 x 3GHz CPU, 6GB RAM) 典型的可以处理大约50个用户, 你应该考虑多层部署 (集群) 来分散系统负载
• 优化数据库 - 默认的openCRX 会包括以下索引，你需要一个熟练的DBA来小心检查数据库性能; 当你了解了用户的负载模式，你的DBA可以确保得到最大的性能优化; 另外，Oracle 和DB2 的性能超过了任何开源的数据库(也包括了大多数其他商业数据库)好几倍(如果你看了执行计划就会了解为什么...)
• 优化应用服务器 - 对于任何J2EE 应用，应用服务器的优化有很多资料。例如有关JBoss 的优化，你可以参考JBossASTuningSlimming。加速你的Tomcat 也不错，参考Apache Portable Runtime 对于加速SSL有一定用处)
• 优化Java VM - 对于任何J2EE 应用，有很多资料优化 Java VM (内存大小设置，垃圾回收等等)。根据你的平台，可以比较不同虚拟机的性能(e.g. BEA JRockit 和 Sun Java VM)
• 在任何多核机器中(真正多核或超线程)你应该验证Java VM 和DBMS 实际使用了多个 CPU; 我们碰到过许多花了大价钱来配置高性能多核服务器的客户，他们实际上只使用了一个CPU来工作... (例如，在Redhat 上Java VM 只有在你安装了compat-libstdc++-3.2-1.i386.rpm后，才会使用多个CPU)
• 确定你的servlet container / application server 发生压缩(zipped) 的页面到浏览器; 例如JBoss, 添加、设置Tomcat 选项compression="on" 在文件server.xml 中(详细参考Apache Jakarta Project的http connector reference page) -压缩的页面比未压缩的要小10倍以上，因此可以减少你的网络负载以及提高用户连接openCRX 服务器占用更少带宽的体验
• 打开gzip 压缩过滤器以及缓存header 过滤器，在web.xml 中(依赖于发布包，一些过滤器是注释掉的)。

应用性能优化是很花时间的(因此也是昂贵的) 任务，因为它包含了数倍的时间来进行相关组件的详细分析(以及深入理解); 例如，每个DBMS 有不同的特点在你真正需要处理和使用的数据库上，例如，仅做一般的高层数据库调优是不够的。当我们有条件投入资源来进行持续基础的优化应用的时候，毫无疑问可以做更多的工作。我们感谢任何有关增强性能的建议。

^top

openCRX/openMDX/JDK/AppServer 的版本兼容性如何?

openCRX 的版本决定了要使用哪一个openMDX 版本。取决于你选择的JDK版本，来选择openCRX 和openMDX对应JDK版本的发布包。

^top

我可以使用哪些浏览器?

如果你有最新的兼容标准的浏览器那就足够了。我们开发并测试了以下Windows XP上的浏览器:

• IE 6.0 SP1+, IE 7.0 (需要 openCRX v1.9.1+)
• Opera 9.10+
• Mozilla 1.7.3+
• Firefox 1.5+, Firefox 2.0+

下面的浏览器根据用户的反馈也是可以工作的:

• Konqueror 3.3+ (有次要的界面生成问题)

如果你发现有页面提交问题，可能需要升级你的浏览器。如果你发现有HTML 代码或者Javascripts 问题，我们会很感谢你能够发到bug forum。

^top

如何从前面的版本 升级 openCRX?

We identify an openCRX version with 3 numbers x, y, and z (i.e. openCRX x.y.z). x.y.z is the Implementation Version, x.y is the corresponding Specification Version. The meaning of individual numbers is listed in the table below:

What follows are detailed instructions for upgrading openCRX from v1.9.1 to v1.10.0 (upgrade instructions for earlier releases can be found here):

Upgrading from openCRX v1.10.0 to openCRX v1.11.0

It is worthwhile checking out the relevant guides published for openCRX v1.11.0 - many guides have been updated / extended.

• stop the application server
• backup your database
• upgrade your database as follows:
  • drop all (openCRX) views
  • execute the script upgrade-from-1.10.0-to-1.11.0.sql
  • execute the script migrate-from-1.10.0-to-1.11.0.sql
  • execute the script drop-from-1.10.0-to-1.11.0.sql
  • create a new database (e.g. CRX2_CRX) and execute the script dbcreate-tables.sql
  • run ant ... CopyDb
    you can run the command without parameters to view help/usage information; the following table contains some example calls with parameters (but you must adapt these to your specific environment!). Please also note that the command must be entered as a single line without any line breaks (the example commands are multiline for easier readability):
    

    DBMS	Example call of ant ... convert
    DB2	ant -Dformat.source=openmdx1 -Dformat.target=openmdx2 -Ddb.jdbc.driver.classpath="..\opt\ibm\jre-1.5\db2-9\lib\db2jcc.jar;..\opt\ibm\jre-1.5\db2-9\lib\db2jcc_license_cu.jar" -Ddb.jdbc.url.source="jdbc:db2://localhost:50000/CRX_SOURCE" -Ddb.jdbc.driver.source="com.ibm.db2.jcc.DB2Driver" -Ddb.username.source="system" -Ddb.password.source="manager" -Ddb.jdbc.url.target="jdbc:db2://localhost:50000/CRX_TARGET" -Ddb.jdbc.driver.target="com.ibm.db2.jcc.DB2Driver" -Ddb.username.target="system" -Ddb.password.target="manager" CopyDb
    MSSQL	ant -Dformat.source=openmdx1 -Dformat.target=openmdx2 -Ddb.jdbc.driver.classpath="..\opt\microsoft\jre-1.5\sql-server-2005\lib\sqljdbc.jar" -Ddb.jdbc.url.source="jdbc:sqlserver://localhost:1433;databaseName=CRX_SOURCE;selectMethod=cursor" -Ddb.jdbc.driver.source="com.microsoft.sqlserver.jdbc.SQLServerDriver" -Ddb.username.source="system" -Ddb.password.source="manager" -Ddb.jdbc.url.target="jdbc:sqlserver://localhost:1433;databaseName=CRX_TARGET;selectMethod=cursor" -Ddb.jdbc.driver.target="com.microsoft.sqlserver.jdbc.SQLServerDriver" -Ddb.username.target="system" -Ddb.password.target="manager" CopyDb
    MySQL	ant -Dformat.source=openmdx1 -Dformat.target=openmdx2 -Ddb.jdbc.driver.classpath="..\opt\mysql\jre-1.5\mysql-5\lib\mysql-connector-java-3.1.12-bin.jar" -Ddb.jdbc.url.source=""jdbc:mysql://localhost:3306/CRX_SOURCE" -Ddb.jdbc.driver.source="com.mysql.jdbc.Driver" -Ddb.username.source="system" -Ddb.password.source="manager" -Ddb.jdbc.url.target="jdbc:mysql://localhost:3306/CRX_TARGET" -Ddb.jdbc.driver.target="com.mysql.jdbc.Driver" -Ddb.username.target="system" -Ddb.password.target="manager" CopyDb
    Oracle	ant -Dformat.source=openmdx1 -Dformat.target=openmdx2 -Ddb.jdbc.driver.classpath="..\opt\oracle\jre-1.5\oracle-10\lib\ojdbc14.jar" -Ddb.jdbc.url.source="dbc:oracle:thin:@localhost:1521:XE" -Ddb.jdbc.driver.source="oracle.jdbc.driver.OracleDriver" -Ddb.username.source="CRX_SOURCE" -Ddb.password.source="manager" -Ddb.jdbc.url.target="jdbc:oracle:thin:@localhost:1521:XE" -Ddb.jdbc.driver.target="oracle.jdbc.driver.OracleDriver" -Ddb.username.target="CRX_TARGET" -Ddb.password.target="manager" CopyDb
    PostgreSQL	ant -Dformat.source=openmdx1 -Dformat.target=openmdx2 -Ddb.jdbc.driver.classpath="..\opt\postgresql\jre-1.5\postgresql-8\lib\postgresql-8.1-407.jdbc3.jar" -Ddb.jdbc.url.source="jdbc:postgresql://localhost/CRX_SOURCE" -Ddb.jdbc.driver.source="org.postgresql.Driver" -Ddb.username.source="system" -Ddb.password.source="manager" -Ddb.jdbc.url.target="jdbc:postgresql://localhost/CRX_TARGET" -Ddb.jdbc.driver.target="org.postgresql.Driver" -Ddb.username.target="system" -Ddb.password.target="manager" CopyDb

    Important: ant ... DbCopy must complete without errors!
    If there are errors the problematic statement(s) will be displayed so that you can try to fix the problem(s) manually.
    Hint: you can safely ignore errors regarding the tables security_AUTHENTICATIONCONTEXT_N and security_SEGMENT_N
    For production data it is advisable to keep track of all the problems that need fixing until the copy task completes successfully;
    Apply all those fixes to the original DB and then run ant ... DbCopy so that it completes without errors.
  • on the new database, run ant ... update-size-columns-1_11_0
    to bring the new columns into a consistent state; you can run the command without parameters to view help/usage information; the following table contains some example calls with parameters (but you must adapt these to your specific environment!). Please also note that the command must be entered as a single line without any line breaks (the example commands are multiline for easier readability):
    

    DBMS	Example call of ant ... convert
    DB2	ant -Ddb.jdbc.url="jdbc:db2://localhost:50000/CRX_TARGET" -Ddb.jdbc.driver="com.ibm.db2.jcc.DB2Driver" -Ddb.jdbc.driver.classpath="..\opt\ibm\jre-1.5\db2-9\db2jcc.jar;..\jre-1.5\db2-9\db2jcc_license_cu.jar" -Ddb.username="system" -Ddb.password="manager" update-size-columns-1_11_0
    MSSQL	ant -Ddb.jdbc.url="jdbc:sqlserver://localhost:1433;databaseName=CRX_TARGET" -Ddb.jdbc.driver="com.microsoft.sqlserver.jdbc.SQLServerDriver" -Ddb.jdbc.driver.classpath="..\opt\microsoft\jre-1.5\sql-server-2005\lib\sqljdbc.jar" -Ddb.username="system" -Ddb.password="manager" update-size-columns-1_11_0
    MySQL	ant -Ddb.jdbc.url="jdbc:mysql://localhost:3306/CRX_TARGET" -Ddb.jdbc.driver="com.mysql.jdbc.Driver" -Ddb.jdbc.driver.classpath="..\opt\mysql\jre-1.5\mysql-5\lib\mysql-connector-java-3.1.12-bin.jar" -Ddb.username="system" -Ddb.password="manager" update-size-columns-1_11_0
    Oracle	ant -Ddb.jdbc.url="jdbc:oracle:thin:@localhost:1521:XE" -Ddb.jdbc.driver="oracle.jdbc.driver.OracleDriver" -Ddb.jdbc.driver.classpath="..\opt\oracle\jre-1.5\oracle-10\lib\ojdbc14.jar" -Ddb.username="CRX_TARGET" -Ddb.password="manager" update-size-columns-1_11_0
    PostgreSQL	ant -Ddb.jdbc.url="jdbc:postgresql://localhost/CRX_TARGET" -Ddb.jdbc.driver="org.postgresql.Driver" -Ddb.jdbc.driver.classpath="..\opt\postgresql\jre-1.5\postgresql-8\lib\postgresql-8.1-409.jdbc3.jar" -Ddb.username="system" -Ddb.password="manager" update-size-columns-1_11_0

    Important: ant ... update-size-columns-1_11_0 must complete without errors!
    If there are errors the problematic statement(s) will be displayed so that you can try to fix the problem(s) manually.
    For production data it is advisable to keep track of all the problems that need fixing until the update task completes successfully.
  • on the new database, execute the script dbcreate-views.sql
  • on the new database, execute the script dbcreate-indexes.sql
  • on the new database, execute the script populate-preferences.sql
• build the runtime binaries (EARs) following instructions in the QuickStart Guide or in opencrx/core/README
• deploy the file opencrx-core-CRX-App.ear  to your application server following the respective guide
• deploy the file opencrx-core-CRX-Web.ear  to your application server following the respective guide
• as mentioned in the README, update the openMDX library openmdx-kernel.jar on your application server following the respective guide
• if you configured DB-based authentication you must adapt the select statements to reflect the new DB structure
  (see for example JBoss Installation Guide)
• delete all temporary files (e.g. on JBoss remove everything contained in the directories .../jboss-4.2.1.GA/server/default/tmp and .../jboss-4.2.1.GA/server/default/work)
• start your application server

^top

如何添加 其它的语言?

The openCRX Language Localization Guide explains in detail how you can add new languages to openCRX or even make your own openCRX language pack. From a technical point of view, adding languages is a trivial issue; the big task is translating all the code tables, labels and tool tips.

The following languages are currently available or being worked on:

If you want to contribute and are ready to translate a bunch of strings into a new language, .

^top

如何加载一个 特定语言的登录页面?

If a login page supports locale xx_YY you can request the login page in that locale xx_YY by appending the string "?locale=xx_YY" to the default login URL.Example: the URL http://demo.opencrx.org/opencrx-core-CRX/Login?locale=de_CH directly loads the German login page.

^top