其他说明

1. 关于nmon.zip

   用于收集和监控服务器状况，来自于http://nmon.sourceforge.net。

2. 模块介绍及编译

   1. 模块介绍

      1. mq-client-common-open与mq-client-open为客户端模块，它封装了rocketmq-client，客户端需要依赖它才能和MQCloud进行交互。
      2. mq-cloud-common与mq-cloud为MQCloud的web端，实现管理监控等一系列功能。

   2. 编译（maven需要在3.6.3及以上）

      1. mq-client-common-open与mq-client-open最低依赖jdk1.7。

      2. mq-cloud依赖jdk1.8，其采用spring-boot实现。

      3. 编译：

         1. 在sohu-tv-mq/下，执行mvn clean install -pl "!mq-cloud"（linux系统请将"!mq-cloud"改成'!mq-cloud'执行），将编译并install mq-client-common-open，mq-client-open，mq-cloud-common模块

         2. 在sohu-tv-mq/mq-cloud/下，执行mvn clean package，将编译并打包mq-cloud.war

            ​

   因为mq-client-*相关模块会提供给业务端使用，所以如果涉及到mq-client-*中的代码修改，需要在父pom中修改version，然后执行mvn -N versions:update-child-modules ，这样所有的子模块的版本均会更新(com.sohu.tv.mq.util.Version中的版本号也会自动修改)。

   ​

3. 邮件预警实现

   可以到管理后台中的通用配置模块进行mail开头相关选项的配置，便可以直接使用邮件预警机制。

   ​

4. 登录实现

   默认的登录采用用户名密码：com.sohu.tv.mq.cloud.service.impl.DefaultLoginService。

   当然注册和登录都没有进行太多安全性考虑，主要是基于MQCloud要部署到内网使用。

   另外还支持sso登录，可以自行实现类似如下类：

       public class SSOLoginService extends AbstractLoginService {
      
           @Override
           protected void auth(HttpServletRequest request, HttpServletResponse response) {
               // 跳到sso去登录认证
           }
      
           @Override
           protected String getEmail(String ticketKey) {
               // sso回调并携带ticket，这里调用sso进行校验ticket，获取登录id(email)
               return null;
           }
      
           @Override
           public void init() {
               
           }
       }
   

   如果采用sso认证登录，auth和getEmail方法的作用参考如下：

5. RocketMQ搜狐内部版本

   我们对RocketMQ的源码进行了部分修改，并开源到了这里：
   • 4.9.x版本：https://github.com/sohutv/rocketmq/tree/4.9.3-sohu
   • 5.1.x版本：https://github.com/sohutv/rocketmq/tree/5.1.1-sohu-1