版權所有:(xiaodaoxiaodao)藍小刀 ?? xiaodaoxiaodao@gmail.com

http://www.tkk7.com/xiaodaoxiaodao/archive/2007/09/16/145520.html

轉載請注明來源/作者

?

?

Alfresco2.1 下載和安裝


Alfresco
是一個開放源碼,開放標準的內容知識庫. 兼容JBoss Portal 2.0JSR-168. Java Server Faces圖形接口框架. 可訪問CIFS/SMB.

Alfresco 主要是基于Spring, Hibernate, Lucene等開發. Alfresco公司利用開源代碼Java中部分內容,尤其是利用了JBoss程序服務器和Spring開發架構,創建了目錄知識庫。 ?

?

1 下載和安裝alfresco(內嵌tomcat的版本)

下載和安裝alfresco(這里下載的版本為 alfresco-community-tomcat-2.1.0.zip

下載地址為:http://sourceforge.net/project/showfiles.php?group_id=143373

下載后解壓到一個目錄,這里解壓到E:\project\alfresco,解壓后可以看到目錄結構如下:

alfresco.JPG?

啟動alfresco/alf_start.bat,訪問http://localhost:8080/alfresco/即可看到alfresco登錄界面(默認管理員登陸 用戶名:admin,密碼:admin)。

?

這時可以看到alfresco/tomcat/webapps目錄下的alfresco.war包被解壓為alfresco文件夾。

?

注: 用記事本打開alfresco/alf_start.bat可以看到其中內容:

call "%~dp0alfresco.bat" start ????????? %~dp0表示查找bat文件所在目錄

然后alf_start.bat調用alfresco.bat,在alfresco/alfresco.bat中有一行:

call "%CATALINA_HOME%\bin\startup.bat"

可以看到最終運行的還是Tomcat

?

當出現下面這些出錯信息時,只要知道其出錯的原理,就很容易解決它。

org.alfresco.error.AlfrescoRuntimeException

不能直接在alfresco/tomcat/bin中運行startup.bat啟動Tomcat,會報錯:

00:31:34,687 ERROR [web.context.ContextLoader] Context initialization failed

org.springframework.beans.factory.BeanCreationException: Error creating bean wit

h name 'dictionaryRepositoryBootstrap' defined in class path resource [ alfresco/

core-services-context.xml ]: Invocation of init method failed; nested exception i

s org.alfresco.error.AlfrescoRuntimeException: Failure during rollback: org.alfr

esco.repo.dictionary.DictionaryRepositoryBootstrap$1@2589c3

Caused by:

org.alfresco.error.AlfrescoRuntimeException : Failure during rollback: org.alfres

co.repo.dictionary. DictionaryRepositoryBootstrap $1@2589c3 ?????

?

出錯是因為在alfresco/tomcat/bin中運行startup.bat啟動Tomcat,找不到相應的HSQL database的初始化信息,可以參考下面的 仔細思考一下。

?

1 思考之后,你也許會嘗試把alfresco/alf_data/hsql_data這個文件夾放到alfresco/tomcat/bin目錄中,然后再次運行startup.bat啟動Tomcat,你可以看一下運行結果會怎樣,這會幫助你理解alfresco初始化)。

?

2 如果你使用的是mysql數據庫,而mysql數據庫沒有運行mysqld啟動的話,也會報上面錯誤。

?

alfresco.bat中這樣幾行字:

rem The following options are only required for Sun JVMs prior to 1.5 update 8

set JAVA_OPTS=%JAVA_OPTS% -XX:CompileCommand=exclude,org/apache/lucene/index/IndexReader$1,doBody -XX:CompileCommand=exclude,org/alfresco/repo/search/impl/lucene/index/IndexInfo$Merger,mergeIndexes -XX:CompileCommand=exclude,org/alfresco/repo/search/impl/lucene/index/IndexInfo$Merger,mergeDeletions

注意上面綠色信息,如果你的JDK版本過低的話,上面這一行字是必須的。

?

注: java -version 可以查看JDK版本

我本機版本查看如下:

java version "1.5.0_04"

Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_04-b05)

Java HotSpot(TM) Client VM (build 1.5.0_04-b05, mixed mode, sharing)

J2SE Development Kit 1.5 update 5

如上,說明JDK版本是J2SE Development Kit 1.5 update 5,那么上面alfresco.bat中的幾行字按照上面綠色注釋也是必須加的。

?

不過我嘗試去掉上面alfresco.bat中的幾行字,并沒有報錯,估計1.5 update 51.5 update 7alfresco.bat中的幾行字也都是可以去掉的。

?

要想去掉上面alfresco.bat中的幾行字,必須下載JDK的相應版本,下載地址為:http://java.sun.com/products/archive/

?

alfresco/alf_data 下面有一個hsql_data文件夾,存放的是一些HSQL database的初始化信息,如果刪除,也會報 中的錯

hsql_data 下面有兩個文件

alfresco.properties :配置HSQL數據庫的一些初始化參數

alfresco.script :創建HSQL數據庫用戶的sql語句,默認創建兩個HSQL用戶(如下)。

CREATE USER SA PASSWORD ""

CREATE USER ALFRESCO PASSWORD "ALFRESCO"

?

注: 啟動alfresco時,如果HSQL數據庫被更改,alfresco.properties文件會被更新,文件中的modified=no更新為modified=yes

?

清空初始化信息和緩存(呵呵,當你進入http://localhost:8080/alfresco/進行了一些CRUD的操作之后就不要隨便清空了,這會重新初始化你的HSQL數據庫)。

比較重要的一點是在出錯之后如果使用alf_start.bat重新啟動alfresco,最好要刪除清空文件夾:alfresco/alf_data(見1),alfresco/tomcat/temp,否則很可能會報錯。

?

1 使用alf_start.bat重新啟動alfresco后,會在alfresco/alf_data下生成4個文件夾:lucene-indexes/contentstore.deleted/contentstore/audit.contentstore

?

2 其中alfresco/alf_data/hsql_data文件夾千萬不能刪除,原因如 所述

?

3 另外,為徹底一點,你也可以清空alfresco/tomcat/worktomcat下的/緩存文件夾)。

?

如果出現下面錯誤:

Exception in thread " HSQLDB Timer @3de2df" java.lang.NullPointerException

??????? at org.hsqldb.lib.HsqlTimer.nextTask(Unknown Source)

??????? at org.hsqldb.lib.HsqlTimer$TaskRunner.run(Unknown Source)

??????? at java.lang.Thread.run(Thread.java:595)

可能是alfresco關閉時不正常,可以再次運行alfresco/alf_stop.bat進行關閉。

?

如果刪除alfresco/bin下的Win32NetBIOS.dll(我本機是32XP系統,64位的對應Win32NetBIOSx64.dll),啟動alfresco/alf_start.bat時會出現下面錯誤:

10:38:11,046 INFO? [repo.module.ModuleServiceImpl] Found 0 module(s).

java.lang.UnsatisfiedLinkError: no Win32NetBIOS in java.library.path

?

出現這種錯誤是因為刪除了Win32NetBIOS.dll,查看alfresco/alfresco.bat,可以看到:

set PATH=%ALF_HOME%bin;%PATH%

在啟動alfresco/alfresco.batjava.library.path也會使用PATH中的路徑(alfresco/bin)去尋找相應的Win32NetBIOS.dll,如果找不到,就會報上面的錯誤。

?

1 新建一個JAVA類,在其中調用System.out.println(System.getProperty("java.library.path"));

可以得到java.library.path的值。

下面是我本機得到的結果:

C:\Java\jdk1.5.0_04\bin; .;C:\WINDOWS\system32;C:\WINDOWS;C:\Java\jdk1.5.0_04\bin;D:\oracle\ora92\bin;C:\Program Files\Oracle\jre\1.3.1\bin;C:\Program Files\Oracle\jre\1.1.8\bin;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;E:\apache-ant-1.6.3\bin;E:\maven-1.0.2\bin;D:\mysql-5.0.45-win32\bin;C:\Program Files\OpenSSH\bin;C:\Program Files\Microsoft SQL Server\80\Tools\BINN;C:\Program Files\Subversion\bin

?

觀察上面的java.library.path的值,可以看到它大概包括了三部分,即windows系統環境變量中PATH + JAVA_HOME/bin + 系統路徑(.;C:\WINDOWS\system32;C:\WINDOWS;

?

2 為了不依賴于alfresco/bin/Win32NetBIOS.dll這個路徑(如果你下載不是 alfresco-community-tomcat-2.1.0.zip 這種內嵌tomcat的版本,而是一個單獨的 alfresco-community-war-2.1.0.zip ,這點會非常有用),你可以把Win32NetBIOS.dll拷貝到C:\Java\jdk1.5.0_04\binC:\WINDOWS\system32路徑中,刪除alfresco/bin/Win32NetBIOS.dll依然可以使用alfresco/alf_start.bat正常啟動alfresco

?

下面出錯信息:

org.alfresco.error.AlfrescoRuntimeException: Ensure that the 'dir.root' property

?is pointing to the correct data location.

?

alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco 下的repository.properties文件中:

# Change the failure behaviour of the configuration checker

system.bootstrap.config_check.strict=true

改為:

# Change the failure behaviour of the configuration checker

system.bootstrap.config_check.strict=false

?

16:30:32,546 ERROR [ConfigurationChecker] CONTENT INTEGRITY ERROR: Indexes not found for 5 stores.

alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco 下的repository.properties文件中:

# The index recovery mode (NONE, VALIDATE, AUTO, FULL)

index.recovery.mode=VALIDATE

?

改為:

# The index recovery mode (NONE, VALIDATE, AUTO, FULL)

index.recovery.mode=FULL

可以重新創建索引。

?

?

2 alfresco 默認數據庫HSQL database

alfresco默認使用的數據庫為HSQL database,可在alfresco\tomcat\shared\classes\alfresco\extension中找到兩個與數據庫定義相關的文件custom-hibernate-dialect.propertiescustom-repository.properties(還可以定義一些其它系統配置),其中

custom-hibernate-dialect.properties

hibernate.dialect=org.hibernate.dialect.HSQLDialect

?

custom-repository.properties

db.driver=org.hsqldb.jdbcDriver

db.url=jdbc:hsqldb:file:alf_data/hsql_data/alfresco;ifexists=true;shutdown=true;

?

這兩個文件是在alfresco\tomcat\shared\classes\alfresco\extension\custom-repository-context.xml中加載的。

?

alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco下有另外的一個文件repository.properties,這個文件與上面的custom-repository.properties相對應,如果在兩個properties文件中定義了相同的key/value資源,在加載文件中的資源時,custom-repository.properties會覆蓋repository.properties中的(實際上是mapvalue被覆蓋),這與兩者的加載順序有關:

alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\application-context.xml 中先后加載(見下)。

<import resource="classpath:alfresco/core-services-context.xml" />

<import resource="classpath*:alfresco/extension/*-context.xml"/>

?

repository.properties custom-repository.properties分別在core-services-context.xmlcustom-repository-context.xml中指定

?

查看repository.properties文件,可以看到

db.username=alfresco

db.password=alfresco

這與上面1- - 中使用alfresco.script創建HSQL數據庫用戶的sql語句是對應的。

?

?

3 hsql轉為mysql(使用幫助也可參考alfresco/ README_mysql.txt

alfresco 使用mysql數據庫

實際發布的時候一般不建議使用HSQL database這種文件型數據庫。

啟動alf_start.bat可以看到控制臺有一行提示:

11:10:57,062 INFO? [domain.schema.SchemaBootstrap] Alfresco is using the HSQL de

fault database. Please only use this while evaluating Alfresco, it is NOT recomm

ended for production or deployment!

?

使用mysql數據庫前清空文件夾:alfresco/alf_data(其中alfresco/alf_data/hsql_data文件夾可以刪除,因為這時已經用不到HSQL數據庫了),alfresco/tomcat/temp, alfresco/tomcat/work

?

打開alfresco/extras/databases/mysql下的db_setup.sql,可以看到:

create database alfresco;

grant all on alfresco.* to 'alfresco'@'localhost' identified by 'alfresco' with grant option;

grant all on alfresco.* to 'alfresco'@'localhost.localdomain' identified by 'alfresco' with grant option;

上面創建了alfresco數據庫,并創建用戶名alfresco密碼alfresco,分配管理權限。

?

為確保國際化,統一使用UTF8編碼(alfresco/ README_mysql.txt 中也有提到),db_setup.sql修改為:

create database alfresco DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;

grant all on alfresco.* to 'alfresco'@'localhost' identified by 'alfresco' with grant option;

grant all on alfresco.* to 'alfresco'@'localhost.localdomain' identified by 'alfresco' with grant option;

?

運行alfresco/extras/databases/mysql/db_setup.bat,即可創建mysql數據庫。

?

alfresco\tomcat\shared\classes\alfresco\extension 中找到兩個與數據庫定義相關的文件custom-hibernate-dialect.propertiescustom-repository.properties(還可以定義一些其它系統配置),其中

custom-hibernate-dialect.properties

hibernate.dialect=org.hibernate.dialect.HSQLDialect

?

custom-repository.properties

db.driver=org.hsqldb.jdbcDriver

db.url=jdbc:hsqldb:file:alf_data/hsql_data/alfresco;ifexists=true;shutdown=true;

修改為

custom-hibernate-dialect.properties

#hibernate.dialect=org.hibernate.dialect.HSQLDialect

hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

?

custom-repository.properties

#db.driver=org.hsqldb.jdbcDriver

#db.url=jdbc:hsqldb:file:alf_data/hsql_data/alfresco;ifexists=true;shutdown=true;

db.driver=org.gjt.mm.mysql.Driver

db.url=jdbc:mysql://localhost/alfresco

?

默認的alfresco數據庫用戶名和密碼位于alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco下的repository.properties文件中(可參考2.- -)。

?

?

啟動alfresco/alf_start.bat,可以看到在alfresco/alf_data下生成4個文件夾:lucene-indexes/contentstore.deleted/contentstore/audit.contentstore

?

alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco 下的repository.properties文件中定義了這些初始化參數:

# Directory configuration

dir.root=./alf_data

dir.contentstore=${dir.root}/contentstore

dir.contentstore.deleted=${dir.root}/contentstore.deleted

dir.auditcontentstore=${dir.root}/audit.contentstore

?

# The location for lucene index files

dir.indexes=${dir.root}/lucene-indexes

# The location for lucene index locks

dir.indexes.lock=${dir.indexes}/locks

?

注: alfresco 數據庫中保存的是一些數據庫關系(以及JBPM的一些表),比如預定義的permission/node/access_control等,而數據(data)和內容(content)保存在alfresco/alf_data文件夾下。

?

?

4 使用mysql數據庫亂碼問題

如上3轉換為mysql數據庫后,訪問http://localhost:8080/alfresco/如果語言選擇中文,進入系統后一些地方會出現中文亂碼。

我使用的是mysql-5.0.45-win32解壓版數據庫,如果出現亂碼,首先確保你數據庫編碼設置正確,使用show variables like 'chara%';查看你數據庫編碼,比較重要的有四個編碼:

character_set_client : 客戶端字符集(應用程序客戶端使用的字符集)

character_set_connection : 連接字符集。

character_set_results : 指的是使用sql查詢處理以后返回結果使用的字符集。

character_set_database : 指的數據庫表中物理存儲使用的字符集。

?

因為alfresco代碼使用的是utf8格式,所以在使用

create database alfresco DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;

創建數據庫之前,首先設置mysql數據庫編碼,這樣在啟動alfresco/alf_start.bat初始化mysql數據庫時(創建alfresco表和數據)時,才能保證表和數據格式的正確。

set character_set_database='gbk';? 設置為gbk可以在查看表數據時顯示中文數據

set names 'utf8'; (設置character_set_client/ character_set_connection/ character_set_results字符集)

?

alfresco\tomcat\shared\classes\alfresco\extension

custom-repository.properties

db.url=jdbc:mysql://localhost/alfresco

修改為

custom-repository.properties

db.url=jdbc:mysql://localhost/alfresco?characterEncoding=gbk&useUnicode=true

?

?

1 在安裝使用過程中如果出現一些錯誤或者需要一些幫助,不妨到下面網站找些有用的信息參考一下:

Alfresco 官方wiki

http://wiki.alfresco.com/wiki/Main_Page

Alfresco 官方forums

http://forums.alfresco.com/

Alfresco 官方help

http://www.alfresco.org/help/webclient/

?

2 從官方網站(http://www.alfresco.com/products/ecm/specifications/)可以看到它支持的一些 Technical Specifications ,如

支持操的作系統

Linux

MacOS

Unix

Windows

?

支持的瀏覽器

Firefox

Internet Explorer

?

支持 數據庫

Any Database Supported by Hibernate including:

MySQL

Oracle

?

使用的技術

Java

Spring? Aspect-Oriented Framework

ACEGI – Aspect-Oriented Security Framework

MyFaces? JSF Implementation

Hibernate? ORM Persistence

Lucene? Text Search Engine

JLAN

POI File Format Conversion

PDFBox – PDF Conversion

OpenOffice

jBPM

Rhino JavaScript engine

?

3 alfresco 的源代碼( alfresco-community-sdk-2.1.0.zip )下載地址為:http://sourceforge.net/project/showfiles.php?group_id=143373,不知道什么原因,下載SDK之后無法進行編譯,去掉兩個出錯文件然后編譯成功,不過啟動alfresco會報錯。

?

最好的辦法是從SVN上下載它的SDK,下載地址為:http://svn.alfresco.com/repos/alfresco-open-mirror/alfresco/

安裝SVN(最新版本為 svn-1.4.5-setup.exe ,下載地址http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91)之后,可以通過

svn co http://svn.alfresco.com/repos/alfresco-open-mirror/alfresco/HEAD 命令下載源代碼。

?

詳細SVN下載方式也可參考 Alfresco 官方wiki http://wiki.alfresco.com/wiki/Alfresco_SVN_Development_Environment

?



Alfresco2.1
下載和安裝 .pdf 下載地址:

Alfresco2.1 下載和安裝 .rar



?

版權所有:(xiaodaoxiaodao)藍小刀 ?? xiaodaoxiaodao@gmail.com

?