docker版jxTMS使用指南

jxTMS是以低成本快速定制为核心诉求的、SaaS模式的业务管理系统二次开发平台&＃xff0c;可参考&＃xff1a;jxTMS简介。建议使用前先阅读&＃xff1a;jxTMS设计思想&＃xff0c;以更好的使用jxTMS。

本次发布为docker版本&＃xff0c;本系列文章主要介绍docker版本的简单使用&＃xff1a;

helloWorld!

helloWorld!讲解

数据库访问

静态web界面

勾连python

导入excel文件

图表显示

准备

1、下拉镜像

因为是docker版本&＃xff0c;所以只要下拉相应的镜像而免去了安装与配置的麻烦&＃xff1a;

docker pull jxandrew/tms


镜像因为预装了java、mysql和rabbitMQ等环境依赖&＃xff0c;所以比较大&＃xff0c;请耐心等待。

2、启动容器

镜像下拉成功后&＃xff0c;执行&＃xff1a;

docker run -itd --name tms --privileged&＃61;true -p 10022:22 -p 10018:10018 jxandrew/tms


即可启动一个名为tms的容器。该容器使用到了三个端口&＃xff1a;

• 10022端口&＃xff0c;该端口映射到容器的22端口&＃xff0c;用于ssh/sftp。其中ssh主要用于显示log&＃xff0c;sftp主要用于上传定制代码

• 10018端口&＃xff0c;是web访问的主端口

tms容器启动后&＃xff0c;可执行&＃xff1a;

docker attach tms


连接到tms容器的root用户控制台&＃xff0c;某些时候我们需要通过该控制台执行一些任务。

注&＃xff1a;在该root用户控制台退出时&＃xff0c;即执行了exit命令&＃xff0c;可能会同时自动关闭tms容器

关闭容器&＃xff0c;可执行&＃xff1a;

docker stop tms


容器关闭后&＃xff0c;如需再次启动&＃xff0c;则执行&＃xff1a;

docker start tms


3、启动jxTMS

启动容器&＃xff1a;

docker start tms


连接到tms容器的root用户控制台&＃xff1a;

docker attach tms


启动jxTMS&＃xff0c;可执行下述命令&＃xff1a;

#进入tms所在目录
cd /home/tms
#启动jxTMS
./startTMS


startTMS是一个unix的shell脚本&＃xff1a;

#!/bin/bash
service ssh start
service mysql start
cd /var/run
rm -f rsync*
service rsync start
service rabbitmq-server start
cd /home/tms
java -jar tms.jar&


注1&＃xff1a;rabbitMQ启动时间很长&＃xff0c;而且启动完就立刻启动jxTMS&＃xff0c;有时还会连不上&＃xff0c;所以笔者又在脚本中加了sleep 5以进行等待。如果启动还不成功&＃xff0c;要先杀掉jxTMS进程&＃xff0c;然后手动执行&＃xff1a;java -jar tms.jar&

注2&＃xff1a;jxTMS是设计用来作为服务程序一直执行的&＃xff0c;所以没有关闭命令&＃xff0c;如果想关闭jxTMS需要手动杀掉jxTMS进程&＃xff1a;

#查看jxTMS进程号
psg java
#该脚本会显示所有命令行中带java的进程&＃xff0c;找到【java -jar tms.jar】所在行&＃xff0c;开头的数字就是进程号
#kill 12345


startTMS非常简洁&＃xff0c;就是依次启动sshd、mysql、rsync、rabbitmq四个服务&＃xff0c;然后用java来启动jxTMS的jar包。

注&＃xff1a;jxTMS是以java8开发的&＃xff0c;千万不要升级java环境

rabbitMQ启动时间很长&＃xff0c;所以启动过程需要花费几分钟的时间&＃xff0c;请耐心等待一下。脚本执行完毕&＃xff0c;会有大量的log信息出现&＃xff0c;忽略log中的日期和代码位置等信息后&＃xff0c;最后会出现&＃xff1a;

org.demoOrg_2255【org/demoOrg_2255】添加到目录中
org.demoOrg_2255 register:ok/服务器正常响应
org.demoOrg_2255 connected


看到这些信息&＃xff0c;就表明jxTMS启动成功&＃xff0c;同时我们预先创建的组织【demoOrg_2255】也已经成功注册到jxTMS中&＃xff0c;我们就可以登录到该组织中开始使用了。

注&＃xff1a;如果长时间不动&＃xff0c;控制台可能会有如下报错&＃xff1a;

** BEGIN NESTED EXCEPTION ** javax.net.ssl.SSLException
MESSAGE: closing inbound before receiving peer&＃39;s close_notifySTACKTRACE:......** END NESTED EXCEPTION **


该报错其实是mysql连接池在释放多余的连接&＃xff0c;忽略即可。

4、系统日志

上述报错信息会影响对系统运行情况的观察&＃xff0c;同时控制台log如果数据量太大&＃xff0c;如启动日志&＃xff0c;前面的日志信息就会看不到了。可执行如下命令来查看系统日志&＃xff1a;

cd /home/tms/logs
#查看实时日志
tail -f rolling.log
#查看倒数xxx行的日志&＃xff0c;同时可以分页慢慢看
tail -n xxx rolling.log | more
#从头分页看日志&＃xff0c;但数量比较多&＃xff0c;不好定位
more rolling.log


注&＃xff1a;系统日志中只包含平台相关的log信息&＃xff0c;开发者一般是不需要关心系统日志&＃xff0c;而更关心的是自己所需定制的组织的日志信息。各组织的运行信息和用户操作信息由组织日志提供&＃xff0c;后面会予以具体讲解

参考资料&＃xff1a;

jxTMS设计思想

jxTMS编程手册

下面的系列文章讲述了如何用jxTMS开发一个实用的业务功能&＃xff1a;

如何用jxTMS开发一个功能

下面的系列文章讲述了jxTMS的一些基本开发能力&＃xff1a;

jxTMS的HelloWorld