Basic "How To" slides for Ostinato, network packet crafter/traffic generator and analyzer with a friendly GUI. グラフィカルにパケット作成＆送信＆キャプチャ（解析）が可能な "Ostinato" を初めて使う人向けの How To スライドです。 リモートにあるホストからのパケット送信や、Python API もサポートする便利ツール。

1. Introduction to
Ostinato
Packet Traffic Generator and Analyzer
Twitter: @ebiken | ebiken@gmail.com
Introduction to "OSTINATO" | 2015/12/09 1

2. List of Contents ｜目次
• What is “OSTINATO”
• Overview of OSTINATO
• Installation (Windows)
• Installation (Linux/Ubuntu)
• Steps to use Ostinato
• Connecting to remote drone
• Import / Export Stream
• Links
• “OSTINATO” とは？
• OSTINATO全体構成
• インストール方法 (Windows)
• インストール方法 (Linux/Ubuntu)
• 利用手順
• リモートの drone に接続
• ストリームのインポート/エクスポート
• リンク集
Introduction to "OSTINATO" | 2015/12/09 2

3. What is “OSTINATO”｜“OSTINATO” とは？
• Ostinato is …
• Network packet crafter/traffic generator and analyzer with a friendly GUI.
• Use via GUI or Python API.
• Runs on Windows, Linux, BSD and Mac OS X.
• OpenSource (GNU GPLv3)
• Ostinato とは？
• グラフィカルにパケット作成＆送信＆キャプチャ（解析）が可能
• GUIに加え、Python API 経由でのパケット送信
• Windows, Linux, BSD, Mac OS X で動作
• OpenSource (GNU GPLv3)
Introduction to "OSTINATO" | 2015/12/09 3

4. Overview of OSTINATO｜OSTINATO全体構成
Introduction to "OSTINATO" | 2015/12/09 4
drone
(controller)
ports
Ostinato GUI
(agent)
ports
• User interface to craft packets | start/stop traffic.
パケット作成（編集） ｜ トラフィック開始・停止
• Agent could be Python script.
Agent 機能は Python script でも実行可能
Note: Naming of agent and controller is a bit confusing.
Be careful when reading documents.
agent / controller のネーミングが誤解を招きやすいので注意
• Send / Receive packets
パケット送受信を実行
• could run on different host
異なるホスト上で動作可能
drone
(controller)

5. Installation｜ インストール方法 (Windows)
1. Install Winpcap ｜ Winpcap をインストール
• https://www.winpcap.org/
2. Download binary ｜ バイナリをダウンロード
• http://ostinato.org/downloads.html#binary-packages
3. Extract and Run ｜ 展開して実行
• By running “ostinato.exe” (GUI), “drone.exe” will be also
executed in background.
• “ostinato.exe” (GUI) を起動すると、バックグラウンドで
“drone.exe” も実行される。
Introduction to "OSTINATO" | 2015/12/09 5

6. Installation｜ インストール方法 (Linux/Ubuntu)
$ sudo apt-get install ostinato
• This will install related packages like wireshark.
• wireshark等、関連パッケージもインストールされる。
$ sudo ostinato
• By running “ostinato” (GUI), “drone” will be also executed in background.
• “ostinato” (GUI) を起動すると、バックグラウンドで “drone” も実行される。
Introduction to "OSTINATO" | 2015/12/09 6
ebiken@u1510d:~$ which ostinato
/usr/bin/ostinato
ebiken@u1510d:~$ which drone
/usr/bin/drone
!! root privilege required !!

7. Steps to use Ostinato | 利用手順
1. Remove unnecessary ports
2. Craft Streams
• Stream = Packet to send
3. Apply stream settings
• To send stream settings to drone
(controller)
4. Send packets (Start Tx)
5. Start Capture
1. 不要なポートを削除
2. ストリームの作成
• Stream = 送信するパケット
3. ストリームの適用（Apply）
• drone (controller) へストリーム設
定を送信
4. パケットの送信 （Start Tx）
5. パケットのキャプチャ
Introduction to "OSTINATO" | 2015/12/09 7

8. 0. Run Ostinato (GUI)｜Ostinato起動
Introduction to "OSTINATO" | 2015/12/09 8
Port Group and Ports
• Port Group = drone (Controller)
• By default, Ostinato will connect to
the drone running on localhost.
• デフォルトでは同じホストのdrone
(port group) に接続している
Stream settings (per port)
ポート毎のストリーム設定
• You would add stream here
• ここにストリームを追加する
Start / Stop Stream, Capture
Clear Stats
ストリームやキャプチャの開始/停止
統計情報のクリア
Status & Statistics info per Port.
ポート毎の状態＆統計情報

9. 1. Remove unnecessary ports｜不要なポートを削除
Introduction to "OSTINATO" | 2015/12/09 9
• By default, there are many unnecessary ports listed.
• Remove them by adding configuration file: Ostinato.ini
• デフォルトでは不要なポートが表示されている
• 設定ファイルを追加する事により削除可能： Ostinato.ini
ex: any (…) , bluetooth-monitor (…)
Linux:
• Create ~/.config/Ostinato.ini
• ~/.config/Ostinato.ini を作成
Windows:
• Create in same folder as ostinato.exe, drone.exe
• 実行ファイル（ostinato.exe, drone.exe）のあるフォルダに作成
More details noted here ｜ 詳細はこちら
• https://github.com/pstavirs/ostinato/wiki/Settings#drone
~$ cat .config/Ostinato.ini
[PortList]
Include=
Exclude=bluetooth*,any*
bluetooth*,any* was removed

10. 2. Craft Streams｜ストリームの作成
Introduction to "OSTINATO" | 2015/12/09 10
2. Right Click and Select “New Stream”
2. 右クリックして “New Stream” を選択
1. Select port to send packet from
1. パケットを送信したいポートを選択
3. Stream will be added
3. ストリームが追加される

11. 2. Craft Streams｜ストリームの作成
Introduction to "OSTINATO" | 2015/12/09 11
5. Select “Goto” ｜ “Goto” 設定の選択
Behavior after sending the stream.
Recommend “Goto first” for testing.
ストリームを流した後の動作
テストには “Goto first” がお勧め
4. Enter any name you like
4. 名前を設定（任意）
6. Click to “Edit Stream”
6. クリックしてストリームを編集

12. 2. Craft Streams｜ストリームの作成
Introduction to "OSTINATO" | 2015/12/09 12
Example Crafting IPｖ4/UDP Stream
IPｖ4/UDPストリームの設定例

13. 2. Craft Streams｜ストリームの作成
Introduction to "OSTINATO" | 2015/12/09 13
(1)
(2)
(4)
(3)

14. 3. Apply stream settings｜ストリームの適用（Apply）
Introduction to "OSTINATO" | 2015/12/09 14
Do NOT forget to click “Apply” after crafting stream.
This will send stream configuration to drone (controller)
ストリームの設定完了後は必ず “Apply” をクリック。
ストリーム設定が drone (controller) へ投入されます。

15. 4. Send packets (Start Tx)｜パケットの送信 （Start Tx）
Introduction to "OSTINATO" | 2015/12/09 15
5. Start Capture｜パケットのキャプチャ
3. Start / Stop sending packets
3. パケット送信の開始・停止
2. Start / Stop packet capture
2. パケットキャプチャの開始・停止
1. Select “ALL Cells” or the port before start/stop (blue)
1. 開始・停止前にポートの「全てのセル」を選択（青）
Make sure Transmit / Capture State is “On”
Transmit / Capture State が “On” になっている事を確認

16. Introduction to "OSTINATO" | 2015/12/09 16
5. Start Capture｜パケットのキャプチャ
“View Capture Buffer”
• Wireshark will start by clicking here.
• クリックするとWiresharkが起動。
• You can see packets you crafted are
sent via the port.
• 作成したパケットが送信されている
事を確認できる。

17. Connecting to remote drone｜リモートの drone に接続 (1/4)
Introduction to "OSTINATO" | 2015/12/09 17
drone
(controller)
ports
Ostinato GUI
(agent)
ports
drone
(controller)
NEW !!
Windows10
Ubuntu15.10
on VirtualBox
Port Forwarding
config on VirtualBox
TCP 8888 -> 7878
TCP port 7878

18. Connecting to remote drone｜リモートの drone に接続 (2/4)
Introduction to "OSTINATO" | 2015/12/09 18
ebiken@u1510d:~$ sudo drone
…
The server is running on 0.0.0.0: 7878
Version: 0.7.1
Revision: da551b378f72@
1. Run “drone” on Ubuntu
1. Ubuntuで “drone” を起動
2. Run “Ostinato GUI” on Windows
2. Windows で “Ostinato GUI” を起動

19. Connecting to remote drone｜リモートの drone に接続 (3/4)
Introduction to "OSTINATO" | 2015/12/09 19
3. Right click and then select “New Port Group”
3. 右クリックの後 “New Port Group” を選択
4. Enter “address:port” and then click “OK”
4. “address:port” を設定後、”OK” をクリック

20. Connecting to remote drone｜リモートの drone に接続 (4/4)
Introduction to "OSTINATO" | 2015/12/09 20
5. You can confirm remote ports are added
5. リモートにあるポートが追加された

21. Import / Export Stream｜ストリームのインポート/エクスポート
Introduction to "OSTINATO" | 2015/12/09 21
Select Port -> Stream and Right Click to Open/Save streams.
ポート -> ストリーム と選択。
右クリックでストリームのインポート・エクスポートが可能。
3 formats supported | ３つのファイル形式をサポート
• Ostinato native ｜ 独自フォーマット
• PCAP/PDML (Wireshark / tcpdump)
• Python script
• Export only｜エクスポートのみ
• Used to control drone via Python script.
• droneを Python script で操作する際に利用可能

22. Links｜ リンク集
• Ostinato Home Page (Official)
• http://ostinato.org/
• Binary Download : http://ostinato.org/downloads.html
• Ostinato Users Guide (Official)
• https://github.com/pstavirs/ostinato/wiki/UserGuide
• More details of what explained in this document.
• このドキュメントで説明した内容の詳細
• Ostinato Mailing List (Official)
• https://groups.google.com/forum/#!forum/ostinato
Introduction to "OSTINATO" | 2015/12/09 22

23. Introduction to "OSTINATO" | 2015/12/09 23