Alfresco安装后启动异常处理

当出现下面这些出错信息时，只要知道其出错的原理，就很容易解决它。

⑴org.alfresco.error.AlfrescoRuntimeException

不能直接在alfresco/tomcat/bin中运行startup.bat启动Tomcat，会报错：

00:31:34,687ERROR[web.context.ContextLoader]Contextinitializationfailed

org.springframework.beans.factory.BeanCreationException:Errorcreatingbeanwit

hname'dictionaryRepositoryBootstrap'definedinclasspathresource[alfresco/

core-services-context.xml]:Invocationofinitmethodfailed;nestedexceptioni

sorg.alfresco.error.AlfrescoRuntimeException:Failureduringrollback:org.alfr

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

Causedby:

org.alfresco.error.AlfrescoRuntimeException:Failureduringrollback:org.alfres

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

出错是因为在alfresco/tomcat/bin中运行startup.bat启动Tomcat，找不到相应的HSQLdatabase的初始化信息，可以参考下面的⑶仔细思考一下。

注1：思考之后，你也许会尝试把alfresco/alf_data/hsql_data这个文件夹放到alfresco/tomcat/bin目录中，然后再次运行startup.bat启动Tomcat，你可以看一下运行结果会怎样，这会帮助你理解alfresco初始化）。

注2：如果你使用的是mysql数据库，而mysql数据库没有运行mysqld启动的话，也会报上面错误。

⑵在alfresco.bat中这样几行字：

remThefollowingoptionsareonlyrequiredforSunJVMspriorto1.5update8

setJAVA_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版本

我本机版本查看如下：

javaversion"1.5.0_04"

Java(TM)2RuntimeEnvironment,StandardEdition(build1.5.0_04-b05)

JavaHotSpot(TM)ClientVM(build1.5.0_04-b05,mixedmode,sharing)

J2SEDevelopmentKit1.5update5

如上，说明JDK版本是J2SEDevelopmentKit1.5update5，那么上面alfresco.bat中的几行字按照上面绿色注释也是必须加的。

不过我尝试去掉上面alfresco.bat中的几行字，并没有报错，估计1.5update5到1.5update7中alfresco.bat中的几行字也都是可以去掉的。

要想去掉上面alfresco.bat中的几行字，必须下载JDK的相应版本，下载地址为：http://java.sun.com/products/archive/

⑶alfresco/alf_data下面有一个hsql_data文件夹，存放的是一些HSQLdatabase的初始化信息，如果删除，也会报⑴中的错

hsql_data下面有两个文件

alfresco.properties：配置HSQL数据库的一些初始化参数

alfresco.script：创建HSQL数据库用户的sql语句，默认创建两个HSQL用户（如下）。

CREATEUSERSAPASSWORD""

CREATEUSERALFRESCOPASSWORD"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/work（tomcat下的/缓存文件夹）。

⑸如果出现下面错误：

Exceptioninthread"HSQLDBTimer@3de2df"java.lang.NullPointerException

atorg.hsqldb.lib.HsqlTimer.nextTask(UnknownSource)

atorg.hsqldb.lib.HsqlTimer$TaskRunner.run(UnknownSource)

atjava.lang.Thread.run(Thread.java:595)

可能是alfresco关闭时不正常，可以再次运行alfresco/alf_stop.bat进行关闭。

⑹如果删除alfresco/bin下的Win32NetBIOS.dll（我本机是32位XP系统，64位的对应Win32NetBIOSx64.dll），启动alfresco/alf_start.bat时会出现下面错误：

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

java.lang.UnsatisfiedLinkError:noWin32NetBIOSinjava.library.path

出现这种错误是因为删除了Win32NetBIOS.dll，查看alfresco/alfresco.bat，可以看到：

setPATH=%ALF_HOME%bin;%PATH%

在启动alfresco/alfresco.bat时java.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:\ProgramFiles\Oracle\jre\1.3.1\bin;C:\ProgramFiles\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:\ProgramFiles\OpenSSH\bin;C:\ProgramFiles\MicrosoftSQLServer\80\Tools\BINN;C:\ProgramFiles\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\bin或C:\WINDOWS\system32路径中，删除alfresco/bin/Win32NetBIOS.dll依然可以使用alfresco/alf_start.bat正常启动alfresco。

⑺下面出错信息：

org.alfresco.error.AlfrescoRuntimeException:Ensurethatthe'dir.root'property

ispointingtothecorrectdatalocation.

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

#Changethefailurebehaviouroftheconfigurationchecker

system.bootstrap.config_check.strict=true

改为：

#Changethefailurebehaviouroftheconfigurationchecker

system.bootstrap.config_check.strict=false

16:30:32,546ERROR[ConfigurationChecker]CONTENTINTEGRITYERROR:Indexesnotfoundfor5stores.

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

#Theindexrecoverymode(NONE,VALIDATE,AUTO,FULL)

index.recovery.mode=VALIDATE

改为：

#Theindexrecoverymode(NONE,VALIDATE,AUTO,FULL)

index.recovery.mode=FULL

可以重新创建索引。

2．alfresco默认数据库HSQLdatabase

①alfresco默认使用的数据库为HSQLdatabase，可在alfresco\tomcat\shared\classes\alfresco\extension中找到两个与数据库定义相关的文件custom-hibernate-dialect.properties和custom-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中的（实际上是map中value被覆盖），这与两者的加载顺序有关：

alfresco\tomcat\webapps\alfresco\WEB-INF\classes\alfresco\application-context.xml中先后加载（见下）。

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

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

repository.properties与custom-repository.properties分别在core-services-context.xml与custom-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数据库

⑴实际发布的时候一般不建议使用HSQLdatabase这种文件型数据库。

启动alf_start.bat可以看到控制台有一行提示：

11:10:57,062INFO[domain.schema.SchemaBootstrap]AlfrescoisusingtheHSQLde

faultdatabase.PleaseonlyusethiswhileevaluatingAlfresco,itisNOTrecomm

endedforproductionordeployment!

使用mysql数据库前清空文件夹：alfresco/alf_data（其中alfresco/alf_data/hsql_data文件夹可以删除，因为这时已经用不到HSQL数据库了），alfresco/tomcat/temp,alfresco/tomcat/work。

⑵打开alfresco/extras/databases/mysql下的db_setup.sql，可以看到：

createdatabasealfresco;

grantallonalfresco.*to'alfresco'@'localhost'identifiedby'alfresco'withgrantoption;

grantallonalfresco.*to'alfresco'@'localhost.localdomain'identifiedby'alfresco'withgrantoption;

上面创建了alfresco数据库，并创建用户名alfresco密码alfresco，分配管理权限。

为确保国际化，统一使用UTF8编码（alfresco/README_mysql.txt中也有提到），db_setup.sql修改为：

createdatabasealfrescoDEFAULTCHARACTERSETutf8COLLATEutf8_bin;

grantallonalfresco.*to'alfresco'@'localhost'identifiedby'alfresco'withgrantoption;

grantallonalfresco.*to'alfresco'@'localhost.localdomain'identifiedby'alfresco'withgrantoption;

运行alfresco/extras/databases/mysql/db_setup.bat，即可创建mysql数据库。

②alfresco\tomcat\shared\classes\alfresco\extension中找到两个与数据库定义相关的文件custom-hibernate-dialect.properties和custom-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文件中定义了这些初始化参数：

#Directoryconfiguration

dir.root=./alf_data

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

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

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

#Thelocationforluceneindexfiles

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

#Thelocationforluceneindexlocks

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解压版数据库，如果出现乱码，首先确保你数据库编码设置正确，使用showvariableslike'chara%';查看你数据库编码，比较重要的有四个编码：

character_set_client:客户端字符集(应用程序客户端使用的字符集)。

character_set_connection:连接字符集。

character_set_results:指的是使用sql查询处理以后返回结果使用的字符集。

character_set_database:指的数据库表中物理存储使用的字符集。

因为alfresco代码使用的是utf8格式，所以在使用

createdatabasealfrescoDEFAULTCHARACTERSETutf8COLLATEutf8_bin;

创建数据库之前，首先设置mysql数据库编码，这样在启动alfresco/alf_start.bat初始化mysql数据库时（创建alfresco表和数据）时，才能保证表和数据格式的正确。

setcharacter_set_database='gbk';（设置为gbk可以在查看表数据时显示中文数据）

setnames'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