运行环境:JDK1.7(或JDK1.8)+ Tomcat7 + MySQL + 浏览器
1. 安装:JDK1.7(或JDK1.8)。点击【JDK 下载】,或到 甲骨文官网下载,安装步骤可参照《JDK安装参考》 。安装完成后打开命令行窗口,检查:
2. 安装MySQL(如已有安装MySQL忽略本步骤). Windows可点此下载MySQL5.5安装包,参照《MySQL5.5安装指南》进行安装;
3. 在MySQL创建一个名为tssbi的数据库,下载并导入初始化数据库tss_ebi.sql.zip(先解压)到该库:
1、打开命令行窗口,输入下面登录MySQL:mysql -u root -p 2、创建数据库:create database tssbi; 3、新开一个命令行窗口,导入初始库:mysql -u root -p tssbi < D:/tss_ebi.sql
常见问题: Q:如果导入MySQL时报错: ERROR at line 332: Unknown command '\''. A:编码问题导致,带上参数--default-character-set=utf8, 如:mysql -u root -p --default-character-set=utf8 scm < tssbi.sql
4. 点击下载TSS安装包tss.zip(已集成Tomcat7)。
5. 解压tss.zip(注:解压目录里不要含有中文或空格),在tomcat-ebi/webapps/tss/下,找到WEB-INFO/classes/application.properties,打开编辑(写字板 或 sublime等均可以打开),修改以下信息为你本地的MySQL库信息:
db.connection.username tssbiu1 ---> 你的MySQL账号 db.connection.password www.boubei.com ---> 你的MySQL密码 db.connection.url jdbc:mysql://127.0.0.1:3306/ebi ---> jdbc:mysql://127.0.0.1:3306/tssbi
6. 启动Tomcat(windows环境进去tomcat-ebi/bin目录,双击startup.bat; linux环境在shell里输入 ./startup.sh,回车)。
常见问题: Q:windows如果出现启动Tomcat一闪而过? A:尝试在tomcat-ebi/bin目录,打开命令行窗口输入startup.bat 回车执行,可以查看详细的错误信息。一般启动异常的原因有:9090端口被占用(多次打开了Tomcat)、JAVA_HOME环境变量没设置正确等。
打开浏览器(推荐使用谷歌Chrome浏览器,可搜索或点击【 chrome 下载 】)访问:http://127.0.0.1:9090/tss,账号: Admin,密码: www.boubei.com 。
登录后看到的是一个空的BI,可以参照案例《在线开发案例-营业记账》 来快速搭建一个微型的业务系统。
更多案例参考TSS官网演示环境:http://demo.boubei.com/,账号: demo,密码: www.boubei.com 。
运行环境:JDK1.7(或JDK1.8)+ Tomcat7 + MySQL + Maven3,在源码安装TSS前先逐一安装好。
1. 使用Git clone最新的源码到本地:https://github.com/boubei-com/boubei-tss.git,或直接下载TSS源码压缩包。
2. 在MySQL创建一个名为tssbi的数据库,并导入初始化数据库 tss_ebi.sql.zip,参考#下载导入初始化库1#
3. 打开boubei-tss/pom.xml,拉到文件底部,修改打包配置
<profile> <id>dev</id> ...... <db.username>你的MYSQL账号</db.username> <db.password>你的MYSQL密码</db.password> <db.url>127.0.0.1:3306/tssbi</db.url> ...... </profile>
4. 打开CMD命令行窗口,切换到boubei-tss所在目录,执行 mvn clean install -Dmaven.test.skip=true 进行打包,窗口出来 BUILD SUCCESS字样说明打包成功。
注:如果是初次执行mvn命令,整个过程需要花比较长的时间(需要从maven中心库下载很多项目依赖的jar包),
5. 打包完成后从boubei-tss/target/tss.war包拷贝到Tomcat/webapps目录下,删除原来的tss目录,并重新启动Tomcat
6. 打开浏览器(推荐chrome)进行访问,http://127.0.0.1:9090/tss,账号: Admin,密码: www.boubei.com 。
如果希望浏览TSS的源码或进行后端Java定制开发,可将TSS导入到JAVA IDE中,下面以导入到Eclipse为例:
1. 在boubei-tss目录下执行 mvn clean eclipse:eclipse,完成后导入boubei-tss目录到Eclipse;
2. 导入成功后,可以开始定制开发。在修改或增删代码后,重复上面 源码安装 步骤,完成发布;
3. 调试阶段,推荐直接使用Jetty作为web容器来启动服务,TSS默认集成jetty(服务端口默认9000),在boubei-tss目录下执行 mvn clean jetty:run即可完成服务部署,打开浏览器(推荐chrome)进行访问,http://127.0.0.1:9000/tss,账号: Admin,密码: www.boubei.com 。
Q: 如何连接oracle数据源? A: 手动把boubei-tss/tools目录下oracle的驱动程序ojdbc-14.jar,拷贝到发布后项目的Tomcat/webapps/tss/WEB-INF/lib下,然后重新启动Tomcat。 或者,打包前放开boubei-tss/pom.xml的对oracle驱动的注释,同时把驱动jar包发布到你本地的maven中心库,在boubei-tss目录下执行mvn命令: mvn install:install-file -DgroupId=ojdbc -DartifactId=ojdbc -Dversion=14 -Dpackaging=jar -Dfile=tools/ojdbc-14.jar Q: windows下如mvn、mysql命令无法运行? A: 先检查环境变量path是否配置,如配置正确还是无法运行,再尝试用”管理员身份运行“CMD,再执行具体命令