| 1 |
1. INTRODUCTION |
|---|
| 2 |
|
|---|
| 3 |
MwSubmitter is a program which submits potential malware samples collected by |
|---|
| 4 |
MwWatcher and MwFetcher to central sample server using G.O.T.E.K. protocol. It |
|---|
| 5 |
consists of one shell script file and one ELF executable file (i.e. G.O.T.E.K. |
|---|
| 6 |
client).It now runs only under Linux. |
|---|
| 7 |
|
|---|
| 8 |
MwSubmitter is a free software, released under the GPL; see the file LICENSE for |
|---|
| 9 |
details. |
|---|
| 10 |
|
|---|
| 11 |
2. QUICK START |
|---|
| 12 |
|
|---|
| 13 |
Run mwsubmitter to begin monitor and submit: |
|---|
| 14 |
|
|---|
| 15 |
mwsubmitter -s <SERVER> -c <CONFIG_FILE> |
|---|
| 16 |
|
|---|
| 17 |
To scan and submit only once: |
|---|
| 18 |
|
|---|
| 19 |
mwsubmitter -s <SERVER> -d <SCAN_DIR> -u <USER_NAME> -k <KEY_FILE> |
|---|
| 20 |
|
|---|
| 21 |
For more information, please read the MwSubmitter Manual. |
|---|
| 22 |
|
|---|
| 23 |
3. REQUIREMENTS |
|---|
| 24 |
|
|---|
| 25 |
To run MwSubmitter, you must have: |
|---|
| 26 |
|
|---|
| 27 |
Bash shell, version 3.0 or above; |
|---|
| 28 |
At least one submit account and corresponding keyfile. |
|---|
| 29 |
|
|---|
| 30 |
4. SETUP |
|---|
| 31 |
|
|---|
| 32 |
4.1 SETUP FROM PACKAGE |
|---|
| 33 |
|
|---|
| 34 |
Download MwSubmitter package, decompress and extract it: |
|---|
| 35 |
|
|---|
| 36 |
tar -zxf mwsubmitter.tar.gz |
|---|
| 37 |
cd MWSUBMITTER |
|---|
| 38 |
su |
|---|
| 39 |
./install |
|---|
| 40 |
|
|---|
| 41 |
4.2 SETUP FROM SVN |
|---|
| 42 |
|
|---|
| 43 |
Download latest version of Gotek Client: |
|---|
| 44 |
|
|---|
| 45 |
svn co https://svn.mwcollect.org/gotek/client/ |
|---|
| 46 |
cd gotekc/trunk |
|---|
| 47 |
make |
|---|
| 48 |
su |
|---|
| 49 |
make install |
|---|
| 50 |
|
|---|
| 51 |
Download latest version of MwSubmitter: |
|---|
| 52 |
|
|---|
| 53 |
svn co https://svn.mwcollect.org/honeybow/trunk/mwsubmitter |
|---|
| 54 |
cd mwsubmitter |
|---|
| 55 |
su |
|---|
| 56 |
./install |
|---|
| 57 |
|
|---|
| 58 |
5. CONFIGURATION |
|---|
| 59 |
|
|---|
| 60 |
MwSubmitter accept config file with following format: |
|---|
| 61 |
|
|---|
| 62 |
<SCAN_DIR> <USER_NAME> <KEY_FILE> |
|---|
| 63 |
|
|---|
| 64 |
For example: |
|---|
| 65 |
|
|---|
| 66 |
/tmp/samples vmpot /root/submitter/vmpot.key |
|---|
| 67 |
|
|---|
| 68 |
For more information, please read MwSubmitter Manual. |
|---|
| 69 |
|
|---|
| 70 |
6. GETTING MORE INFORMATION |
|---|
| 71 |
|
|---|
| 72 |
If you have any question about MwSubmitter or have bug(s) found, please write to |
|---|
| 73 |
Song Chengyu |
|---|
| 74 |
songchengyu@icst.pku.edu.cn |
|---|
| 75 |
cs@mwcollect.org |
|---|
| 76 |
Jianwei Zhuge |
|---|
| 77 |
zhugejianwei@icst.pku.edu.cn |
|---|
| 78 |
|
|---|
| 79 |
-- |
|---|
| 80 |
The Artemis Project (Chinese Honeynet Project) |
|---|
