Exercise Overview:

Working with Device Tags

Device Tags allow you to add custom labels to devices for use by Tachyon. We have two types of Tags – Coverage and Freeform. Coverage Tags can be used for targeting instructions and are configured by a Tachyon Admin, devices can then be set using an instruction. Freeform Tags can be used to label the devices in your organization but are only set using instructions and cannot be used for coverage. In this exercise we will create the device tag that we will use for our Phased Deployments. We will have values for the devices that are used for Testing (TestGroup), Pilot (PilotGroup), Group1 and Group2 will show the example of Day 1 deployments and Day 2 deployments. We will set our 2 Windows 10 machines as a Pilot group in our lab using Tags. We will then ask a question using the Tag as our coverage parameter.

Creating the Pilot Group Tag

Planning the coverage tags for the entire environment should be done thoughtfully. Each device has a list of the tags that have been set on the 1E Client. The list includes Name=Value plus a delimiter. The entire list for each Agent cannot be over 512 characters.

1ETRNW102

  1. Logged into 1ETRNW102 as 1ETRN\Tachyon_AdminPP
  2. Open Google Chrome and switch to the Settings application
  3. Navigate to Configuration – Custom Properties
  4. Click Add. In the Add Custom Property box type PatchRollout in the Name field
  5. Tag names can only be a maximum of 16 characters any tags exceeding the length limit will not be reported back and those devices will not be included in the coverage.
  6. In the Property Type box select CoverageTag
  7. In the Values box type in the following values
  8. Ring1
    Ring2
    Ring3
    Ring4
  9. You will need to click the + sign after adding the first value to add the additional fields
  10. Click Add

Setting a Tag on Devices

We use instructions to tell the 1E Client which tags to add to each device. We have two types of Tags in Tachyon. Coverage Tags and FreeForm Tags. FreeForm tags have less stringent limitations for length but cannot be used to define coverage (you would ask a question to get a list of devices that have that freeform tag). Tag data is stored in the Tachyon Master Database for each device. The entire list of Coverage Tags on each device must not exceed 512 characters.

1ETRNW71

  1. Switch to the Explorer Application. Navigate to Home
  2. Click on All Instructions and Expand the Tags Instruction Set
  3. Select What are the coverage tags. Leave the parameters as they are
  4. Click Ask This Question
  5. When the results come back notice we have tags on some of our devices. You may need to switch to Aggregated table view
  6. Notice the || in some results. This shows that some machines have no tags and the || are the delimiters that will be used for the list of tags on each device. You must factor in these characters when planning for your coverage tags
  7. Stop the Instruction
  8. Ask the question again but this time change the coverage to Lab Servers Management Group. Click on Ask This Question
  9. Click on Actions from the Question we just asked
  10. Click All Actions
  11. Expand the Tags Instruction Set. Notice the Actions we have available in this instruction set
  12. We use these instructions to set tags and delete tags for the devices in our environment.


  13. Select the Set coverage tag <tagname> to <tagvalue> action
  14. Click in the first parameter field – notice our only choice is PatchRollout. This the tag we just created in our Settings Application – Custom Properties. Select PatchRollout and Ring1
  15. Click Perform this Action. You will have to enter your password
  16. Open LiveMail and enter your Authentication Code

1ETRNW73

  1. In Google Chrome – Explorer Application
  2. Navigate to Notifications and Approve the Instruction number from above

1ETRNW71

  1. In the Explorer Application ask the question What are the coverage tags?
  2. Notice we have 2 devices set as our PhasedRollout - PilotGroup and two as PatchRollout - Ring1

1ETRNW102

  1. Open File Explorer and Navigate to c:\ProgramData\1E\Client
  2. Open the 1E.Client.log and look for the instruction number from the approval that you did
  3. You will see the action of running the instruction logged and also that the Tags have changed

Your log will look similar to this.

Asking a Question Using our Coverage Tag

Now that we have our devices tagged, we will ask another question. We will use the Device Tag for our coverage.

1ETRNW71

  1. Navigate to the Home screen of the Explorer Application
  2. In the I want to know field type in Operating and choose What Operating System Information Does Windows SystemInfo Report?
  3. Next to Parameters click Edit
  4. Expand Coverage – Tags
  5. In the Select Key field choose PatchRollout
  6. In the Select Value field choose Ring1 Click Set
  7. Click Ask this Question 
  8. Notice that we only have responses from our 2 Servers

Lab Summary

In this lab, we learned how to create and deploy device tags and use them for Coverage for our Instructions. 

Next Page
Ex 6 - Tachyon v5.2 - Using - Using Explorer - Quarantine a Device