SeawolfVirtualAppliance

UserGuide

WhatistheSeawolfAppliance?
SampleScreenshots
SeawolfApplianceInstallation
Prerequisites
Hardware
Software
A64bithostOperatingSystem(WindowsorLinux)
VirtualizationSoftware
IVMwarePlayer:InstallationSteps
IIOracleVirtualBox:InstallationSteps
GettingStartedwiththeSeawolfAppliance
Login
Tip:GettingdecentGraphicswithintheAppliance
Network
DoNotUpgrade
ChangeyourPassword
TipsandTraps
ThekaiwanTECHSeawolfAppliance::AdditionalPackages
TroubleshootingTips
Support

2015kaiwanTECH1of18
 SeawolfVirtualAppliance|InstallationGuide

WhatistheSeawolfAppliance?

TheSeawolfApplianceisafullyprepackaged,configuredandpreparedVirtualMachine
appliance.

ItconsistsofabaseLubuntu(LightweightUbuntu)ver14.10(UtopicUnicorn)Linuxdistribution,
withcarefullycuratedcontentappropriatefor kaiwanTECHT rainingsessions.

Softwarestack: thebaseLubuntuinstallhasbeenupdatedwithseveralnecessaryanduseful
softwarepackages,libraries,utilitiesandscriptsprepackagedintoSeawolf.Theseare
particularlychosensoastobebeneficialtoparticipantsofthekaiwanTECHLinuxbased
Trainingsessions ,andwillgreatlyaidinprovidingastreamlinedhasslefreetrainingexperience
totheparticipant.Inaddition,forhighperformanceontheubiqtiousVMwarePlayerplatform,
theVMwareGuestToolshavebeenpreinstalled.

Toseealistofprepackagedsoftware,pleaseturntotheSeawolfVirtualAppliance::
AdditionalPackagessectioninthisdocument.

Theappliancethus effectivelyeliminatestheneedforpriorlabsetup .Also,participant

productivityisenhancedasprecioustimeisnotwastedondifficultiestypicallyencounteredwith
complexpackagesetupandinstallation.

Wedoassumeareliablenetworkconnectionofcourse,forfurtherpackageinstallations(that
theparticipantmaydeemnecessary),upgrades,etc.

WhyshouldoneusetheSeawolfAppliance?

Afullyfunctional,yetlightweightandmodernLinuxOSdistribution
CarefullycuratedcontentfortheparticipantofakaiwanTECHLinuxbasedTraining
session areallprepackagedandpreinstalled:
allrequiredpackages/libraries/utilities/kerneltools
additionalusefulutilitiesandscripts
removalofnonessentialpackagesthataddunnecessarybloat
powerfulOSleveltoolsforkerneldevelopment/debugpurposes
Reusetheapplianceanywhere!
Asaextremelyusefulrescuedisk(forsysads,devops,developers,testers,
endusersalike)
AsafantasticprebuiltlearningtoolfortheLinuxOS
Storageforyourdocuments,code,utilities,etc
ontheapplianceitself(the/homefolderisonaseparate(logical)partition)

2015kaiwanTECH2of18
 SeawolfVirtualAppliance|InstallationGuide

withinasecondaryvirtualdisk(whichcanthenbesyncedonaPC)[in
development]
eveneasier,onthecloud
LightandintuitiveUI,completelycustomizablefortheexperienceduser
inaddition,yourcustomizationsareautosavedintotheappliance
Installandenjoyawidevarietyofthirdpartyapps

TheSeawolfAppliancesoftwareisprovidedtotrainingparticipantsasasinglecompressedfile.
TheInstallationsectionbelowcoversindetailhowtoinstallandusetheappliance.

SampleScreenshots

SeawolfAppliancerunninginVMwarePlayer12(onaWindows7Prohost)

2015kaiwanTECH3of18
 SeawolfVirtualAppliance|InstallationGuide

SeawolfAppliancerunninginOracleVirtualBox5(onaUbuntu15.04Linux3.xhost)

SeawolfAppliancerunninginOracleVirtualBox5(onaWindows7Prohost)

2015kaiwanTECH4of18
 SeawolfVirtualAppliance|InstallationGuide

SeawolfApplianceInstallation

Prerequisites

Hardware
AnIntelorAMD 64bit
PCorlaptop,withaminimumof2GBRAM(4GBormoreis
definitelyrecommended),atleast20GBfreediskspace(fortheappliance),Windows7
orLinux2.6OS,orbetter/later.
700MBofavailablediskspacefortheapplication.Additionalharddiskspace

requiredforeachvirtualmachine.
Virtualizationextensions(IntelVTxorAMDV) required
is tobeenabledintheBIOS
(thisisespeciallytrueonIntelbasedprocessors).Ifnotenabled(oryouareunsure),
pleaseshutdowntheOS,bootintotheBIOSandenableVirtualizationextensions.
TheVMwareKnowledgeBasepageprovidesdetails: Hardwareandfirmware
requirementsfor64bitguestoperatingsystems(1003945)
Indetail(onthe VMwareWorkstationPlayerFAQspage) :
VMwareSystem
Requirements

Software

A
64bit
hostOperatingSystem(WindowsorLinux)

7zip[un]compressionSoftware

The7zipWindowsSetupInstallerprogramisprovidedalongwiththeSeawolfpackage.(7zip
isOpenSource).

VirtualizationSoftware

ToinstallandusetheSeawolfappliance,youwillprimarilyrequiretoinstalla
Virtualization
Softwareoremulator .Twowellknownandmatureprojectsthatprovidesimilarfunctionality
are:

VMwareWorkstationPlayer12 .
Note!ForSeawolf,onlyversion12willsuffice.
(Foryourconvenience,theVMwareWorkstation
Player12setupexecutableforWindows64isprovided).

2015kaiwanTECH5of18
 SeawolfVirtualAppliance|InstallationGuide

OR

OracleVirtualBox
VirtualBoxver5.0.4(setupexecutableforWindows64providedpleasefinddetailsbelow).

Youarefreetoselectany,ofcourse.
Aquick(noclaimtocompleteness!)comparison:
VirtualizationSoftware/ VMwarePlayer12 OracleVirtualBox
Features

Easeofinstallingappliance/ Afewmoresteps Easieralso,itsfully

guestOS compatiblewithVMDKvdisk
format

Hardwareacceleration/ Excellent(asVMwareguest Normal

paravirtsupport Toolsarepreinstalledinto
appliance)

(Virtual)Graphicsdisplay Excellent:scaleswell Relativelypoor

OpenSource Partially FullyOSS

SIDEBAR::QEMU/kvm

AnalternateexcellentVirtualizationSoftwareverymuchexiststhe QEMU/kvm projects

emulator(whichuseskvmastheOSlevelhypervisorforacceleration).

TheonlyissueisthatsettingupQEMUdirectlyonaWindowshostisnotstraightforward.For
thatmatter,evenonaLinuxOSasahost,usingQemuviathesuperb virtmanager
GUIutility
makesthings much simpler.(Theissueineffect:virtmanagerisnotdirectlysupportedon
Windows64hosts).

So,untilthattime,ifyoureonaWindowshost,selectingaVirtualizationSoftwarefromoneof
VMwarePlayerorOracleVirtualBoxremainsthebestviablealternative!

OnaLinuxhost,usingvirtmanagerisanexcellentoption.Itevenallowsyoutodirectly
importtheVMwareVMDKvirtualdiskimage(likeOracleVirtualBox),sosettingupthenew
applianceisveryeasy.

2015kaiwanTECH6of18
 SeawolfVirtualAppliance|InstallationGuide

BelowisdescribedtheInstallationStepsforbothVMwarePlayeraswellasOracleVirtualBox.
Basedonyourpreferenceofhostemulator,pleasecarefullyfollowtheappropriateseriesof
steps.

IVMwarePlayer:InstallationSteps

FirstlyensurethatVMwarePlayer12isinstalledonyoursystem.Asaconvenience,the
Windows64installsetupexecutablefileforVMwarePlayer12isprovidedalongwiththe
product.(Incaseyourequireit,thedownloadlink (ofcourse,thiscouldgetoutdated,please
check)).

1. Downloadorcopyfromlocaldisk/pendrive
thecompressed Seawolf
fileontoyourPC(orlaptop)harddisk.
2. Extractthezipfile(usingWinZiporequivalent).Notethatasthezipfileislargethis
operationcantakesometime.
3. Downloadandinstall VMwarePlayer12 softwareonyoursystem.
[
Thedownloadlink (ofcourse,thiscouldgetoutdated,pleasecheck).]
4. RunVMwarePlayer

2015kaiwanTECH7of18
 SeawolfVirtualAppliance|InstallationGuide

5. ClickontheOpenaVirtualMachinebutton
a. Browsetowhereyouextractedthezipfile,and
b. selectthe.VMXconfigurationfilewithintheSeawolffolder
6. VMwarePlayernowcreatesanewVMfromtheprovideddatalabelledSeawolf
kaiwanTECHVirtualAppliance:

2015kaiwanTECH8of18
 SeawolfVirtualAppliance|InstallationGuide

7. SelecttheSeawolfkaiwanTECHVirtualAppliance(fromtheleftpaneofVMware
Player)andclickonthePlayvirtualmachinebuttononthebottomright
8. VMwarePlayernowstartstobringuptheappliance(VM).
VMwarePlayermightpopupadialog:

Asrecommended,clickontheICopiedItbutton.

Whiletheapplianceboots,VMwarePlayermightmakeobservations/recommendationsabout
varioushardwarecomponentsbeingavailabletotheguest.Youcansimplyreadandcontinue.

2015kaiwanTECH9of18
 SeawolfVirtualAppliance|InstallationGuide

IIOracleVirtualBox:InstallationSteps

FirstlyensurethatOracleVirtualBox5isinstalledonyoursystem.Ifnotalreadyinstalled,
downloadandinstall OracleVirtualBox5 softwareonyoursystem.
Asaconvenience,theWindows64installsetupexecutablefileforOracleVirtualBox5is
providedalongwiththeproduct.(Incaseyourequireit,thedownloadlink (ofcourse,thiscould
getoutdated,pleasecheck)).

1. Downloadorcopyfromlocaldisk/pendrive
thecompressedfileontoyourPC(orlaptop).
2. Extractthezipfile(usingWinZiporequivalent).Notethatasthezipfileislargethis
operationcantakesometime.
3. RunOracleVirtualBox5
4. ClickontheNewbutton
a. Name:typeSeawolf
b. Type:selectLinux
c. Version:selectUbuntu(64bit)
ClickontheNextbutton
5. Selectthememory(RAM)sizeasrecommendedbyVirtualBox.ClickNext
6. Harddisk:
a. Here,itsimportanttoselectUseanexistingvirtualharddiskfile
b. clickonthefilebrowsebutton(onthelowerright),navigatetothefolderwhere
youextractedtheSeawolfAppliance,navigatetothe Seawolf folderandselect
Seawolf.vmdk
the file.
(Yes,VirtualBoxautoimportsandusesVMwareVMDKfiles!).
(seescreenshotbelow).

[P.T.O.]

2015kaiwanTECH10of18
 SeawolfVirtualAppliance|InstallationGuide

7. ClicktheCreatebutton
8. ThenewVMSeawolfshouldnowshowupintheleftsidepanel(markedasPowered
Off)
9. ClicktheStartbuttontogetitupandrunning.

TheguestOSshouldnowproceedtobootup.

2015kaiwanTECH11of18
 SeawolfVirtualAppliance|InstallationGuide

GettingStartedwiththeSeawolfAppliance

Login

Theappliancewillaskyoutologin.Select:

User:
Seawolf
Password:
welcome

(Yourguestuseridisseawolf).

Tip:GettingdecentGraphicswithintheAppliance

1. IfusingVMwarePlayer12,theguestappliancecanbeautoscaled,withverygood
graphicsresolutionbeingautoselected(largelyduetothefactthatVMwareGuestTools
havebeenpreinstalledwiththeappliance).
ThisisabenefittousingVMwarePlayer12astheVirtualizationSoftware(emulator).

2. However,inOracleVirtualBox,unfortunately,thiscapabilitydoesnotseemtobeas
good.OncerunningtheSeawolfAppliance inVirtualBox ,onecouldusetheView/
ScaleModemenutoscaleupthevirtualdisplayscreenasthewindowisresized.

[P.T.O.]

2015kaiwanTECH12of18
 SeawolfVirtualAppliance|InstallationGuide

3. OnaLinuxhostrunningQemu/kvmastheVirtualizationSoftware(andusing
virtmanagertomanageVMs),thegraphicssupportisverygood.

Withinthe(Qemuemulated)guest,afterbooting,navigateto
MainMenu/Preferences/MonitorSettings
andselect1280x720resolution(orwhicheverscalesbesttoyourhostmonitor
resolution).

Network

TheSeawolfguestappliancesharesthehostsnetworkconnection(viaNAT).Thus,ifyourhost
isproperlyconfiguredtoconnecttotheinternet,theapplianceshouldautomaticallygain
networkaccessaswell.
Setupanyproxysettingsasrequiredforyourlocation.

2015kaiwanTECH13of18
 SeawolfVirtualAppliance|InstallationGuide

DoNotUpgrade

Uponfirstboot(andevenotherwise),theappliancemaypopuparequesttoupgradethebase
OS([L]Ubuntu14.10)tothe15.04version.

Atthispointintime,werecommendyou doNOTupgrade thebaseOS.(Sojustclickonthe

OKbutton).
Rationale: kaiwanTECHLinuxOStrainingsessions,
forthepurposesofthe Lubuntu14.10is
preconfiguredandinstalledwithanappropriatekernelversion,settings,applicationsandutilities
(especiallyregardingusageofthecrashutilityanadvancedkerneldebugtool).

Ofcourse,pleasedocontinuetoupdate(andnotupgrade)thesoftwareasrequested,
especiallyforsecurityupdates.

ChangeyourPassword

Wedefinitelyrecommendyouchangeyourpasswordafterthefirstlogin.

Youcandosoviathe MainMenu/SystemTools( togethere,clickthemainmenuiconinthe

UsersandGroupsi
topleft(orbottomleft)cornerofthescreen).Then,clickon con,clickon
thepasswordbuttonandproceedtochangeyourpasswordtoasecureone.

Periodicallychangingyourpassword(toasecurehardtoguessone),isasecurity
bestpractice!

2015kaiwanTECH14of18
 SeawolfVirtualAppliance|InstallationGuide

TipsandTraps

AlwaysworkwithexactlyonecopyoftheApplianceatatime
IfyouhaveausecasetorunmultipleinstancesoftheAppliance,youMustmake
acopy(clone)oftheappliancefiles(underthe
Seawolf_Appliance/Seawolf
folder)andsetupanew(cloned)VMusingthem. !WARNING!Usingthesame
VMDKfileonmorethanonerunninginstancesimultaneouslywillcause
corruption!
Permissions
Ensurethat,onthehostplatform,thecurrentlyloggedinuserhas
sufficientaccessrightstobothrunthevirtualizationsoftware,andforitto
accesstheAppliancefoldersandfileswithinthem.
USBdevices
OnecangainaccesstothehostssUSBdevicesveryeasilywithVMware
Playervirtualizationsoftware.Justclickontheappropriateicon(onthe
horizontalpanelatthebottomoftheVMwarePlayerwindow).Thenclick
ontheConnecttoguestbutton.ThePlayersoftwarewarnsyouthat
thiswillcausethedevicetobedisconnectedfromthehostallowitto
proceed.Youhsouldnowhaveaccesstothedevicefromwithinhte
guest.
<<Insertscreenshot>>
WithaUSBharddisk,wefindthatusingaUSB3portonthehostcan
causeconnecitontotheguesttofailuseonlyUSB2(normal)USB
portsonthehost.

2015kaiwanTECH15of18
 SeawolfVirtualAppliance|InstallationGuide

ThekaiwanTECHSeawolfAppliance::Additional
Packages

TheVMappliancehasbeenalreadyupgraded(tokernelver3.16.044generic),preconfigured
withVMwareTools(provideshardwareaccelerationbenefits,hostfilesystemsharing,etc),and
ahostofcarefullycuratedsoftwarepackages,libraries,utilitiesandscripts.Thetablebelow
enumeratessomeoftheaddedcontent.

Base:Lubuntu14.10

Linuxkernelversion :3.6.023generic(original)
3.16.044generic(applianceupgraded).

Username: seawolf (fullname:Seawolf)

Password: welcome

Name Purpose

VMwarePlayerGuestTools Significanthardwareandsoftware
accelerationfortheVMwhenrununder
VMwarevirtualizationsoftware
(recommended)

Development:gcc,make,git GNUCompilerCollection+extras

Qemukvm ProcessorEmulator(s):withInteli386and
x86_64emulatorsupport

debootstrap Downloadsand'installs'Debianminimalroot
filesystem

ConvenienceUtilities/Scripts Runinshell(terminalwindow)as./0setup.
/0setup Setsupusefulaliases,functions..
monitor.sh monitor.shprovidessimplemonitoring
...[+severalothers/misc] services.

vim ViiMprovededitor(alongwithit's~/.vimrc)

perf Performanceanalysistools

2015kaiwanTECH16of18
 SeawolfVirtualAppliance|InstallationGuide

libncurses5dev Forthemenuconfigtool

crash Thecrashtoolsystemlivedebuganalysis.
Seethe~/kaiwanTECH/crash_stufffolder

~/kaiwanTECH/crash_stuff/linuximage3.16 Kernelimagewithdebugsymbolicinformation
.044generic.(Fromthedownloadedpkg (forkerneldebugging,crashlivesystem
linuximage3.16.044genericdbgsym_3.16 debug)
.044.59_amd64.ddeb)

exuberantctags,cscope Codebrowsingtools

p7zipfull [Un]ziptools

valgrind Awardwinningmemorycheckersuite

zenity Powerfulgraphicalinterfaceelementsforshell
scripts

Miscellaneous fortune,cowsay.Trythemout.

Removed(tosavespace):
libreofficehelpenusubuntudocsthunderbird
apport
games:aisleriotgnomesudokumahjonggaceofpenguinsgnominegbrainy

2015kaiwanTECH17of18
 SeawolfVirtualAppliance|InstallationGuide

TroubleshootingTips
KnowledgeBases
Ingeneral,the VMwareKnowledgeBase websitecanbeveryusefulto
troubleshootingseveralcommonissues
Similarly,thissiteexistsforOracleVirtualBoxTroubleshooting
WithVMware,ifyouseeanerrorlike:longmodeisunsupported,seethisresource:
Virtualmachinefailstopoweronwitherror:Longmodeisunsupported.Itisrequiredfor64bitguestOS
support.OnIntelsystems,longmoderequiresVTxtobeenabledintheBIOS(2073384)

Support

Foranyissues,questionsorsuggestions,please
docontactus
.

Oremailusdirectly:
support@kaiwantech.com
Wewillrevertwithin3workingdays.

[Enddocument]

2015kaiwanTECH18of18