泛微E-Mobile4.5服务端安装手册

第一章      安装前说明

1.本文档只做为E-mobile4.5服务器端安装配置手册！

2.E-Mobile4.5可运行在windows和linux服务器上

3.E-Mobile4.5必须与ecology服务器互联，因此，

Ø         请确保在E-Mobile所在的服务器上可以通过浏览器访问Ecology；

Ø         请确保E-Mobile所在的服务器能访问Ecology所使用的数据库。

第二章      复制文件

手机版属于非标功能，所以在申请后会给出升级包，升级包中包含了ecology和Emobile两个目录，将ecology目录覆盖原来的ecology目录，将Emobile目录放到mobile服务器上，可以和ecology同一台机器，也可以是不同的机器。

第三章      参数配置

打开ecology/WEB-INF/web.xml文件，需要添加以下参数：

Ø         在文件中搜索关键字 XFireServlet，如果没有就添加以下内容

<servlet>

   <servlet-name>XFireServlet</servlet-name>

   <display-name>XFire Servlet</display-name>

<servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>

</servlet>

<servlet-mapping>

   <servlet-name>XFireServlet</servlet-name>

   <url-pattern>/services/*</url-pattern>

</servlet-mapping>

Ø         在文件中搜索关键字 MobileXmlRpcServlet，如果没有就添加以下内容

<servlet>

       <servlet-name>MobileXmlRpcServlet</servlet-name>

       <servlet-class>org.apache.xmlrpc.webserver.XmlRpcServlet</servlet-class>

       <init-param>

              <param-name>enabledForExtensions</param-name>

              <param-value>true</param-value>

              <description>Mobile XML-RPC.</description>

       </init-param>

</servlet>

<servlet-mapping>

       <servlet-name>MobileXmlRpcServlet</servlet-name>

       <url-pattern>/mobile/xmlrpc</url-pattern>

</servlet-mapping>

Ø         在文件中搜索关键字 Mobile，如果没有就添加以下内容

<filter>

       <filter-name>Mobile</filter-name>

    <filter-class>weaver.mobile.plugin.ecology.MobileFilter</filter-class>

  </filter>

  <filter-mapping>

    <filter-name>Mobile</filter-name>

    <url-pattern>/mobile/plugin/*</url-pattern>

  </filter-mapping>

第四章      启动服务

首先检查emobile的服务参数，在emobile\conf目录下有resin.conf文件，打开后显示如图4-1所示，

l   首先是两个内存参数即xmx和xms，如果是32位操作系统的话，请统一设置为1024m，否则服务无法启动（服务器内存至少2G内存），如果是64位操作系统的话可以根据内存大小定义，具体见附录1。

l   其次是端口配置，默认端口为89，此端口为emobile服务器配置页面端口，详细配置说明见第五章说明。

图4-1

如果是windows平台，请在控制台页面进入到emobile解压的目录下，输入httpd.exe -java_home D:\WEAVER\JDK -install-as ResinMobile（红色文字根据jdk所在路径填写，如果与ecology不在一台服务器上，mobile服务器需放上jdk1.6），安装服务后可以在windows服务管理器中启动emobile服务。

如果是Linux服务器，使用编辑器检查emobile目录下的start.sh文件， /usr/weaver/jdk/bin/java -jar ./lib/resin.jar start &，确保文件中红色标出的部分路径正确，然后直接使用start.sh启动emobile服务。

 

第五章      服务器连接配置

在启动了emobile服务之后，我们开始对emobile服务器进行配置

Ø         第一步：打开浏览器，输入http://ip:89/install，ip地址为emobile服务器的ip地址，89为默认端口，用户可以自行调整（见第四章说明），输入地址后显示如图5-1，这里有两个选项，一个是版本升级（跳第四步），另外一个是新安装（第二步）。

图5-1

Ø         第二步：选择新安装客户后点击图5-1中的下一步，显示如图5-2的内容，这里要输入ecology访问地址，此地址必需是emobile所在服务器可以访问的地址，完成后点击下一步，如果输入的地址无法访问的话会显示如图5-3的错误提示，请检查地址是否正确。

图5-2

图5-3

Ø         第三步：由于是新安装所以系统在验证了地址正确性后显示如图5-4的界面，安装结束，点击登录后继续配置，跳第七步。

图5-4

Ø     第四步：用户已有低版本emobile的时候，选择升级客户后点击下一步，显示如图5-5，这里要输入ecology访问地址，此地址必需是emobile所在服务器可以访问的地址，完成后点击下一步，如果输入的地址无法访问的话会显示如图5-3的错误提示，请检查地址是否正确。

图5-5

Ø         第五步：在数据迁移页面确认访问地址没有问题后点击确定，进行数据迁移，完成后系统会弹出提示框提示迁移成功，显示如图5-6。

图5-6

Ø         第六步：迁移成功确定后显示如图5-7的安装成功页面，点击登录。

图5-7

Ø     第七步：在成功页面点击登录按钮后自动跳转到后台管理登录页面，显示如图5-8所示，输入用户名、密码和验证码后点击登录按钮，管理员用ecology的sysadmin账号，

图5-8

第六章      服务器管理

Emobile后台管理界面我们可以打开浏览器，输入http://ip:89/manager进行访问。mobile的系统管理员就是ecology的默认系统管理员sysadmin，在如图5-8的登录界面输入用户名、密码和验证码之后登录emobile后台管理系统界面中，如图6-1。

图6-1

6.1服务器管理

服务器管理主要是用来监控服务器运行状态的，分为了系统状态、系统日志、系统属性、授权信息4个部分。

6.1.1系统状态

系统状态用来查看服务器的基本安装信息，顶部有“检测系统”按钮，点击后可以查看ecology是否运行正常，在手机版无法访问的时候可以到这里来检测一下是ecology环境出了问题还是emobile环境有问题。

6.1.2系统日志

点击系统日志后显示如图6-2所示，这里可以查看emobile运行的日志，当用户emobile运行不正常的时候，可以到这里查看日志，找出问题。

图6-2

l         刷新：在日志信息页面有刷新按钮，可以动态跟踪刷新日志，如果选择无就是不刷新，用户可以自己定义刷新平率，如图6-3所示，可以设定10秒、30秒、60秒、90秒刷新一次系统日志并显示在日志信息框中。

6-3

l         日志查看排序：用户在查看日志的时候可以自定义顺序或倒序显示。

l         行：因为日志信息框大小的限制及方便用户查看，所以用户可以自定义日志在日志信息框中显示的行数，如图6-4所示。

图6-4

l         下载日志文件：用来下载emobile的运行日志。

6.1.3系统属性

系统属性用来设置手机版客户端的两个显示属性，如图6-5所示,

分页大小：手机版客户端显示工作流、文档每页的显示条数，点击后面的编辑按钮，显示出如图6-6所示页面，用户可以自定义显示条数，也可以选择恢复默认显示条数。

LOGO：手机版登录页面显示的logo，点击后面的编辑按钮，显示出图6-7所示，用户可以自行上传手机版logo，logo图片建议使用png格式的图片，建议尺寸180*150。

图6-5

图6-6

图6-7

6.1.4授权信息

授权信息用来控制emobile登录用户数，可以选在在线获取license，也可以在浏览按钮中选择并上传license，如图6-8所示。

图6-8

6.2插件管理

插件管理是用来设置emobile连接的ecology服务器及相关模块的设置。

6.2.1插件列表

点击插件管理中的插件列表后，显示如图6-9的内容，这里显示了emobile连接的是ecology还是其它泛微软件。

图6-9

点击名称链接或者列表中的详细按钮后，显示如图6-10，如果ecology地址发生了变动，可以在这里进行重新配置。下方的列表显示了当前emobile可以提取ecology中的哪些模块的哪些信息。

图6-10

6.3模块管理

Emobile4.0对功能模块可以进行分组管理并在ipad客户端中显示（对其它客户端无效）。

6.3.1模块组列表

点击左侧菜单模块组管理后显示如图6-11的内容，这里显示了模块组的列表。

图6-11

6.3.2添加模块组

在图6-11中点击添加模块组后显示如图6-12，在这里用户可以给模块起名字，并设置模块组的顺序，添加模块功能，添加的功能就属于这个模块组，使用IPAD访问的时候先访问模块组，然后显示出这个组下面的模块功能，详细可以见《泛微E-Mobile4.0客户端版使用手册-iPad版》；最后可以设定访问这个模块组的用户，只有有权限的用户才能访问该模块下的功能。

图6-12

按钮名称	功能描述	备注
保存	保存当前模块组
删除	删除当前模块组
名称	当前模块组名称	必填
显示顺序	当前模块组在ipad客户端的显示顺序	必填
描述	对当前模块组的文字描述
添加模块	给当前模块组添加功能模块
删除模块	删除当前模块组的功能模块	必需先选中功能模块
Check框	删除模块时必须选中
显示名	模块在手机客户端的显示名
插件	固定的
功能	模块功能，详细可以参见图6-10插件管理中的说明
是否显示	设定选中的模块是否在手机客户端中显示	License申请中必需包含此模块
显示顺序	设定选中的模块在手机客户端该模块组中的显示顺序
内容设置	根据选定的模块设置具体显示的内容范围
图标设置	设置该模块在手机版客户端中的图标，如果不设置则使用默认图标
添加用户	添加用户，设定哪些人可以看此模块组及此模块组中的模块
用户选择	选择人员组，此处的人员组在用户管理中维护，详细见6.4.1
删除	删除当前的用户对象

6.4用户管理

6.4.1用户管理

在左侧菜单点击用户管理进入图6-13的页面，在这里可以对使用emobile的用户进行分组设定

图6-13

6.4.2用户组的管理

当用户鼠标移动到结构树的第一层时会出现 图标，点击后弹出提示框如图6-14所示，这里用户可以添加用户组。

图6-14

当用户移动到已添加的用户组名称时，在用户组名称右侧会多出两个按钮，如图6-15所示，

l         为编辑按钮，点击后可以直接修改当前用户组的名称，如图6-16所示

l         为删除按钮，点击后删除当前用户组，不会判断当前用户组下是否被引用或添加了用户。

图6-15

图6-16

6.4.3添加用户

选定用户组之后点击右侧的添加用户，显示出共享对话框，在这里添加用户，如图6-17所示

图6-17

共享类型有以下5种方式，如图6-18所示

图6-18

共享内容为浏览按钮，用来选择共享的对象，例如共享类型为人员，点击共享内容浏览按钮后显示的就是多人力资源浏览框，如图6-19所示，可以多选添加人员。

图6-19

6.4.4用户策略

仅仅用来显示用户连接的是哪个类型的泛微产品。

6.5.5安全策略

这里是用来增加用户登录安全认证的，点击左侧安全策略后显示如图6-20，emobile提供了4种安全策略，分别为硬件标识码绑定，验证码策略，动态密码策略和动态令牌策略

图6-20

6.5.6硬件标识码策略

当用户选中了硬件标识码后，会显示出登录过手机客户端的用户，如图6-21所示，点击登录用户名之后显示如图6-22，管理员可以在这里添加用户手机标识码。如果登录的人员过多，可以通过姓名、登录名、编号等关键字进行搜索。

图6-21

图6-22

字段	用途
客户端类型	手机版客户端安装的版本，如图6-22所示，有4个版本可以支持
硬件标识码	手机硬件唯一标识码，可以在手机版的设置-关于中查看
是否启用	是否启用此标识码，如果启用了，那么此用户只能用这个手机登录emobile，同一个用户可以启用多个客户端。
是否锁定	锁定的用户是不能在客户端取消掉硬件标识绑定功能的
操作	删除当前的硬件标识码
保存	保存当前硬件标识码设置
返回	返回策略设置页面

6.5.7其它安全策略

标识是针对单一用户设置的，其它3项策略是针对所有用户设置的。

策略	用途
验证码	启用后用户在手机版客户端登录的时候除了要输入用户名和密码之外，还要输入验证码后才能登录
动态密码	用户登录的时候需要输入随机发送的动态密码，这个功能需要ecology本身启用了动态密码功能
动态令牌	用户登录的时候需要输入动态令牌上的验证码才能登录，这个功能需要ecology本身启用了动态令牌功能

 

安装以后出现服务更换IP等情况需要更新

第一章      安装前说明

1.本文档只做为E-mobile4.5服务器端安装配置手册！

2.E-Mobile4.5可运行在windows和linux服务器上

3.E-Mobile4.5必须与ecology服务器互联，因此，

Ø         请确保在E-Mobile所在的服务器上可以通过浏览器访问Ecology；

Ø         请确保E-Mobile所在的服务器能访问Ecology所使用的数据库。

第二章      复制文件

手机版属于非标功能，所以在申请后会给出升级包，升级包中包含了ecology和Emobile两个目录，将ecology目录覆盖原来的ecology目录，将Emobile目录放到mobile服务器上，可以和ecology同一台机器，也可以是不同的机器。

第三章      参数配置

打开ecology/WEB-INF/web.xml文件，需要添加以下参数：

Ø         在文件中搜索关键字 XFireServlet，如果没有就添加以下内容

<servlet>

   <servlet-name>XFireServlet</servlet-name>

   <display-name>XFire Servlet</display-name>

<servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>

</servlet>

<servlet-mapping>

   <servlet-name>XFireServlet</servlet-name>

   <url-pattern>/services/*</url-pattern>

</servlet-mapping>

Ø         在文件中搜索关键字 MobileXmlRpcServlet，如果没有就添加以下内容

<servlet>

       <servlet-name>MobileXmlRpcServlet</servlet-name>

       <servlet-class>org.apache.xmlrpc.webserver.XmlRpcServlet</servlet-class>

       <init-param>

              <param-name>enabledForExtensions</param-name>

              <param-value>true</param-value>

              <description>Mobile XML-RPC.</description>

       </init-param>

</servlet>

<servlet-mapping>

       <servlet-name>MobileXmlRpcServlet</servlet-name>

       <url-pattern>/mobile/xmlrpc</url-pattern>

</servlet-mapping>

Ø         在文件中搜索关键字 Mobile，如果没有就添加以下内容

<filter>

       <filter-name>Mobile</filter-name>

    <filter-class>weaver.mobile.plugin.ecology.MobileFilter</filter-class>

  </filter>

  <filter-mapping>

    <filter-name>Mobile</filter-name>

    <url-pattern>/mobile/plugin/*</url-pattern>

  </filter-mapping>

第四章      启动服务

首先检查emobile的服务参数，在emobile\conf目录下有resin.conf文件，打开后显示如图4-1所示，

l   首先是两个内存参数即xmx和xms，如果是32位操作系统的话，请统一设置为1024m，否则服务无法启动（服务器内存至少2G内存），如果是64位操作系统的话可以根据内存大小定义，具体见附录1。

l   其次是端口配置，默认端口为89，此端口为emobile服务器配置页面端口，详细配置说明见第五章说明。

图4-1

如果是windows平台，请在控制台页面进入到emobile解压的目录下，输入httpd.exe -java_home D:\WEAVER\JDK -install-as ResinMobile（红色文字根据jdk所在路径填写，如果与ecology不在一台服务器上，mobile服务器需放上jdk1.6），安装服务后可以在windows服务管理器中启动emobile服务。

如果是Linux服务器，使用编辑器检查emobile目录下的start.sh文件， /usr/weaver/jdk/bin/java -jar ./lib/resin.jar start &，确保文件中红色标出的部分路径正确，然后直接使用start.sh启动emobile服务。

 

第五章      服务器连接配置

在启动了emobile服务之后，我们开始对emobile服务器进行配置

Ø         第一步：打开浏览器，输入http://ip:89/install，ip地址为emobile服务器的ip地址，89为默认端口，用户可以自行调整（见第四章说明），输入地址后显示如图5-1，这里有两个选项，一个是版本升级（跳第四步），另外一个是新安装（第二步）。

图5-1

Ø         第二步：选择新安装客户后点击图5-1中的下一步，显示如图5-2的内容，这里要输入ecology访问地址，此地址必需是emobile所在服务器可以访问的地址，完成后点击下一步，如果输入的地址无法访问的话会显示如图5-3的错误提示，请检查地址是否正确。

图5-2

图5-3

Ø         第三步：由于是新安装所以系统在验证了地址正确性后显示如图5-4的界面，安装结束，点击登录后继续配置，跳第七步。

图5-4

Ø     第四步：用户已有低版本emobile的时候，选择升级客户后点击下一步，显示如图5-5，这里要输入ecology访问地址，此地址必需是emobile所在服务器可以访问的地址，完成后点击下一步，如果输入的地址无法访问的话会显示如图5-3的错误提示，请检查地址是否正确。

图5-5

Ø         第五步：在数据迁移页面确认访问地址没有问题后点击确定，进行数据迁移，完成后系统会弹出提示框提示迁移成功，显示如图5-6。

图5-6

Ø         第六步：迁移成功确定后显示如图5-7的安装成功页面，点击登录。

图5-7

Ø     第七步：在成功页面点击登录按钮后自动跳转到后台管理登录页面，显示如图5-8所示，输入用户名、密码和验证码后点击登录按钮，管理员用ecology的sysadmin账号，

图5-8

第六章      服务器管理

Emobile后台管理界面我们可以打开浏览器，输入http://ip:89/manager进行访问。mobile的系统管理员就是ecology的默认系统管理员sysadmin，在如图5-8的登录界面输入用户名、密码和验证码之后登录emobile后台管理系统界面中，如图6-1。

图6-1

6.1服务器管理

服务器管理主要是用来监控服务器运行状态的，分为了系统状态、系统日志、系统属性、授权信息4个部分。

6.1.1系统状态

系统状态用来查看服务器的基本安装信息，顶部有“检测系统”按钮，点击后可以查看ecology是否运行正常，在手机版无法访问的时候可以到这里来检测一下是ecology环境出了问题还是emobile环境有问题。

6.1.2系统日志

点击系统日志后显示如图6-2所示，这里可以查看emobile运行的日志，当用户emobile运行不正常的时候，可以到这里查看日志，找出问题。

图6-2

l         刷新：在日志信息页面有刷新按钮，可以动态跟踪刷新日志，如果选择无就是不刷新，用户可以自己定义刷新平率，如图6-3所示，可以设定10秒、30秒、60秒、90秒刷新一次系统日志并显示在日志信息框中。

6-3

l         日志查看排序：用户在查看日志的时候可以自定义顺序或倒序显示。

l         行：因为日志信息框大小的限制及方便用户查看，所以用户可以自定义日志在日志信息框中显示的行数，如图6-4所示。

图6-4

l         下载日志文件：用来下载emobile的运行日志。

6.1.3系统属性

系统属性用来设置手机版客户端的两个显示属性，如图6-5所示,

分页大小：手机版客户端显示工作流、文档每页的显示条数，点击后面的编辑按钮，显示出如图6-6所示页面，用户可以自定义显示条数，也可以选择恢复默认显示条数。

LOGO：手机版登录页面显示的logo，点击后面的编辑按钮，显示出图6-7所示，用户可以自行上传手机版logo，logo图片建议使用png格式的图片，建议尺寸180*150。

图6-5

图6-6

图6-7

6.1.4授权信息

授权信息用来控制emobile登录用户数，可以选在在线获取license，也可以在浏览按钮中选择并上传license，如图6-8所示。

图6-8

6.2插件管理

插件管理是用来设置emobile连接的ecology服务器及相关模块的设置。

6.2.1插件列表

点击插件管理中的插件列表后，显示如图6-9的内容，这里显示了emobile连接的是ecology还是其它泛微软件。

图6-9

点击名称链接或者列表中的详细按钮后，显示如图6-10，如果ecology地址发生了变动，可以在这里进行重新配置。下方的列表显示了当前emobile可以提取ecology中的哪些模块的哪些信息。

图6-10

6.3模块管理

Emobile4.0对功能模块可以进行分组管理并在ipad客户端中显示（对其它客户端无效）。

6.3.1模块组列表

点击左侧菜单模块组管理后显示如图6-11的内容，这里显示了模块组的列表。

图6-11

6.3.2添加模块组

在图6-11中点击添加模块组后显示如图6-12，在这里用户可以给模块起名字，并设置模块组的顺序，添加模块功能，添加的功能就属于这个模块组，使用IPAD访问的时候先访问模块组，然后显示出这个组下面的模块功能，详细可以见《泛微E-Mobile4.0客户端版使用手册-iPad版》；最后可以设定访问这个模块组的用户，只有有权限的用户才能访问该模块下的功能。

图6-12

按钮名称	功能描述	备注
保存	保存当前模块组
删除	删除当前模块组
名称	当前模块组名称	必填
显示顺序	当前模块组在ipad客户端的显示顺序	必填
描述	对当前模块组的文字描述
添加模块	给当前模块组添加功能模块
删除模块	删除当前模块组的功能模块	必需先选中功能模块
Check框	删除模块时必须选中
显示名	模块在手机客户端的显示名
插件	固定的
功能	模块功能，详细可以参见图6-10插件管理中的说明
是否显示	设定选中的模块是否在手机客户端中显示	License申请中必需包含此模块
显示顺序	设定选中的模块在手机客户端该模块组中的显示顺序
内容设置	根据选定的模块设置具体显示的内容范围
图标设置	设置该模块在手机版客户端中的图标，如果不设置则使用默认图标
添加用户	添加用户，设定哪些人可以看此模块组及此模块组中的模块
用户选择	选择人员组，此处的人员组在用户管理中维护，详细见6.4.1
删除	删除当前的用户对象

6.4用户管理

6.4.1用户管理

在左侧菜单点击用户管理进入图6-13的页面，在这里可以对使用emobile的用户进行分组设定

图6-13

6.4.2用户组的管理

当用户鼠标移动到结构树的第一层时会出现 图标，点击后弹出提示框如图6-14所示，这里用户可以添加用户组。

图6-14

当用户移动到已添加的用户组名称时，在用户组名称右侧会多出两个按钮，如图6-15所示，

l         为编辑按钮，点击后可以直接修改当前用户组的名称，如图6-16所示

l         为删除按钮，点击后删除当前用户组，不会判断当前用户组下是否被引用或添加了用户。

图6-15

图6-16

6.4.3添加用户

选定用户组之后点击右侧的添加用户，显示出共享对话框，在这里添加用户，如图6-17所示

图6-17

共享类型有以下5种方式，如图6-18所示

图6-18

共享内容为浏览按钮，用来选择共享的对象，例如共享类型为人员，点击共享内容浏览按钮后显示的就是多人力资源浏览框，如图6-19所示，可以多选添加人员。

图6-19

6.4.4用户策略

仅仅用来显示用户连接的是哪个类型的泛微产品。

6.5.5安全策略

这里是用来增加用户登录安全认证的，点击左侧安全策略后显示如图6-20，emobile提供了4种安全策略，分别为硬件标识码绑定，验证码策略，动态密码策略和动态令牌策略

图6-20

6.5.6硬件标识码策略

当用户选中了硬件标识码后，会显示出登录过手机客户端的用户，如图6-21所示，点击登录用户名之后显示如图6-22，管理员可以在这里添加用户手机标识码。如果登录的人员过多，可以通过姓名、登录名、编号等关键字进行搜索。

图6-21

图6-22

字段	用途
客户端类型	手机版客户端安装的版本，如图6-22所示，有4个版本可以支持
硬件标识码	手机硬件唯一标识码，可以在手机版的设置-关于中查看
是否启用	是否启用此标识码，如果启用了，那么此用户只能用这个手机登录emobile，同一个用户可以启用多个客户端。
是否锁定	锁定的用户是不能在客户端取消掉硬件标识绑定功能的
操作	删除当前的硬件标识码
保存	保存当前硬件标识码设置
返回	返回策略设置页面

6.5.7其它安全策略

标识是针对单一用户设置的，其它3项策略是针对所有用户设置的。

策略	用途
验证码	启用后用户在手机版客户端登录的时候除了要输入用户名和密码之外，还要输入验证码后才能登录
动态密码	用户登录的时候需要输入随机发送的动态密码，这个功能需要ecology本身启用了动态密码功能
动态令牌	用户登录的时候需要输入动态令牌上的验证码才能登录，这个功能需要ecology本身启用了动态令牌功能

 

更换IP的话需要更新

EMobile\webapps\ROOT\WEB-INF\plugin\ecology 下 config.properties和config.xml修改对应IP和端口

ecology修改IP:ecology\WEB-INF\prop下面配置 weaver.properties