# FireflyDaemon

**Repository Path**: cbwfree/FireflyDaemon

## Basic Information

- **Project Name**: FireflyDaemon
- **Description**: 本项目基于firefly v1.3.3dev版本创建.修改底层的启动方式为twisted的守护进程.启动方式为: twistd -y startmaster.py
- **Primary Language**: Python
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 4
- **Created**: 2015-12-31
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#FireflyDaemon

`暂未在Windows下测试, 目前只测试了Mac OS 和 Centos`

本项目将firefly服务端改写为twisted的守护进程程序. 可以直接在后台运行, 不需要像以前一样使用`python startmaster.py &`的方式让程序在后台运行, 且不会像原来一样出现大量的日志写入异常. 另外还修改了master主进程创建各子进程的方式, 同样是使用的twisted的service, 在子进程异常退出后, ProcessMonitor 会自动重启退出的子进程

## 对比Firefly的优势
1. 守护进程可直接在后台运行,避免出现大量的日志写入异常
2. 子进程异常退出后自动重启
3. 增加各进程状态监控接口,支持控制台输出和JSON输出
4. 主进程异常退出也可以正常保存数据
5. 优化了配置文件定义方式,在firefly.server.config下新增Config配置管理模块
6. 停止服务端时,主进程会等待子进程全部退出后再退出.避免重复启动多个实例
7. 各子进程输出日志会带有进程前缀信息, 方便查找问题

## FireflyDaemon 的依赖:
FireflyDaemon的依赖和firefly基本相同，只是多了psutil(扩展WEB管理接口,增加进程状态监控)包
```
pip install psutil
pip install twisted
pip install zope.interface
pip install DBUtils
pip install affinity
pip install python-memcached
pip install MySQL-python
```

## 如何启动服务器
在安装好依赖后，在startmaster.py所在的根目录下执行如下命令(服务端将自动在后台运行, 并按天生成运行日志到`logs/master.log`文件中):
```
twistd -y startmaster.py
```
使用下面的命令将不会在后台运行，也不会创建`logs/master.log`日志(直接使用`Ctrl + C`退出程序即可自动保存数据):
```
twistd -ny startmaster.py
```

## 停止服务
停止服务的方法和firefly相同, 都是访问本地URL:
```
curl http://127.0.0.1:9998/stop
```
但本程序的Master主进程会在所有子进程安全退出后才会退出, 而在master主进程未退出时再次启动服务, 会提示程序已在运行中, 避免出现一不小心运行多个实例的情况

## 查看服务器状态
在服务器启动后可以通过如下命令查看服务器进程的状态:
```
curl http://127.0.0.1:9998/status
```

显示结果如图:

![status](https://git.oschina.net/cbwfree/FireflyDaemon/raw/master/demo/status.png)