Manual Bambi

Requirements for UI

To have best experience with user interface, please use hardware/software with at least next characteristics, or better.

Monitor: 1280x1024 (in some rare cases down to 1024x768)

Supported browsers:

recent Firefox - fully

recent Chrome - fully

IE8, IE9 - partially

Command Line Arguments

Bambi supports several command line arguments in order to automate the application start. The following a list of all arguments plus a short description about their usage:

Arguments		Description	Default Value
Short	Long	Description	Default Value
-a	--auto	Auto start Bambi server will be started automatically.	false
-c	--context	URL Context Subpath of URL	"bambi"
-p	--port	Port Port on which bambi server is listening.	8080

Sample

Here a sample how to use the command line arguments. This leads to an automated server start. The URL of the started bambi server is http://localhost:9999/myContext

Command Line Argument Sample

C:\>bambi.exe -a -c myContext -p 9999

Device Configuration Files

Device Configuration files define the respective devices that Bambi simulates. The configuration file can be found at <base dir>/config/devices.xml One Bambi simulator can represent multiple devices. Each device is represented by one Device element in the configuration file. The following table defines some of the valid device parameters:

Configuration Parameter	Cardinality	Description
/application/@BaseDir	required	directory where all Bambi Files are stored.
/application/@Context	required	Url base Path of the application
/application/@Port	required	Url Port of the application
//Device/@DeviceID	required	JDF DeviceID of the simulated device
//Device/@TrackResource	optional	resource that is tracked with Resource Audits and Resource JMF and that defines the speed for counting status JMFs.
//Device/@AmountResources	optional	additional resources that are tracked with Resource Audits and Resource JMF.
//Device/@TypeExpression	optional	regular expression of types that are accepted by the simulator

Device Configuration

<?xml version="1.0" encoding="UTF-8"?>
<application  AppDir="C:\Users\s.meissner\AppData\Local\Temp\jetty-0.0.0.0-8080-bambi.tmp.war-_context-any-\webapp"  
    BaseDir="/bambidata/sim/"  CallBackName="org.cip4.bambi.extensions.ExtensionCallback"  
    Context="/SimWorker" JDFDir="JDFDir" JettyPort="44482" Port="8080" SenderID="SimDevice">
    <Device DeviceID="SimWorkerRoot" DeviceType="Bambi Sim Device Root"/>
    <Device AcceptAll="true" DeviceID="sim001"  DeviceType="Bambi Simulation HotFolder Device 001"  
        ErrorHF="/BambiHF/sim001/Error" InputHF="/BambiHF/sim001/Input"  OutputHF="/BambiHF/sim001/Output"  
        ProxyURL="http://localhost:8080/BambiProxy/slavejmf/pullproxy" TrackResource="Component:Output"/>
    <Device DeviceID="sim002"  DeviceType="Bambi Simulation HotFolder Device 002"  
        ErrorHF="/BambiHF/sim002/Error" InputHF="/BambiHF/sim002/Input"  OutputHF="/BambiHF/sim002/Output" 
        TrackResource="Component:Output"/>
    <Device DeviceID="sim003"  DeviceType="Bambi Push Simulation Device 003"  
        ErrorHF="/BambiHF/sim003/Error" InputHF="/BambiHF/sim003/Input"  MIMEExpansion="true" 
        OutputHF="/BambiHF/sim003/Output"  PushPull="Push" TrackResource="Component:Output"/>
    <Device AmountResources="Media:Input,UsageCounter" DeviceID="simIDP"  
        DeviceType="Bambi Push Simulation IDP Device"  ErrorHF="/BambiHF/simIDP/Error" 
        InputHF="/BambiHF/simIDP/Input"  MIMEExpansion="true" OutputHF="/BambiHF/simIDP/Output"  
        PushPull="Push" TrackResource="Component:Output" TypeExpression="(.)*DigitalPrinting(.)*"/>
</application>

Employee Configuration

<?xml version="1.0" encoding="UTF-8"?>
<Employees xmlns="http://www.CIP4.org/JDFSchema_1_1">
    <Employee ProductID="E1" Roles="Operator" >
        <Person DescriptiveName="Joe Cool" />
    </Employee>
    <Employee ProductID="E2" Roles="Operator" >
        <Person DescriptiveName="Harry II" />
    </Employee>
    <Employee ProductID="E3" Roles="Operator" >
        <Person DescriptiveName="John Doe" />
    </Employee>
    <Employee ProductID="E4" Roles="Operator" >
        <Person DescriptiveName="Fool Hardy" />
    </Employee>
</Employees>

Job Simulation Configuration Files

Job Simulation Configuration files define the respective phases of a job that Bambi simulates. The default job configuration file can be found at <base dir>/config/job.xml. Device specific configuration file can be found at <base dir>/config/job_<deviceid>.xml. Each JobPhase is iterated over individually.

Configuration Parameter	Cardinality	Description
/BambiJob/@Error	optional	% chance per iteration that a random error will be inserted
//JobPhase/@Duration	required	maximum duration of the job phase in seconds.
//JobPhase/@<xxx>Status	required	device and node status and stausdetails for audits and JMF that apply to this phase
//Amount/@Resource	required	The resource that this amount applies to.
//Amount/@Speed	optional	Speed of consumption or production in implied JDF units/hour.

Job Configuration

<?xml version="1.0" encoding="UTF-8"?>
<BambiJob Error="3">
    <JobPhase Duration="2" DeviceStatus="Setup" DeviceStatusDetails="WarmingUp" 
        NodeStatus="Setup" NodeStatusDetails="node warmup">
        <Amount Resource="Component:Output" Speed="0" />
        <Amount Resource="Media:Input" Speed="0" />
    </JobPhase>
    <JobPhase Duration="10" DeviceStatus="Setup" DeviceStatusDetails="Waste" 
        NodeStatus="Setup" NodeStatusDetails="node setup">
        <Amount Resource="Component:Output" Speed="4000" Waste="true"/>
        <Amount Resource="Media:Input" Speed="4000" Waste="true" />
    </JobPhase>
    <JobPhase Duration="99999" DeviceStatus="Running" DeviceStatusDetails="Good" 
        NodeStatus="InProgress" NodeStatusDetails="producing node">
        <Amount Resource="Component:Output" Speed="16000" />
        <Amount Resource="Media:Input" Speed="16000" />
    </JobPhase>
    <JobPhase Duration="10" DeviceStatus="Cleanup" DeviceStatusDetails="WashUp" 
        NodeStatus="Cleanup" NodeStatusDetails="cleaning up">
        <Amount Resource="Component:Output" Speed="0" />
        <Amount Resource="Media:Input" Speed="0" />
    </JobPhase>
</BambiJob>

Configure format Date fields

Date fields can be configured to show its value in most appropriate way. Currently, it shows in Europian way, thus "DD/MM/YYYY".

To change behaviour, user need to update next file:

for legacy UI: "/CIP4Tools/bambi/legacy/StandardXML.xsl"
for new UI: "/CIP4Tools/bambi/webapp/StandardXML.xsl"

In the file, near bottom of it, you will find "dateFormatter" variable with defined value, similar to next:

<xsl:variable name="dateFormatter" select="'EURODate'"/>

Please, read comment in the file, about usage of the formatter and supported formats.