分享

2 安装和部署

 容心居 2019-03-13

运行环境

WebBuilder是一款很通用的平台,支持大多数运行环境,包括但不限于:

  • 操作系统:Linux,Unix,Windows,Mac等

  • JDK环境:Java 8及以上版本(如果使用OpenJDK,需要下载Nashorn包。)

  • Web Server/App Server:Apache Tomcat,Jetty,Resin,WebLogic,WebSphere等所有符合工业标准的服务器

  • 数据库:Sql Server,MySql,Oracle,Db2,Sybase等所有符合工业标准的数据库

  • 浏览器:Chrome,IE,Firefox,Opera,Safari以及其他基于这些内核的浏览器

  • 移动设备:Android,iOS,Windows Phone

安装WebBuilder

通常情况下,只需复制WebBuilder应用目录至目标服务器即可完成安装。使用安装向导的目的是进行数据库表的创建和复制。

安装的主要工作是配置应用服务器的JNDI,关于JNDI的配置可以参考网上的相关文档和资料。

以Tomcat8和Sql Server为例,安装步骤如下(其他运行环境部署步骤可参照此进行):

  1. 安装运行环境:包括Java 8、Tomcat 8和Sql Server。

  2. 解压缩软件包webbuilder.zip,并把软件包根目录内的wb目录复制到tomcat8/webapps。

  3. 在tomcat8/webapps/wb目录下创建META-INF目录,并在META-INF目录下创建context.xml文件以配置JNDI。

  4. context.xml文件内容如下:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE Context>
    <Context reloadable="true" crossContext="true">
        <WatchedResource>WEB-INF/web.xml</WatchedResource>
        <Resource
            name="jdbc/wb_sqlserver"
            auth="Container" type="javax.sql.DataSource"
            driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
            validationQuery="select 1" testWhileIdle="true" testOnBorrow="false"
            url="jdbc:sqlserver://127.0.0.1:1433;DatabaseName=wb"
            username="sa" password="111111"

            maxActive="20" maxIdle="10" maxWait="-1" />
    </Context>

    其中,标记为红色字体部分需要根据目标数据库的实际情况,作相应的更改,指定名称的数据库必须已经存在。在软件包中misc目录下有context.xml文件可作jndi配置参考。

  5. 下载SQL Server驱动jar包 sqljdbc4.jar,并复制该文件至tomcat8/lib目录,如有必要重启tomcat。

  6. 打开浏览器(开发阶段建议使用Chrome)并访问 http://ip:port/wb/setup (例如http://localhost:8080/wb/setup),然后使用安装向导来完成 WebBuilder 的安装。

  7. 在安装向导中有[创建JNDI]按钮,该功能用于辅助创建JNDI,如果我们已经通过上述方法配置完成JNDI,可以不需要使用此功能。直接点击[下一步]按钮即可。

    在安装向导中,输入默认数据库JNDI和类型:

    JNDI:java:comp/env/jdbc/wb_sqlserver
    类型:sqlserver

    输入完成之后点击下一步,直到系统自动完成安装。

  8. 安装完成之后,使用管理员帐户登录到系统,默认首页地址为 http://ip:port/wb/index,管理员默认用户名称和密码都为admin。

  9. 优化Tomcat:可根据目标系统实际情况配置和优化连接池和线程池。

在安装过程中如果发生错误,请尝试按下列方法来解决:

  • 使用的Java版本是否为Java 8及以上版本。

  • 检查创建的默认数据库是否支持中文或utf-8编码。

  • 检查Java和Tomcat的版本是否匹配,比如Java 8应该使用Tomcat 8。

  • 检查tomcat8/conf/Catalina/localhost/wb.xml中的内容是否同jndi配置文件context.xml同步(wb.xml文件名同应用目录名)。

  • 如果安装提示duplicate entry异常,请确认数据库是否设置支持utf-8或gbk编码。

  • 检查数据库驱动jar包是否同数据库版本匹配。

  • 如发生异常NullPointerException,请检查JRE是否支持服务器端JavaScript(Nashorn)。

  • 如仍未能排除异常,请尝试把软件包中misc目录下test-jndi.jsp复制到应用目录wb下并修改相关代码,然后运行以测试jndi有效性。

WebBuilder目录和文件结构

WebBuilder是一个典型的web应用,包括两个目录wb和WEB-INF。

wb目录是WebBuilder资源目录,包括javascript,css,html,图片,模块,配置文件和其他相关文件等,wb目录由以下子目录组成:

  • css:样式表目录,样式表文件建议放在此目录。

  • images:图片目录,图片文件建议放在此目录。

  • libs:前端第三方库目录,包括extjs,bootstrap和touch等。

  • modules:模块根目录,所有模块文件存放于此。此目录受系统保护,客户端无法直接访问。

  • script:客户端JavaScript脚本目录,JavaScript脚本文件建议放在此目录(服务器端的JavaScript文件除外)。

  • system:系统目录,含配置文件、变量文件、数据库文件和服务器端JavaScript文件等。此目录受系统保护,客户端无法直接访问。需要保护的文件可放在此目录下。

WEB-INF目录通常用于存放Java的库文件jar和类文件class。WebBuilder及其第三方jar包放在WEB-INF/lib子目录下。

此外在某些web应用服务器上还有META-INF目录,此目录内通常会有context.xml文件用于配置JNDI数据源。由于不同web应用服务器对JNDI的配置不尽相同,因此该目录在WebBuilder的软件包中默认省略。

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多