Skip to content

Getting Started Quickly

bfaivre edited this page Jul 9, 2019 · 54 revisions

This tutorial assumes that:

  1. You have your Brewery Pi connected to your network. See What do I need to run Brewery Pi? for a list of hardware.
  2. You know the IP address of your Brewery Pi.
  3. You can access your Brewery Pi by pointing a web browser at it's IP address.

It also assumes that you are starting with fresh copy of Brewery Pi that has not yet been modified, otherwise the Load the Getting Started Template section below could fail.

Logging In

  1. Point your browser to your Brewery Pi IP address. See Your connection is not private, This site is not secure, etc. browser warnings when trying to access Brewery Pi if presented with a terrifying warning message.
  2. Click log in Log In.
  3. Use the default username and password which are "pi" and "brewery", respectively.
  4. Click log in Log In.

Load the Getting Started Template

  1. Download (by right-clicking on and saving as) the Getting Started Template to your computer. The filename will be "gettingStartedQuickly.sql".
  2. Navigate to Raspberry Pi->Restore Database.
  3. Choose the Getting Started Template (gettingStartedQuickly.sql) that you just downloaded and click import Import.

If all goes well, you should receive a message stating "Database successfully restored.". At this point you'll have the Getting Started Quickly brewery configuration loaded on your Brewery Pi system and can continue with this tutorial.

Configuring your Brewery

Renaming your Enterprise

  1. Navigate to Configuration->Brewery Modeling.
  2. Click edit Edit on the My Company row.
  3. Change the Name and Abbreviation entries appropriately for your brewery. For example, "Deschutes Brewery" and "DB" respectively.
  4. Click save Save.

Renaming your Site

  1. Click select Select on your enterprise you just renamed above.
  2. Click edit Edit on the My Site row.
  3. Change the Name and Abbreviation entries appropriately for your site. For example, at Deschutes Brewery, the main production site is called "Brew 2", so in this case, we'd use "Brew 2" and "B2" for the name and abbreviation, respectively.
  4. Click save Save.

Brand Management

Add a New Brand

  1. Navigate to Configuration->Lookups.
  2. Click select Select on the Brands row.
  3. Click add Add.
  4. Enter the Name of the brand, for example, Black Butte.
  5. Click save Save.

Delete a Brand

  1. Navigate to Configuration->Lookups.
  2. Click select Select on the Brands row.
  3. Click delete Delete on the brand row you want to delete.

Elements (FVs and BBTs)

What is an Element, you ask?

For the sake of this tutorial, you really just need to understand that elements are needed for event frames. What the f does that mean!? More to come on this subject, for now, just know that elements represent fermentors (FVs) and brite beer tanks (BBTs) at your brewery.

Lets take a look at the FVs and BBTs at your Brewery

  1. Navigate to Elements->Elements.
  2. Click select Select on the FV row.

You'll see the three (3) FVs for your brewery: FV01, FV02 and FV03.

  1. Now, using the breadcrumb navigation above the Elements header, click on your site.

Elements Breadcrumb

  1. Click select Select on the BBT row.

You'll see the two (2) BBTs for your brewery: BBT01 and BBT02.

Dude, that's not what we call our FVs and/or BBTs!?

No worries!

To edit a FV:

  1. Navigate to Elements->Elements.
  2. Click select Select on the FV row.
  3. Click edit Edit on the FV you want to rename.
  4. Change the Name so that it adheres to your brewery conventions.

To edit a BBT:

  1. Navigate to Elements->Elements.
  2. Click select Select on the BBT row.
  3. Click edit Edit on the BBT you want to rename.
  4. Change the Name so that it adheres to your brewery conventions.

Dude, we have so many more FVs and/or BBTs!?

No worries!

To add a new FV:

  1. Navigate to Elements->Elements.
  2. Click select Select on the FV row.
  3. Click add Add.
  4. Enter a Name for the FV and leave the Manage Tags checkbox checked.
  5. Click save Save to create the new FV.

To add a new BBT:

  1. Navigate to Elements->Elements.
  2. Click select Select on the BBT row.
  3. Click add Add.
  4. Enter a Name for the BBT and leave the Manage Tags checkbox checked.
  5. Click save Save to create the new BBT.

Dude, we only have one FV and one BBT!?

No worries!

To delete a FV:

  1. Navigate to Elements->Elements.
  2. Click select Select on the FV row.
  3. Click delete Delete on the FV you want to delete.

To delete a BBT:

  1. Navigate to Elements->Elements.
  2. Click select Select on the BBT row.
  3. Click delete Delete on the BBT you want to delete.

Event Frames (Fermentations and Brite Beer Storage)

What is an Event Frame, you ask?

For the sake of this tutorial, you really just need to understand that event frames represent fermentations taking place in FVs and bright beer storage taking place in BBTs.

Starting a new Fermentation

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the FV row.
  3. Click select Select on the Fermentation row.
  4. Click add Add to start a new fermentation.
  5. Select the appropriate FV Element from the dropdown that the fermentation will take place in.
  6. Click save Save to start the fermentation.

Enter Fermentation Data

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the FV row.
  3. Click select Select on the Fermentation row.
  4. Click select Select on the row with the Fermentation you you want to enter data on.
  5. Enter a value, like 69 for example, for the Temperature.
  6. Enter a value, like 12.5, for the Plato.
  7. Click save Save.

Dude, we collect pH on Fermentations!?

No worries!

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the FV row.
  3. Click configure Configure on the Fermentation row.
  4. Under Event Frames Attribute Templates click add Add.
  5. Fill in pH for the Name and select pH for the Unit.
  6. Click save Save.
  7. Enter Fermentation Data and you'll see a field for entering pH data.

Ending a Fermentation

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the FV row.
  3. Click select Select on the Fermentation row.
  4. Click stop Stop on the row of the Fermentation you you want to end.

Dude, that Fermentation I just ended is no longer visible!?

That's true. By default only active fermentations are shown so that your list of fermentations is not overwhelming. But, no worries!

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the FV row.
  3. Click select Select on the Fermentation row.
  4. Click "1 Mo", "2 Mo", "3 Mo", "6 Mo", "9 Mo", "1 Yr", or "All" to the right of the Event Frames header to show fermentations for the desired time range, as illustrated below.

Event Frames Desired Time Range

Starting a new Brite Beer Storage

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the BBT row.
  3. Click select Select on the Brite Beer Storage row.
  4. Click add Add to start a new brite beer storage.
  5. Select the appropriate BBT Element from the dropdown that the brite beer storage will take place in.
  6. Click save Save to start the brite beer storage.

Enter Brite Beer Storage Data

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the BBT row.
  3. Click select Select on the Brite Beer Storage row.
  4. Click select Select on the row with the Brite Beer Storage you you want to enter data on.
  5. Enter a value, like 2.2, for the CO2.
  6. Enter a value, like 32 for example, for the Temperature.
  7. Click save Save.

Dude, we collect sensory pass/fail on BBTs!?

No worries!

Let's add a Lookup for pass/fail. See What is a Lookup and why would I use it? for an explanation of lookups in Brewery Pi.

  1. Navigate to Configuration->Lookups.
  2. Click add Add to add a new lookup.
  3. Enter "Pass/Fail" for the Name.
  4. Click save Save.
  5. Click select Select on the Pass/Fail row.
  6. Click add Add to add a new value for the Pass/Fail lookup.
  7. Enter "Pass" for the Name.
  8. Click save Save.
  9. Click add Add to add a new value for the Pass/Fail lookup.
  10. Enter "Fail" for the Name.
  11. Click save Save.

Now let's add a field to record sensory pass/fail data.

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the BBT row.
  3. Click configure Configure on the Brite Beer Storage row.
  4. Under Event Frames Attribute Templates click add lookup Add Lookup.
  5. Fill in Sensory for the Name and select Pass/Fail for the Lookup.
  6. Click save Save.
  7. Enter Brite Beer Storage Data and you'll see a field for entering sensory pass/fail data.

Ending a Brite Beer Storage

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the BBT row.
  3. Click select Select on the Brite Beer Storage row.
  4. Click stop Stop on the row of the Brite Beer Storage you you want to end.

Dude, that Brite Beer Storage I just ended is no longer visible!?

That's true. By default only active brite beer storages are shown so that your list of brite beer storages is not overwhelming. But, no worries!

  1. Navigate to Event Frames->Event Frames.
  2. Click select Select on the BBT row.
  3. Click select Select on the Brite Beer Storage row.
  4. Click "1 Mo", "2 Mo", "3 Mo", "6 Mo", "9 Mo", "1 Yr", or "All" to the right of the Event Frames header to show brite beer storages for the desired time range, as illustrated below.

Event Frames Desired Time Range

You can’t perform that action at this time.