{{{
Bitumen refers to bituminous sands, which are a type of petroleum deposit.
}}}

== History prior to arriving to UCC ==

The switch lived a happy life with Apache Energy in Perth.

== UCC history ==

Not a lot of history yet!

== Current tasks ==

Core switch/router

== Current software configuration ==

Bitumen currently runs Cisco IOS 12.2(54)SG1.

[[https://www.cisco.com/c/en/us/td/docs/switches/lan/catalyst4500/12-2/54sg/configuration/guide/config.html|Catalyst 4500 Series Switch Software Configuration Guide, 12.2(54)SG]]

== Current hardware configuration ==

 * Cisco Catalyst 4507R Chassis
 * 2x WS-X4515 Supervisor Engine IV ([[http://lists.ucc.gu.uwa.edu.au/pipermail/tech/2017-August/004882.html|secondary module has memory problems]])
 * 2x WS-X4306-GB Gigabit Ethernet Module, 6-Ports (GBIC)
 * 2x WS-X4424-GB-RJ45 24-port 10/100/1000 Module (RJ45)
 * 1x WS-X4448-GB-RJ45 48-port 10/100/1000 Module (RJ45)

== Future plans for the machine ==

Given Bitumen has full Layer 3 capacity, potentially moving all NAT, firewall etc to it

== Useful commands when working with Bitumen ==

More for Wheel than anyone else, the following might be considered useful

'''Showing port names'''

If you're looking for a port that has already been configured and named:
{{{
bitumen>en
bitumen#show int description
or
bitumen#show int status
}}}
Or if you've set up a linux machine and want to know what port it's plugged into, install ladvd on the machine, and then run the following on bitumen (pay attention to the spelling of neighbors, or just shorten it to neigh):
{{{
bitumen>en
bitumen#show cdp neighbors
}}}

'''Configuring an access layer port'''
{{{
bitumen>en
bitumen#conf t
Enter configuration commands, one per line.  End with CNTL/Z.
bitumen(config)#int Gi7/2
bitumen(config-if)#description demo
bitumen(config-if)#switchport access vlan 3
bitumen(config-if)#no shut
bitumen(config-if)#exit
bitumen(config)#exit
bitumen#write mem
}}}

''no shut'' enables the port, ''shut'' disables

'''Configuring a trunk port'''

The native vlan setting here is only required if you plan on sending untagged packets from the device across the link, you can leave it out otherwise. Similarly, you can leave out the allowed vlan command if you're happy for it to trunk any and every vlan.

{{{
bitumen>en
bitumen#conf t
Enter configuration commands, one per line.  End with CNTL/Z.
bitumen(config)#int Gi7/2
bitumen(config-if)#switchport trunk encapsulation dot1q
bitumen(config-if)#switchport mode trunk
bitumen(config-if)#switchport trunk native vlan 8
bitumen(config-if)#switchport trunk allowed vlan 2,3,421
bitumen(config-if)#description A trunk port
bitumen(config-if)#exit
bitumen(config)#exit
bitumen#write mem
}}}

To show the allowed VLANs on a trunk
{{{
bitumen>en
bitumen#show int gi5/23 switchport
}}}

To add an allowed VLAN to a trunk (this example adding VLAN 4 to port 5/23)
{{{
bitumen>en
bitumen#conf t
bitumen(config)#int gi5/23
bitumen(config-if)#switchport trunk allowed vlan add 4
bitumen(config-if)#exit
bitumen(config)#exit
bitumen#write mem
}}}

== Thanks to: ==

Brad Peczka for acquiring for the club via his employer, Apache Energy Limited (to whom we are very grateful), then delivering and configuring with UCC members.
[MRD], [DTK] and [CJS] for re-racking and re-patching.

== Related Sites ==

----
CategoryMachines