alfresco for Windows Tomcat Bundle中文安装说明

 

====================
alfresco 1.0 发布
====================

欢迎使用Alfresco 1.0

===================
安装 alfresco
===================

下面是Alfresco的安装向导。

====================================
alfresco Tomcat 捆绑包的安装
====================================

必要条件：
-JDK[http://java.sun.com]
- MySQL数据库[ http://www.mysql.com] (其他的数据库也能够支持)
- alfresco[http://www.alfresco.org]

可选择的条件:
- 用来进行文档转化的OpenOffice[http://www.openoffice.org]

==========================
在Windows XP上安装
==========================

安装 JDK 5.0
---------------

- 如果您已经安装了Development Kit 5.0 ，跳转到“安装MYSQL”

- 访问 http://java.sun.com/j2se/1.5.0/download.jsp
- ≡?quot;JDK 5.0 Update x"
- 下载 "Windows Offline Installation" 版本 (~55M)
- 下载完毕后安装

安装 MySQL
-------------

- 如果您想使用其他的数据库，请访问www.alfresco.org上的论坛和wiki获得指导方案，也可以访问www.alfresco.cn获得中文支持。
- 如果你已经安装了MySQL 4.1，跳转到"Install alfresco"

- 访问： http://dev.mysql.com/downloads/mysql/4.1.html
- 下载 "Windows (x86)" option (~37M)
- 下载完毕后安装(运行 setup.exe)
- 使用Typical 安装模式
- 你也许会到MySQL.com注册
- 为必须的使用配置适当的选项
- 演示，选择默认，选择默认的选项
- 如果使用非英语（non-English）或者非西欧语言（non-West European），选择UTF8字符设置
- 选择MySQL的安装路径
- 测试MYSQL的安装和运行，请在“MySQL Command Line Client”输入：
'mysql -u root -p'
并回车
- 看到提示，输入您安装时输入的密码。如果没有错误提示，MYSQL就安装好并且运行了，输入'quit'退出。

安装Alfresco Tomcat捆绑包
------------------------------

- 访问： http://www.alfresco.org/downloads
- 选择下载 "Alfresco Windows Tomcat Bundle"
-创建一个目录： 'C:/alfresco'
- 解压缩alfresco-tomcat-xxxxx.zip到 C:/alfresco目录中

设置路径
---------

编辑 'alfresco.bat' 检查里面的配置，来设置Tomcat的安装方法：

- 在Tom的绑定包中，这个会是:'C:/alfresco/tomcat'

建立数据库
---------------

访问 'C:/alfresco' 并且运行'db_setup.bat'。

这会建立一个以用户名密码为'alfresco'建立一个名为'alfresco'的数据库。如果数据库建立失败，这也许是因为MySQL服务没有运行或者mysql命令没有被发现。或者你可以把'db_setup.sql'文件里的内容手工载入到
MySQL，例如：'mysql -u root -p <db_setup.sql'。

您现在已经安装了所有运行Alfresco服务器所需要的组件。

可选择的安装：OpenOffice
------------------------------

如果您想要能够利用Alfresco进行文档的转换，您需要安装OpenOffice。这个完全可以在Alfresco安装完毕后选择安装。

- 访问： http://download.openoffice.org
- 下载Windows版本
- 使用默认模式安装OpenOffice（除了 file associations, 除非你想要用到这个)
- 最初出现一个注册画面，然后关闭它
- 在'C:/alfresco'目录下将'zstart_oo.bat'改名为'start_oo.bat'
- 如果Alfresco服务器已经在运行的话，关闭或者重新启动它

===========================
运行Alfresco服务器
===========================

访问'C:/alfresco'文件夹并且运行'alf_start.bat'
- 一个OpenOffice的最小化窗口将开始运行
- 一个Tomcat的控制窗口将打开
- 当控制窗口出现信息：'INFO: Server startup in nnnnn ms', Tomcat就在运行了
- 你现在可以通过访问下列地址测试Alfresco：

http://localhost:8080/alfresco

这个服务器配置可一个用户和密码都是‘admin’的管理员。

测试安装，你也许希望跟随指南，可以从如下地址获得：

http://www.alfresco.org/downloads

===========================
关闭Alfresco服务器
===========================

访问'C:/alfresco'文件夹并且运行'alf_stop.bat'

=====================
使用CIFS服务器
=====================

在Windows平台使用服务器，在'C:/alfresco/bin'目录下的Win32NetBIOS.dll文件需要被复制到操作系统路径，比如：'c:/windows/system32'。
dll文件被粘贴后需要重新启动Alfresco服务器。

当Alfresco服务器运行，CIFS应该能被连接到。映射的命名是基于正在运行着的Alfresco的服务器，使用'_A'结尾。例如，如果PC的名字是'MYPC01' ，那么CIFS的服务器将会是'MYPC01_A'。
去影射驱动器，打开Windows资源管理器，工具栏---选择“映射网络驱动器”。在镜象网络驱动器的过程中选择驱动器并且使用一个你想要的名字。
定位CIFS服务，点击'Browse...'/“浏览..”
点击按扭并查找描述上方的服务器名。你应该选择一个一个叫做“alfresco”的目录。点击“确定/OK”完成驱动器的影射。
您现在应该能够重映射驱动器中访问到Alfresco。如果CIFS名字没有在你浏览的过程中找到，您也可以直接输入目录的路径，例如：'//MYPC01_A/alfresco'。

检查CIFS服务器名及是否在运行，在命令行提示状态下输入： 'nbtstat -n'列出的名字里面应该有一个是CIFS的服务器名。

如果你不能连接CIFS服务器，那么依靠您的网络，你应该配置CIFS使用的域。If you are unable to connect to the CIFS server, then depending on your network, you may need
to configure the domain for CIFS to use. You will need to have started the alfresco server
at least once to be able to do this. 设置域，编辑位于'c:/alfresco/tomcat/webapps/alfresco/WEB-INF/classes/alfresco'目录下的'file-servers.xml'文件并在下面一行添加 ：
<host name="${localname}_A"/>
例如：
<host name="${localname}_A" domain="MYDOMAIN"/>

你将需要重新启动Alfresco服务器。

==================
图象处理
==================

如果想要能够在Windows平台进行图象处理操，需要将 in
'C:/alfresco/bin'目录下的'imconvert.exe'复制到操作系统路径下，比如：'C:/windows/system32'。

================
问题解答
================

如果您对您的安装有一些疑问，请到论坛http://www.alfresco.org/forums查看和询问任何其他的帮助（也可以访问bbs.alfresco.cn获得中文的帮助支持）。

- 在你的java5的安装中，JAVA_HOME环境变量必须被正确地设定

- 大部分的安装问题可以在下面的论坛版块中找到答案：
http://www.alfresco.org/forums/viewtopic.php?t=7

http://www.alfresco.org/forums/viewforum.php?f=8

- WAR的文件名是alfresco.war
注意：在您部署新的WAR文件之前，如果您以前已经部署过war你必要要清除web-client文件，首先要备份所有已经生成的配置文件。
删除<tomcat-home>/webapps/alfresco.war
删除<tomcat-home>/webapps/alfresco <-- make sure any configurations are copied
删除<tomcat-home>/work/alfresco

- 如果在控制台出现下列错误报告：
ERROR [AbstractImageMagickContentTransformer] JMagickContentTransformer not available:
ERROR [AbstractImageMagickContentTransformer] ImageMagickContentTransformer not available:
Failed to execute command: imconvert ...

这是没有发布导致服务器失败。Alfresco服务器报告不同外部文档转换引擎不能被用户使用。
您可以查阅下面地址中的指导说明：
http://www.alfresco.org/mediawiki/index.php/Preview_Release_5
或者完全删除你不需要的转换引擎：
http://www.alfresco.org/forums/viewtopic.php?t=90

- 如果您在服务器启动的时候看到这个错误报告：
ERROR [protocol] FTP Socket error
java.net.BindException: Address already in use: JVM_Bind
at java.net.PlainSocketImpl.socketBind(Native Method)
检查您是否有任何其他服务占用了Alfresco服务和FTP需要用到的8080及21端口。

- 使用FireFox浏览器访问CIFS你需要安装下列地址提供的Alfresco FireFox Extension扩展插件：
http://sourceforge.net/projects/alfresco

使用Internet Explorer浏览器不需要扩展插件直接打开CIFS目录。