Update Guide

预览版2更新到预览版3

1. 下载部署包

   根据系统支持，下载对应的deploy-*.tar.gz部署包（*指的是对应的系统）和update.sql文件，下载完成后本地解压，解压后的文件下文简称本地文件

2. center端更新

   • 删除或备份旧的前端文件，这里直接备份，服务器执行

     mv /root/MagiCude/nginx/dist /root/MagiCude/nginx/dist.bak

   • 修改数据库

     默认MySQL的root不支持远程登录，新增了magicude与root同密码，但magicude用户仅有magicde数据库的select,insert,update,delete权限，需要ssh登录center服务器

     1. 进入MySQL容器 docker exec -it magicude_mysql bash

     2. MySQL容器内执行mysql -u root -p并输入 newPass.txt中MySQL的密码

     3. 进入MySQL shell后，将update.sql中的内容复制到MySQL shell执行即可

   • 更新前端文件

     将本地文件MagiCude/nginx/的dist文件夹复制到服务器 /root/MagiCude/nginx/

   • 更新jar包

     将本地文件MagiCude下的agentapp.jar，centerapp.jar复制到服务器/root/MagiCude（覆盖服务器的文件）

   • 重启服务

     服务器/root/MagiCude下执行./magicude restart

   • 重新导入python插件

     1. 服务重启后，登录web前端，插件库筛选所有python插件，全选后删除

     2. 下载新的python插件

     3. [数据管理-批量导入-python插件]，导入新的Python插件

3. agent端更新

   • 更新jar包

     将本地文件MagiCude下的agentapp.jar复制到服务器/root/MagiCude（覆盖服务器的文件）

   • 重启agent服务

     ./stopAgent.sh
     ./runAgent.sh

其他

Confluence RCE(CVE-2021-26084)插件可到github页面web插件下载，并在[数据管理-批量导入-web插件]导入

---

v2.0.28更新到v2.1

release页面下载v2.1部署包解压

数据库：

1. 本地电脑连接魔方的MySQL数据库后，在magicude数据库执行update.sql，用于新增表和修改部分表信息

center端：

1. 复制deploy\MagiCude的以下文件到center服务器

   centerapp.jar
   agentapp.jar
   update.zip

2. center服务器MagiCude下执行

   ./magicude restart # 重启服务
   sh update.sh # 升级前端

agent端:

1. 复制deploy\MagiCude的以下文件到center服务器

   agentapp.jar
   

2. agent服务器MagiCude下执行

   sh stopAgent.sh # 停止agent
   sh runAgent.sh # 启动agent

---

v2.0.20更新到v2.0.28

release页面下载v2.0.28部署包解压

center端：

1. 复制deploy\MagiCude的以下文件到center服务器MagiCude目录

   centerapp.jar
   agentapp.jar
   update.sh
   update.zip

2. center服务器MagiCude下执行

   ./magicude restart # 重启服务
   sh update.sh # 升级前端

agent端:

1. 复制deploy\MagiCude的以下文件到agent服务器MagiCude目录

   agentapp.jar
   

2. 复制deploy\defaultConf的以下文件到agent服务器MagiCude目录

   stopAgent.sh
   

3. agent服务器MagiCude下执行

   sh stopAgent.sh # 停止agent
   sh runAgent.sh # 启动agent

---

前端更新说明（实验性）

1. 将dist.*.zip更新包和update.sh上传到center服务器的MagiCude目录下
2. 执行update.sh(首次升级需要手动选服务器ip)

---

v2.0.2更新到v2.0.20

release页面下载v2.0.20部署包解压

center端：

1. center服务器执行 magicude stop 停止服务
2. 停止nmap和masscan

kill -9 $(pidof nmap)
kill -9 $(pidof masscan)

3. 复制deploy\MagiCude目录下的centerapp.jar和agentapp.jar到服务器
4. 将center服务器MagiCude下的dist文件夹删除
5. 复制deploy\MagiCude目录下的dist文件夹到center服务器MagiCude目录下
6. 服务器手动修改api地址，需要手填写实际的ip：sed -i "s/127.0.0.1/服务器的实际ip/g" root/MagiCude/dist/static/js/app.*.js
7. 执行 magicude start 启动服务

agent端:

1. 停止nmap和masscan

kill -9 $(pidof nmap)
kill -9 $(pidof masscan)

2. agen服务器执行sh stopAgent.sh
3. 复制deploy\MagiCude目录下的agentapp.jar到agent服务器
4. agen服务器执行sh runAgent.sh

---