TSS 安装指南

使用安装包安装

运行环境:JDK1.7(或JDK1.8)+ Tomcat7 + MySQL + 浏览器

安装JDK

1. 安装:JDK1.7(或JDK1.8)。点击【JDK 下载】,或到 甲骨文官网下载,安装步骤可参照《JDK安装参考》 。安装完成后打开命令行窗口,检查:

  • 输入 java -version,回车,如能正确显示JDK版本,说明已经安装成功;
  • 输入 echo %JAVA_HOME%,看是否正确显示JDK的安装目录,如不行,检查环境变量设置(TOMCAT启动依赖JAVA_HOME)

安装MySQL

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

安装TSS

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为例:

导入项目到Eclipse

1. 在boubei-tss目录下执行 mvn clean eclipse:eclipse,完成后导入boubei-tss目录到Eclipse;

2. 导入成功后,可以开始定制开发。在修改或增删代码后,重复上面 源码安装 步骤,完成发布;

启动Jetty测试

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,再执行具体命令

JDK安装参考

MySQL安装参考


获得帮助:boubei@163.com  TSS社区: http://bbs.boubei.com ,QQ群:162875668