Alfresco for Linux Tomcat Bundle中文安装说明

 

 

欢迎使用Alfresco 1.1.2

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

下面是Alfresco的安装向导。

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

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

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

============================
在 Linux 上安装
============================

所有这些指导假定使用LINUX终端命令行。如果您不是用管理员登陆的话，也许需要在命令前加前缀'sudo'。

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

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

- 访问 http://java.sun.com/j2se/1.5.0/download.jsp
- 选择 "JDK 5.0 Update x"
- 下载 "Linux Platform" 版本 (~45M)
- 下载完毕后安装
- 确保 JAVA_HOME 环境变量设置正确

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

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

- 访问 http://dev.mysql.com/downloads/mysql/4.1.html
- 你载您的平台下 MySQL 的最新版本
- 安装MySQL的安装说明正确安装好MySQL

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

- 访问 http://www.alfresco.org/downloads
- 下载 "Alfresco Linux Tomcat Bundle"
- 建立一个名为'alfresco'的目录
- 将alfresco-tomcat-xxxxxx.tar.gz 解压到'/opt/alfresco'

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

编辑 'alfresco.sh' 文件并检查Tomcat安装位置的参数设置：
- 如果是 JBoss 捆绑包，这个路径会是： '/opt/alfresco/tomcat'

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

访问 '/opt/alfresco' 并在MySQL 导入 'db_setup.sql' :
执行 'mysql -u root -p <db_setup.sql'.

这会建立一个以用户名密码为'alfresco'建立一个名为'alfresco'的数据库。

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

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

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

- 访问 http://download.openoffice.org
- 下载 Linux 版本
- 安装 OpenOffice
- Start one of the OpenOffice programs to go through initial registration, 然后关闭它
- 将 '/opt/alfresco/zstart_oo.sh' 重命名为 '/opt/alfresco/start_oo.sh'
- 编辑 '/opt/alfresco/start_oo.sh' 设置 OpenOffice 正确的位置
- 关闭或重新启动Alfresco，如果您已经运行了它

===========================
启动 Alfresco服务器
===========================

确保 MySQL 服务器正在运行，然后访问 '/opt/alfresco' 目录
- 运行 'alfresco.sh start'
- 您现在可以尝试通过如下地址访问ALfresco:

http://localhost:8080/alfresco

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

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

http://www.alfresco.org/downloads

或者通过 Web Client 从 company space 获得

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

访问 '/opt/alfresco' 目录并运行 'alfresco.sh stop'

===========================
从 V1.0 升级到 V1.1.2
===========================

在 V1.1.2 中一些配置被改变了。

从存在的V1版本升级到V1.1.2必需执行如下步骤：

注意: 你现有的数据库和 'alf_data' 目录将会被保留。

*** 任何您做过的配置改变都需要被注意 ***

*** Tomcat ***
在 Tomcat 下, 在 'Tomcat/webapps' 下的 'alfresco' 目录必需被删除。
复制 V1.1.2 'alfresco.war' 文件到 'Tomcat/webapps' 目录 - 或者下载 WAR Tomcat 捆绑包。
启动 Tomcat, 'Tomcat/webapps'下的 'alfresco' 目录被建立
停止 Tomcat
修改您需要改变的配置文件

v1.1和v1.1.1升级的配置修整方法如下：
1.1.2版与 1.1和1.1.1之间结构上有些变化，这个版本可以通过FTP, WebDAV和CIFS方式访问。

如果你已经安装了以前的版本，升级的话您可能需要修整下面提到的一个配置文件：

- 编辑model-specific-services-context.xml配置文件

Tomcat捆绑包的文件位置在：tomcat/webapps/alfresco/WEB-INF/classes/alfresco
JBoss捆绑包的文件位置在：jboss/server/default/conf/alfresco

- 将引用到下面bean中的一个字母改为大写：

nodeService
copyService
contentService

model-specific-services-context.xml文件的主要内容应该包含下列代码的各项：

  <bean name="fileFolderService" class="org.alfresco.repo.model.filefolder.FileFolderServiceImpl" init-method="init">
    <property name="namespaceService"><ref bean="namespaceService" /></property>
    <property name="dictionaryService"><ref bean="dictionaryService" /></property>
    <property name="nodeService"><ref bean="NodeService" /></property>
    <property name="copyService"><ref bean="CopyService" /></property>
    <!-- NOTE: using Big SearchService until AR-279 is completed -->
    <property name="searchService"><ref bean="SearchService" /></property>
    <property name="contentService"><ref bean="ContentService" /></property>
    <property name="mimetypeService"><ref bean="mimetypeMap" /></property>
  </bean>

 

启动 Tomcat 并使用 alfresco V1.1.2

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

Once the alfresco server is running, it should be possible to connect to it by mapping a
drive to it. The name to use for the mapping is based on the name of the server on which
alfresco is running, with '_A' on the end. For example, if the PC name is 'MYPC01', then
the CIFS server name will be 'MYPC01_A'. To map the drive, open Windows Explorer, go
to the Tools menu and select 'Map Network Drive...'. In the Map Network Drive dialog,
choose the drive letter you wish to use. To locate the CIFS server, click the 'Browse...'
button and find the server name as described above. You should then have the option to
select a folder within it called 'alfresco'. Click 'OK' to select the folder, then click
'Finish' to map the drive. You should now have access to the alfresco repository from
the mapped drive. If the CIFS server name does not show in the browse dialog, you may also
enter the folder location directly in the dialog, for example '//MYPC01_A/alfresco'.

To check the CIFS server is running, try connecting from the alfresco server using smbclient.

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. To set the domain, edit the 'file-servers.xml'
file in the '~/alfresco/tomcat/webapps/alfresco/WEB-INF/classes/alfresco' directory and add the
domain into the following line:
<host name="${localname}_A"/>
so that it is something like:
<host name="${localname}_A" domain="MYDOMAIN"/>

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

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

To enable image manipulation on a Linux platform, the ImageMagick package needs to be installed. On
many Linux distributions it is already available. To check, try running the 'convert' command, which
is part of ImageMagick and usually found in /usr/bin. To enable alfresco to use 'convert', a symbolic
link named 'imconvert' to it needs to be created somewhere on the path. For example, in '/usr/bin'
use the command 'ln -s convert imconvert'.

================
问题处理
================

If you have problems with your installation, please look for help on the Installation
forum at http://www.alfresco.org/forums and ask for any additional help you may need.

- The JAVA_HOME variable must be set correctly to your Java5 installation.

- Most installation issues can be resolved by following advice in this forum article:
http://www.alfresco.org/forums/viewtopic.php?t=7
and in this forum generally:
http://www.alfresco.org/forums/viewforum.php?f=8

- WAR file name is now called alfresco.war
NOTE: If you deployed the war previously then you must clear out the web-client files
before deploying the new WAR file, having first copied any configurations made:

Previous release was PR6 or later:
Delete <tomcat-home>/webapps/alfresco.war
Delete <tomcat-home>/webapps/alfresco <-- make sure any configurations are copied
Delete <tomcat-home>/work/alfresco

- If the following errors are reported on the console:
ERROR [AbstractImageMagickContentTransformer] JMagickContentTransformer not available:
ERROR [AbstractImageMagickContentTransformer] ImageMagickContentTransformer not available:
Failed to execute command: imconvert ...

These are not issues which will cause the server to fail. alfresco is reporting that
various external document transformation engines are not available for use by the server.  
Either follow the instructions at the bottom of the Release Notes Wiki page:
http://www.alfresco.org/mediawiki/index.php/Preview_Release_5
or remove the transformer references completely if you don't require them:
http://www.alfresco.org/forums/viewtopic.php?t=90
We have also noted cases on some distributions and configurations of Linux
where imconvert is configured correctly but you recieve the 'Failed to execute command: imconvert ...'
error. This can be solved in some instances by editing the 'content-services-context.xml'
and removing the quotes around the imconvert command:
<value>imconvert '${source}' ${options} '${target}'</value>
to:
<value>imconvert ${source} ${options} ${target}</value>

- If you see this error on server startup:
ERROR [protocol] FTP Socket error
java.net.BindException: Address already in use: JVM_Bind
    at java.net.PlainSocketImpl.socketBind(Native Method)
Check to see if you have any services running against port 8080 for the alfresco server and
port 21 for the alfresco FTP integration.

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

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