Exercise Overview:

Instruction Sets and Management Groups

Instructions are at the core of Tachyon functionality. Instructions define what we can do in Tachyon, from asking questions to executing actions, as well as how the data is presented back. Different Instructions provide different functionality and must be added to Tachyon to realize the functionality provided in the Instruction. In this exercise, we will add some Instructions to Tachyon and organize them into Instruction Sets and review the functionality they provide. A bundle of Instructions in a zip file is called a Product Pack. Management Groups allow us to segregate our devices for granular reporting, targeting of instructions for both questions and actions and for role-based access controls.

Create a Tachyon Connector

Creating a Tachyon connector allows the Platform to use Tachyon Powered Inventory. This gives the Platform the credentials to access Tachyon data. If you are familiar with the SLA Platform for AppClarity you remember that we not only have to create connectors, but we have to either perform or schedule a sync. We then need to wait for our devices to run the instruction before we reprocess our cube data.

Create the Tachyon Connector

1ETRNW102

  1. Log into 1ETRNW102 as 1ETRN\Tachyon_AdminPP
  2. Open the Tachyon Portal in Google Chrome
  3. Launch the Settings Application
  4. Navigate to Configuration – Connectors
  5. Click Add. Select Tachyon in the Connector type field. Leave Repository Type set to Inventory
  6. In the Connector Name field type in Tachyon - Global - RCR
  7. In the URL enter https://tachyon.1etrn.local/consumer
  8. Note that, as stated above in the URL, "consumer" needs be added after the Tachyon server name, in the same way that Tachyon needs to be added to https://tachyon.1etrn.local when a Tachyon user browses to the Tachyon Portal.
  9. Scroll down to user name and enter 1ETRN\TachyonConnector
  10. In the Password field enter Passw0rd
  11. The option to Run Consolidation Reports is to bring in the additional Patch information available and is needed for Patch Success
  12. Check the Run Consolidation Reports checkbox and Click Add
  13. Select the Tachyon Connector and click Test. The test status will change to a green check mark if successful
  14. You can view the status in the Monitoring node - Process Log node

Create Management Groups

  1. Navigate to Permissions – Management Groups
  2. Click Add. In the Add management group box type in Lab Devices in the Name field
  3. In the Description field type in All the devices in our Lab
  4. Leave Evaluate rules immediately unchecked as we will be making a few Management Groups
  5. Scroll down to the Rules section
  6. In the first field select Device Computer Name – in the second field choose Contains. In the third field type in 1ETRN. Click Add
  7. Repeat the above steps to add the following Management Groups and Rules

  8. All Win7 Lab Workstations – Device OS contains Windows 7
    All Win10 Lab Workstations – Device OS contains Windows 10
    Sales Devices – OU Path contains Sales


  9. Now we will create a Management Group using 2 rules. Click Add
  10. In the Name field type in Lab Servers
  11. In the Description field type in All Servers in our Lab
  12. In the Rules section first rule line select Device Netbios Name contains 1ETRN. Click the + sign to add the second rule
  13. In the first field select AND
  14. We could also use an Or statement for our two rules – depending on the rule we were using.
  15. Set the rest of the fields to be Device OS Contains Server
  16. Click Add

Adding the Tachyon Inventory Product Pack

1ETRNAP

  1. In the Tachyon Portal navigate to Settings – Instructions – Instruction Sets
  2. Click on Upload in the upper right
  3. In the Open dialog box select C:\Temp\TachyonPlatform.v5.1.0.663\ProductPacks\Classic\1E-Inventory.zip click Open
  4. Click Add new set on the right to create a New Instruction Set
  5. In the Name field type in 1E-Inventory click Add
  6. Click on the Unassigned instruction set – Select all the instructions that you just imported and click move in the far right. Select 1E-Inventory in the move instructions popup. This will move all the Inventory instructions to the 1E-Inventory instruction set you just created
  7. Click Move

Assign 1E-Inventory Instruction Set to TachyonConnector

We need to add a custom role to assign our 1E-Inventory Instruction Set to our TachyonConnector user account. In our lab we are going to use Tachyon Powered Inventory as well as Management Groups. If we were using Inventory for Management Groups only these steps would not need to be done. In Tachyon Powered Inventory, an Instruction Set is used to collect inventory data from the devices. Our connector account must have the rights to issue these instructions.

1ETRNAP

  1. Navigate to Permissions – Roles. Click Add
  2. In the Name field type in 1E-Inventory
  3. Click Add
  4. In the Roles page click the 1E-Inventory role in the Name column
  5. The Permissions tab will be selected by default. Click Add on the right
  6. In the Type field click the drop-down and select Instruction Set
  7. In the Name field select 1E-Inventory
  8. Select the box next to Questioner. Click Add
  9. Select the Management Groups tab. Click Add on the right
  10. In the drop-down select All Devices. Click Add
  11. We want our inventory to pull from all devices in our environment so we will use the built in management group of All Devices. Using any other management group may only give us a sub-set of devices in our environment.
  12. Select the Members Tab. Click Add
  13. In the Add role member box start typing in Tachyon and select TachyonConnector from the list
  14. Click Add

Sync the Tachyon Inventory Connector

We will need to perform the next action as our Global Admin since our AppInstaller account does not have the permissions needed to perform a sync of a connector.

1ETRNW102

  1. Navigate to Settings – Configuration – Connectors
  2. Click the Execute button in the upper right
  3. In the Execute action popup – Repository field – choose Default Inventory. In the Action field select Sync Data – Tachyon - Global - RCR
  4. Leave the Data to Sync (Select All) checkbox checked
  5. Click Execute (you can monitor the progress in Monitoring→Process log)
  6. Once that completes navigate to Permissions – Management Groups
  7. Monitoring – Process Log will show all the actions associated with that sync and the status. Once all the actions complete Monitoring – Sync log will show the details. You may have to navigate to other pages of the log to see the details for the current sync. Note the boxes in the lower right that allow you to choose the number of records to display in the pane.
  8. Click on each group to see the number of members
  9. Our Sales Devices Management Group is empty. Why? Hint – Look at the Sales OU on 1ETRNDC.
  10. You can see the actual members list of the Management Group from the Explorer application Devices – Tables. We will look at that now
  11. Click on Switch app and select Explorer
  12. We recommend you open one tab per application when using Tachyon to say constant switching between applications.
  13. Navigate to Devices – Table. Click in the Management Group field at the top and select each management group in turn to see the members
  14. If you do not see the devices populated yet, do not worry. We will come back and check in a bit.

Adding the Tachyon Platform Product Pack

The 1E-TachyonPlatform Product Pack has been designed to ensure the inner workings of Tachyon, both the server components as well as the clients and connectivity between the two, are functioning properly. In this task, we will add the Product Pack and validate the environment.

1ETRNAP

  1. In Chrome Navigate to Instructions – Instruction Sets. Click the upload button to upload the instruction directly
  2. In the open window – navigate to C:\Temp\TachyonPlatform.v5.1.0.663\ProductPacks\Classic
  3. Select the 1E-Tachyon-Platform.zip. Click open
  4. Notice that there are now 2 instructions in the Unassigned instruction set
  5. All instructions go into the unassigned instruction set when imported into Tachyon. We cannot use any instructions in the unassigned instruction set – we must move them to a named instruction set.
  6. Click the Add new set button on the far right. You can also click the + sign just behind the Sort By Alphabetically A-Z box to add an instruction set
  7. In the Add new instruction set box type Tachyon Verification in the Name field
  8. We could choose a custom icon if we would like to. We will skip that for now.
  9. Click Add. The system will put you back on the Instruction sets page
  10. Select both instructions in the unassigned instruction set and choose Move – Select Tachyon Verification and click Move
  11. Confirm that both Instructions are now in the Tachyon Verification Instruction Set

Check the Status of the Product Pack Upload

1ETRNAP

  1. Open File Explorer and navigate to c:\programdata\1E\Tachyon and open Tachyon.ConsumerAPI.log
  2. Search for Successfully imported instruction in the log and note the Instruction Sets uploaded

Your log should look similar to this one.


  1. After the upload, note the creation of the Instruction Set as well as the 2 Instructions being added to the new set. In the same log
  2. Start SQL Server Management Studio from the start menu
  3. Expand to Databases > TachyonMaster > Tables
  4. Right-click the dbo.InstructionDefinition table, and select Select Top 1000 Rows
  5. Note that the Instructions we added to Tachyon are displayed in this table, along with the default settings for the Instructions as defined in the XML files
  6. Right-click the dbo.InstructionSet table, and select Select Top 1000 Rows
  7. Note the Instruction Set we created, Tachyon Verification, is listed here

Validating the Tachyon Platform Instruction Set

Now that a Product Pack has been added to Tachyon, we will validate the Instructions within it. We will execute these instructions through Tachyon and review the details of the contents of the Instruction Set file.

Validate Instruction Set through the console

1ETRNW71

  1. You should still be logged in as 1ETRN\Tachyon_Admin1
  2. Launch the Tachyon Portal if it is not already open, with Google Chrome. If the Portal is already opened – click on Switch app at the bottom and select Explorer
  3. Click on the Home node. Note there is an All Instructions link on the top right on the page
  4. Click on All Instructions. It will now display the Instruction Sets which we added to Tachyon, and the associated questions and actions. Click Close
  5. In the I want to know space in the middle of the page, type in Tachyon. Click on the Tachyon Platform verification stage 1 question
  6. Note a Parameters section will appear. Click Edit
  7. On the right-hand side of the page, editable parameters will be presented
  8. Explore the different configurable parameters
  9. Note the number of devices connected at the top of the console page
  10. Without configuring any of the parameters, Click the Ask this question button
  11. Review the results. Scroll down to ensure all 7 machines are reporting inventory back
  12. Stage 1 of the Tachyon Verification Instruction Set gathers software inventory for all the machines that are currently online. By default, the question is set to run for 60 minutes, so any machines not currently online will have a chance to respond to the question within the next 60 minutes
  13. You will drop to the Content tab of the Results Page. You will see 5 tabs. Summary, Content, Status, Questions, and Actions
  14. Click on Summary. Review the different data presented here. Validate that all 7 machines have run the instruction successfully
  15. Click on Actions. On the right, click on the All actions button. Expand Tachyon Platform to see the Stage 2 action available. Click Close
  16. In the search box in the middle, type in Stage 2. Click on Tachyon Platform verification stage 2
  17. Click Perform this action
  18. As this is an action, it will require approval. Further to that, we have enabled Two factor authentication, which will require an authentication code
  19. Input the password for Tachyon_admin1 and click Confirm and Send
  20. Open LiveMail from the desktop.
  21. Click on Unread Emails under the Quick views section on the top left
  22. If an email with a subject of Instruction X requires authentication is not present, click the Send/Receive button in the ribbon up top to refresh email
  23. From the email, get the authentication code provided by Tachyon and input it in the field in the dialog box and click Submit
  24. Leave LiveMail running but minimize it – we will need it for future exercises
  25. Note the action now shows Instruction X pending approval.  We must now approve the action with a different user that has rights to approve actions

1ETRNW73

  1. Launch the Explorer Application if not already open in Google Chrome
  2. Navigate to Notifications. You should see a Pending Request
  3. It might take a few seconds for the notification to appear
  4. Open LiveMail from the desktop. Click on Unread emails under the Quick views space on the top left
  5. Note an email with a current time stamp with a subject line of Tachyon action X requires approval
  6. Open the email and click on the Go to approval page link
  7. The Explorer Application will open on the Notifications screen. Click on the pending request. Review the details of the request. Input something in the comment section
  8. Check the I understand the impact of this instruction and approve this request box
  9. Click on Approve. Note that the Approval has been processed successfully
  10. Note that you could have approved the request at step 100, but we have shown both ways of seeing the approval here.

1ETRNW71

  1. Return to the Explorer Application
  2. Click on Instructions – History
  3. Find the Tachyon Platform Verification Stage 2 instruction in the list. Click on it to open the details
  4. Note that the action has now begun and that an email has arrived in the inbox stating that the action has been approved. You can see the comments that the approver added in the reason for approval section of the email
  5. Review the results of the action. Pay attention to the Default Stagger Range Seconds
  6. Stage 2 runs a script which returns all the Tachyon client settings from the clients. It will take up to 300 seconds for all the clients to report back in. In a later lab, we will execute another action which will change a setting on the clients. Guess which one?
  7. Navigate to c:\program files\1E\Client
  8. Right-click on 1E.Client.conf and edit with Notepad
  9. Review the different sections. Note the settings defined. These are the settings returned when executing this action. Compare the settings returned in Tachyon to those in the conf file
  10. Close Notepad ensuring no changes were made
  11. Click the Stop button in the Content page in the Explorer Application to stop this instruction once all 7 clients have finished executing the Instruction

Review the Instruction Set file

In this task, we will explore the contents of the Product Pack zip file. We will see what the Product Pack entails at a high level. In later labs, we will dive deep into the inner workings of the Instructions and create Instructions from scratch.

1ETRNAP

  1. Open File Explorer and navigate to C:\Temp\TachyonPlatform.v5.1.0.663\ProductPacks\Classic
  2. Right-click on 1E-Tachyon-Platform.zip and select Extract All…
  3. Leave the location as default and click Extract
  4. Note a folder named 1E-Tachyon-Platform is created by WinZip
  5. Review the contents of the folder
  6. Double click the Stage1 file and open in IE. Note the format of the XML
  7. Repeat for Stage2. Note the format is quite different. Scroll down to the Resources section and look at the Resource Name ="getConfig". Notice the Content HashFileName, and Type. Note that the content type is PowerShell
  8. Instructions can use native Tachyon agent language to perform different queries and tasks on clients, or they can use scripts. We will discuss this in further detail later in the course.
  9. Return to SQL Server Management Studio
  10. Expand to Databases>TachyonMaster>Tables
  11. Right-click the dbo.InstructionDefinition table, and choose Select Top 1000 Rows
  12. Note that the PowerShell script from the resources folder is listed here under the Payload column for the Stage 2 Instruction
  13. You will have to scroll over and expand the field to see the @script
  14. Navigate to c:\programdata\1e\tachyon
  15. Open the Content folder. Note the .ps1 file from the Stage 2 Instruction under the 1E-TachyonPlatform-VerificationStage2\getConfig folder
  16. The resources of any required action will be placed here so clients can download it using the Background Channel (or via 1E Nomad v6.1 or later, if installed on the clients).
    The Background Channel has a random stagger setting, which we paid close attention to earlier. The DefaultStaggerRangeSeconds is set to 300 by default, which will cause clients to have a random wait time between 0-300 seconds when downloading content from the Tachyon server.
  17. In SQL, expand to Databases>TachyonResponses>Tables
  18. Right-click Tables and click Refresh
  19. Right-click the dbo.Response_1 table and Select Top 1000 Rows
  20. Note the results from the Stage 1 Instruction are listed here
  21. Repeat the same for the other dbo.Response_X tables

1ETRNW71

  1. On 1ETRNW71, navigate to c:\programdata\1E\Client
  2. Open 1E.Client.log. Do a search for .ps1
  3. Note that the Tachyon agent is downloading the PowerShell script from the Tachyon server using the Background Channel

You log will look similar to this one

Lab Summary

In this lab, we worked with instructions. Instructions are at the core of Tachyon functionality. They contain information on what can be processed via Tachyon and define the format of the output presented to the administrator.  Instructions can be provided by 1E, but can also be created from scratch, or modified to get specific information required by your Enterprise. In a different course, we work with the Tachyon Instruction Management Studio (TIMS) to modify create our own Instructions.

Next Page
Ex 5 - Tachyon v5.1 - Install and Configure - Working with Instructions