Actions

Difference between revisions of "ICX-Alphacom Core tcpdump"

From Zenitel Wiki

(Created page with "{{I}}This article describes how to install ICX-Core in a VirtualBox environment. ==Prerequisites== * Virtual machine: VirtualBox (version 6.0 is used in this guide): https://...")
 
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{I}}This article describes how to install ICX-Core in a VirtualBox environment.
+
{{I}}This article describes how to use TCPdump to take a packet trace from the ICX-AlphaCom Core Ubuntu environment
  
 
==Prerequisites==
 
==Prerequisites==
−
* Virtual machine: VirtualBox (version 6.0 is used in this guide): https://www.virtualbox.org/
 
−
* Operating System: Ubuntu 18.04.x LTS Server (Mandatory): http://releases.ubuntu.com/18.04/
 
−
* File transfer software: WinSCP (version 5.15.3 used in this guide): WinSCP https://winscp.net/eng/index.php
 
−
* ICX-Core software: [[Downloads#ICX_System|ICX System]]
 
  
−
{{Note|The virtual machine must have an internet connection during the installation process}}
+
*SSH Console software: PuTTY https://www.putty.org/
 +
*File transfer software: WinSCP (version 5.15.3 used in this guide): WinSCP https://winscp.net/eng/index.php
 +
*Wireshark: https://www.wireshark.org/
 +
*The SSH port (22) enabled in the firewall of the ICX-AlphaCom Core.
  
−
==VirtualBox==
+
==Login to the ICX-AlphaCom Core Ubuntu environment==
−
After downloading and installing VirtualBox, run the software and create the virtual machine by clicking "'''New'''":
+
Using PuTTY, enter the IP Address of the ICX-AlphaCom Core Ubuntu environment.  SSH (port 22) must be enabled in the firewall.
−
[[File:ICX VB1.png|thumb|left|500px]]
+
[[File:Putty Linux.PNG|473x473px|alt=|left|frameless]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
−
Give your machine a name, set '''Type''' = Linux,  and set '''Version''' = Ubuntu:
+
Login to the Ubuntu console using the login details created during Ubuntu installation.
−
[[File:ICX VB2.png|thumb|left|500px]]
+
[[File:ICX-AlphaCom Core Ubuntu login.jpg|alt=|left|frameless]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
−
The memory must be at least 1GB:
+
Alternatively, if you have console access via the physical machine, or you are using a Virtual Machine Host such as VirtualBox or ESXi, you can login via this console.
−
[[File:ICX VB3.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
  
−
Create the virtual HDD:
+
==TCPdump==
−
[[File:ICX VB4.png|thumb|left|500px]]
+
TCPdump is the linux tool to take a packet trace in the console.  To enable a packet trace of all packets into a file named icxcore.pcap in the current directory, use the following command;
−
<br style="clear:both;" />
 
  
−
Select the HDD type:
+
sudo tcpdump -s 0 -w icxcore.pcap
−
[[File:ICX VB5.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
  
−
Physical HDD storage:
+
You will need to enter the root password for Ubuntu created during installation.
−
[[File:ICX VB6.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
  
−
The HDD must be minimum 15GB:
+
The packet trace will commence immediately, and will only stop when requested to by issuing the escape code CTRL + C.
−
[[File:ICX VB7.png|thumb|left|500px]]
+
[[File:Tcpdump.jpg|left|frameless|729x729px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
−
After the creation of the virtual machine is finished, select and set some '''Settings''' before starting:
+
If your Ubuntu environment has more than 1 Ethernet adapter, you can use the -i flag to choose the correct adapter.  Adapter names and IP Addresses are listed at login.
−
[[File:ICX VB8.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
  
−
In '''Storage''', browse for the OS .iso file (Ubuntu 18.04.x LTS Server) and mount it:
+
sudo tcpdump -i <adapter> -s 0 -w icxcore.pcap
−
[[File:ICX VB9.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
  
−
Set up the '''Network''' connection:
+
There are many options for TCPdump, and you can do further reading here using the command man tcpdump
−
* Choose '''Bridged Adapter''', and select which interface to use for the ICX-Core
 
−
[[File:ICX VB10.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
  
−
Now '''Start''' the machine:
+
==Copy the file via WinSCP==
−
[[File:ICX VB11.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
  
−
==Ubuntu==
 
−
The Ubuntu installation will automatically launch after '''Start''' in the previous section. Choose your language:
 
−
[[File:ICX VB12.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
  
−
Define your keyboard:
+
Using WinSCP, connect to the Ubuntu environment using the IP Address, username and password.
−
[[File:ICX VB13.png|thumb|left|500px]]
+
[[File:ICX VB27.png|left|frameless]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
−
Confirm the network adapter:
+
... and copy the capture file to your computer from the Ubuntu environment:
−
[[File:ICX VB14.png|thumb|left|500px]]
+
[[File:Download PCAP.jpg|left|frameless|416x416px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
−
 
−
Enter Proxy if needed:
 
−
[[File:ICX VB15.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
Confirm mirror:
 
−
[[File:ICX VB16.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
Filesystem:
 
−
[[File:ICX VB17.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
Select HDD:
 
−
[[File:ICX VB18.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
Confirm partition:
 
−
[[File:ICX VB19.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
Confirm installation:
 
−
[[File:ICX VB20.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
Enter profile and credentials. VERY important to not forget this. Write it down!:
 
−
[[File:ICX VB21.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
{{Note|The selected Username will also name the host folder for the ICX-Core}}
 
−
 
−
Select Install OpenSSH server:
 
−
[[File:ICX VB22.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
Skip:
 
−
[[File:ICX VB23.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
The installation is now running:
 
−
[[File:ICX VB24.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
Installation complete! Hit Enter key to reboot:
 
−
[[File:ICX VB25.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
The virtual machine reboots and starts up with Ubuntu running in terminal mode.
 
−
 
−
==ICX-Core==
 
−
Log in with the username and password defined earlier. Use command "'''ip a'''" to see the IP address that the virtual machine has:
 
−
[[File:ICX VB26.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
Connect to the virtual machine with WinSCP ...
 
−
[[File:ICX VB27.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
... and copy the ICX-Core installation file from your computer to the virtual machine:
 
−
[[File:ICX VB28.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
−
 
−
{{Note|the target folder must be ''/home/[Username]/'}}
 
  
 
Close WinSCP.
 
Close WinSCP.
  
−
Install ICX-Core using the command (case sensitive):
+
<br />
−
{{code|sudo tar -xf ICX-Core-01.00-bionic-1.0.3.0.apt.tar install.sh --to-command /bin/sh}}
 
−
Where ''ICX-Core-01.00-bionic-1.0.3.0.apt.tar'' is the ICX-Core file name.
 
−
[[File:ICX VB29.png|thumb|left|500px]]
 
−
<br style="clear:both;" />
 
  
−
After installation, you can access the [[ICX Web]] from any PC in the network by using the IP address of the virtual machine.
+
==Wireshark==
−
[[File:ICX VB30.png|thumb|left|500px]]
+
You can now use Wireshark to inspect the packet trace, or send the trace to Support for further assistance.  
−
<br style="clear:both;" />
 
  
 
[[Category: ICX-AlphaCom Platform]]
 
[[Category: ICX-AlphaCom Platform]]
 +
[[Category: ICX-Core]]

Latest revision as of 08:21, 7 June 2022

Icx icon.png

This article describes how to use TCPdump to take a packet trace from the ICX-AlphaCom Core Ubuntu environment

Prerequisites

Login to the ICX-AlphaCom Core Ubuntu environment

Using PuTTY, enter the IP Address of the ICX-AlphaCom Core Ubuntu environment. SSH (port 22) must be enabled in the firewall.


Login to the Ubuntu console using the login details created during Ubuntu installation.


Alternatively, if you have console access via the physical machine, or you are using a Virtual Machine Host such as VirtualBox or ESXi, you can login via this console.

TCPdump

TCPdump is the linux tool to take a packet trace in the console. To enable a packet trace of all packets into a file named icxcore.pcap in the current directory, use the following command;

sudo tcpdump -s 0 -w icxcore.pcap

You will need to enter the root password for Ubuntu created during installation.

The packet trace will commence immediately, and will only stop when requested to by issuing the escape code CTRL + C.

Tcpdump.jpg


If your Ubuntu environment has more than 1 Ethernet adapter, you can use the -i flag to choose the correct adapter. Adapter names and IP Addresses are listed at login.

sudo tcpdump -i -s 0 -w icxcore.pcap

There are many options for TCPdump, and you can do further reading here using the command man tcpdump

Copy the file via WinSCP

Using WinSCP, connect to the Ubuntu environment using the IP Address, username and password.

ICX VB27.png


... and copy the capture file to your computer from the Ubuntu environment:

Download PCAP.jpg


Close WinSCP.


Wireshark

You can now use Wireshark to inspect the packet trace, or send the trace to Support for further assistance.

Retrieved from "https://wiki.zenitel.com/w/index.php?title=ICX-Alphacom_Core_tcpdump&oldid=229347"