Building a network
Devices
The 24 kinds of device, how to add, name, copy and delete them, and what the colour of their drawing says.
A device is one piece of the drawing: a PC, a switch, a router, a server. Each is drawn with its name under it and, below the name, its address. A device is made from a template, and PixelCake comes with 24 of them, one for each kind below. Anything the engine decides, from whether a packet crosses a device to which address a name stands for, starts from what is written on the devices and on the cables between them.
The 24 kinds
The kinds differ in two ways: whether the device has numbered ports or network cards, and what the engine does with traffic that is not for it.
| Kinds | Ports or cards | What the engine does with traffic that is not for the device |
|---|---|---|
| Router, Firewall | Ports, each with its own address. A firewall also has security zones and rules | Forwards it from one network to another, by its routing table. A firewall also filters it |
| Switch | Ports, each in a VLAN or a trunk | Forwards it inside one network, VLAN by VLAN |
| Access Point, IoT Gateway | Network cards | Forwards it inside one network, between its cards |
| Load Balancer, Cloud | Network cards | Nothing is simulated: the traffic is taken to pass, and the answer says so in a note |
| Server, Mail Server, VPS, Web Server, Proxy Server, DNS Server, DHCP Server | Network cards | None: an end device never carries the traffic of others |
| Database, Storage S3, NAS | Network cards | None |
| PC, Laptop, Smartphone, Tablet, IP Phone, Printer, IP Camera | One network card | None |
The names are those of the templates, and they are the same in both languages. What the drawings and the templates tell:
- The drawing is what tells one kind from another. A web server and a mail server differ in the symbol on them, and in what the engine does with them: a Mail Server is the one an email goes through, and a server of any kind can answer for names (its “DNS” tab) or hand out addresses (its “DHCP” tab). The page Templates says how a kind is made.
- A Cloud stands for what is outside. A Cloud named Internet is the public Internet: it does not carry private addresses, and a drawing that crosses it needs NAT. Any other Cloud is taken to carry whatever is sent across it.
- Routers and firewalls are the only devices that route. A switch, an access point or a cabled PC never joins two networks; that takes a router or a firewall with a port in each (Addresses and gateways).
Adding a device
- In the bar on the left press “Add device”. The panel “Add” opens, with the tab “Devices”.
- Find the kind in the list, or type part of its name in “Search devices…”. A click on it opens a window titled "Add a new" and the name of the kind, for example "Add a new Switch".
- Check the window. Under “Identity” are the “Device name” (it is proposed, see Names) and, for a switch, a router or a firewall, the “Number of ports”: 5, 8, 16, 24 or 48 for a switch, 2, 4, 8 or 16 for a router or a firewall. Vendor and location are free text, for the devices that are not a PC. Under “Network” are the “IP address”, the “Subnet mask” and the “Gateway”.
- Press “Add”.
The device appears in the first free place of the part of the board you are looking at, row by row from the top left, clear of the open panel and of the small map, and it is selected. When no place is free in view, it goes to the nearest free one and the view moves to show it. The window of an end device is about its first network card, eth0: the address typed there is the card’s, and “Address” may be set to “Automatic (DHCP)” instead. A router or a firewall has no address field to fill in: its ports get theirs later, in its window (Ports and network cards).
The address is the first free one of the network of the project, from .2, with the mask and gateway of that network, and the DNS server when the project has one. They are set in Settings → Network, and Addresses and gateways says what each does. A leased address (an address given by a DHCP server) is never proposed to a new device.
Two more ways to add many devices at once: Bulk add, and the sample networks under the tab “Samples” of the same panel.
Names
The name of a device is how a person, and the terminal, calls it: ping PC-2 from PC-1. A new device is named after its template, with a dash for each space, and a number: the lowest, from 1, that leaves the name free. The first PC is PC-1, the next PC-2, and a Web Server is Web-Server-1. Delete PC-1 and the next PC is PC-1 again. A name counts as taken whatever its case, and whatever the kind of the device that has it.
You can change a name in the “General” tab of the window of the device, under “Device name”. It may not be empty, and it may not be the name of another device, whatever its case: “Add device” and the window of a device then say “Another device already has this name” under the field, and add or save nothing until the name is changed. The devices that are there are never renamed. The terminal finds a device by its name without telling pc-1 from PC-1; when two devices have the same name it takes the first one in the order they were drawn. A name that is unique is a name that works.
The window of a device
A double click on a device opens its window, as does right click → “Details (edit)”. The window is made of tabs, and the tabs depend on the kind:
- “General”: the kind, the “Device name”, vendor and location, the “Notes” (Notes), the address and what the device is attached to. A switch, a router and a firewall also show how their ports are used there.
- “Ports” for a switch, a router and a firewall; “Network cards” for the other kinds. The page Ports and network cards is about these two.
- “Routes” for a router and a firewall, “Rules” for a router and a firewall, “NAT” for the ports of a router or a firewall, “DHCP” for a router, a firewall and a server, “DNS” for a server.
Nothing changes on the board until you press “Save”; “Cancel” leaves the device as it was.
Copying and deleting
- Selecting. A click on a device selects it. Ctrl + click adds a device to the selection or takes it away, and a drag on empty space draws a selection box. Areas can be in the selection too (Areas), and with two devices selected or more “Enclose in an area” appears above them.
- Copying. Edit → “Copy” or Ctrl+C copies the selected devices, with the cables between them and the selected areas. Edit → “Paste” or Ctrl+V adds the copies, 50 units to the right and below, or further when a copy pasted before is there. Each copy is a device of its own: it takes the first free name of its family (
PC-1gives the first freePC-n,ReceptiongivesReception-1) and a new MAC address on every network card. A PC, a laptop, a printer and the other end devices that are not servers ask for their address: their cards are set to “Automatic (DHCP)”. With no DHCP server on their network they stay without one, the line under the name says “DHCP: no address”, and a notice names them. Servers, databases, routers, firewalls and switches keep the addresses of the original, as a real machine that is cloned: a notice says so, and which addresses are now in conflict. Until the copy has addresses of its own, both devices are yellow, the line under their name shows the address followed by· in conflict, and a question to that address or from it stops with the reason (Two devices with one address). - Deleting. Select and press the Delete key, or right click → “Delete”: both ask first, in a window of the app. The Delete key deletes everything selected, devices, cables and areas, and the question says how many of each. The cables of a device go with it. Edit → “Undo”, or Ctrl + Z, brings back what was deleted, cables and areas included (Undo and redo).
The colour of a device
The upper layer of every drawing is a lamp. Its colour tells one state of the device, and the lower layer never changes. When several things are true, the first of this list is the one shown.
| Colour | The device is | Besides the colour |
|---|---|---|
| Grey | Taken as broken, in presentation mode | A mark of failure and faded texts |
| Red | The place where the answer on screen stops | A frame in red; a screen reader says “Stops here” |
| Green | The place where the answer on screen arrives | A frame in green; a screen reader says “Gets here” |
| Orange | Selected | The frame of the selection |
| Yellow | Something to put right: its first card is on DHCP and nobody gave it one, or one of its addresses is on another device too | The line under the name says “DHCP: no address”, or shows the address followed by · in conflict |
| Slate | Nothing to say |
The answer stays on the board after a question asked from the simulation panel or from the terminal (ping, trace, browse, mail, download), when the packet has got to the end of its way. It goes at the next question, at any change to the drawing, and with a click on empty space. A question that cannot even leave its first device is told at once. Asking the network and Presentation mode say how to ask, and what a failure simulated there does.
Limits
Limits
- The kind decides the role in the engine, and nothing else about the hardware: a device has no model, no firmware, no CPU or memory, and no limit on the traffic it carries.
- A Load Balancer does not balance and a Cloud does not carry anything: both are taken to let the traffic through.
- A Printer, an IP Camera and the other end devices answer only to what the engine asks of them; they do not run services of their own.
- Two devices with one address are marked, not refused: the board lets you draw them, and says they are in conflict until one changes. Devices on two different boards of a project never meet, and are never in conflict.
- The windows refuse a name another device has, but a drawing made with an earlier version may still hold two devices with one name.