Professional Documents
Culture Documents
ITAM-1300 Lab - Mannual - 23.10.3
ITAM-1300 Lab - Mannual - 23.10.3
ITAM-1300
IT Asset Management
Administration
Lab Manual
FlexDCData – This system acts as both the Active Directory Domain Controller as well as the SQL
Database Server for the inventory and business adapter staging databases.
flexdcdata.flexeratraining.com (Green)
There will be a delay the first time you log on to the systems while they start up from a
suspended state.
4. You will see the progress of the systems starting up. Wait for the systems to finish starting up
before viewing the virtual systems.
5. You can then connect to each system in turn and logon by clicking the tab for the system, or the
View VM link next to each system.
Note: The environment typically suspends after an hour of inactivity. When returning to CloudShare,
go to http://use.cloudshare.com, click the Resume button to spin up the VMs again.
5. Add an Advanced Filter . Click on the link above the column headings.
6. Add the Version field to reflect:
7. To add the Version, click on the “+” after And. Click on the blue field and select Version.
8. Click on the green conditions and choose “is between”.
9. Click on the first <enter a value> and enter 2013. Hit Enter.
10. Click on the second value and enter 2019. Hit Enter. Click OK. Notice the version list is reduced
to those between the version values.
11. Export the data in XLSX format, open the file to view the report.
15. Use the Pre-Defined filter options on the top left of the view to filter on Alert is Blank
serial number. Click on the blue check mark.
Note: New (invited) user accounts will not have roles in IT Asset Accounts by default.
Lab 5. Categories
Categories and Enterprise Groups behave the same: manually add entries or leverage a business adapter to create
entries. The One-Off Upload under Data Imports can also be leveraged, note that these imports revise and add,
they do not delete. The Purchase Order import capability will look for any enterprise groups assigned to purchase
orders; if not found it will create entries.
Module 9. Categories
1. Navigate to Organization/IT Asset Categories. Add the Path column.
2. On the row for Categories (first row), click the “+” under Actions.
3. Type in the value “Phase 1”. Hit enter.
4. Navigate to Licenses/License Management/All Licenses. Click Create a License.
5. Search the application “Adobe Acrobat X Standard”. Select the appropriate application and click
Add Application.
6. For the License model select the Perpetual – Device (Volume Purchase) model. Click Create.
7. On the Identification tab, apply the Category “Phase 1”.
10. Click the Column Chooser , select and drop Category and Location into the view.
35. Click on the breadcrumb Managed SaaS Applications, The My SSO App should now be visible.
10. Set a simple filter search for Name = “Operating Company 1 APP”.
16. Set a simple filter for name contain “APP 1” and Source “Local”.
17. Confirm the application exist.
Note: The “approved” version is used for automated beacon upgrades which is not a best
practice. We set the “Do Not Upgrade Automatically” when the config is downloaded so there
are no surprises, and the beacon upgrade can be tested and follow change control processes.
3. Once the file is downloaded, click Show in folder, right-click on BeaconInstallerXX.X.X.X.exe and
Run as Administrator. Install pre-reqs. Click Next on the install screen. Click Agree, Click OK.
4. Choose Custom, click Next. Expand and review the install options. We will allow all options.
Notice the install folder.
5. Click Next. Keep the default distribution folder, Click Next. When prompted in the Configure
Scheduled Tasks screen, select Configure scheduled tasks and Run as a named user: and enter
the credentials for the ITAM Service account as follows (this is specific for the scheduled tasks):
a. Username: flexeratraining\svc-flexnet
b. Password: F1exera!
6. Click Next, Finish, Install. Click Finish.
Tip: Its usually best to have these services running as a service account rather than the local system,
especially when the beacon will be connecting to remote systems with adapters. As such, we will set
the Flexera Inventory Beacon Engine to run as the flexeratraining\svc-flexnet account.
10. Expand the tree on the left to show Flexera Inventory Beacon task folder. These tasks need to
be monitored to ensure that they are all running successfully with no errors. For now, ignore any
errors since we have not configured the beacon yet.
Tip: You can change the properties of the application icon under Compatibility to Run this program
as an administrator.
16. Click on Parent connection, Under Connection Details, click Enable parent connection.
17. Then under Configure inventory beacon connect, click Download configuration.
18. Select the org if requested (and Chrome) and sign in (if not automatically signed in).
19. In Flexera One, under Configure a Beacon:
a. Parent Beacon: blank (default: no hierarchy of beacons in the lab)
b. Name: ITAM SCCM Beacon
c. Upgrade mode: Do not upgrade automatically (best practice)
d. Configuration status: Enabled (default)
20. Click Download Configuration. This will create the flxconfig file.
21. Return to the Beacon application, click Import Configuration. Open the config file
(C:\Users\fnms-admin\Downloads). Notice the Succeeded messages under Test connection.
Note: If the import file creates an error, check the reg key
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ManageSoft Corp\ManageSoft\Common
to match the flxconfig name.
25. Validate the beacon in Flexera One by navigating to Data Collection/IT Assets Inventory
Tasks/Beacons.
Note: This will clear itself when the beacon engine downloads the initial business importer
templates. In addition, all the buttons on the Business importer page will be disabled until the
templates are downloaded. It may take a few minutes for the beacon engine to download the
business importer templates. This is a job that runs in the background.
27. You will know the latest Data Domain Interface (DDI) business adapter templates have
successfully downloaded when you can click the New button to create a new adapter and you
are able to select a template from the Adapter Template drop down menu. You can test by
clicking New then cancelling out when done viewing the different template.
28. You can view the DDI templates once they are downloaded in the following directory:
C:\ProgramData\Flexera Software\Beacon\DDI
29. If you do not see the templates after 15 minutes, then you can also view the log file by clicking
on the Open Log File Folder button
32. Open the Task Scheduler > open Flexera Inventory Beacon folder. Right-click on Upload
Flexera logs and inventories and choose Disable this task.
Tip: Do not put a check in “Do not show me this again”. It is a good reminder that you have kicked
off a process in the Beacon UI and checking that box will prevent you from executing things twice.
Note: For previous versions of Flexera One and FNMS, beacon servers would automatically create a
“Current domain” connection as part of the installation, leading to unnecessary data coming in for
customers with multiple beacons on the same domain. This functionality was removed as part of the
19.2.0 release of the beacon server. If an older beacon is upgraded to 19.2.0 or later, it will remove
any Active Directory connections named “Current domain”, so we recommend naming your Active
Directory connections for the domain name and making sure when upgrading that you ensure to
recreate the domain connection where applicable.
38. On the Beacon VM, the data is briefly cached in the following location, but then quickly
uploaded into the database by the scheduled task, which runs every minute by default.
C:\ProgramData\Flexera Software\Incoming\ActiveDirectory
Warning: If the beacon is working correctly, you will NOT see the file cached here. Instead, it will
automatically be uploaded to Flexera One. We will see the results of the Active Directory
synchronization later in class as we view imported sites and subnets.
39. Re-enable the schedule task to Upload Flexera logs and inventories after you have reviewed the
log files.
40. Once the Active Directory data is uploaded to Flexera One, it will be added to the data store,
which is where all raw computer data from all sources is stored prior to merging into unified
computer records.
41. To force the synchronization of the data in Flexera One, you will need to run a complete license
reconcile with an inventory update. In Flexera One, navigate to Data Collection/Process Data/
Reconcile page, check the box to Update inventory for reconciliation and click the Reconcile
button.
Tip: in System Tasks, you can click on the Task/Step “+” and “-“ to refresh the status.
52. Click Next, click Install to install the components (if any are missing).
53. Click Close once the Feature installation finishes.
54. Exit and launch the FlexNet Beacon application (as Administrator).
55. Click on Local web server on the left-hand menu, click IIS web server and click Save in the lower
right.
WARNING: When you save settings on production beacons, it will also show this prompt. If you are
using any inventory sources that require setting custom IIS settings (for example, SAP inventory
requires Basic authentication) you will want to click Cancel every time after you do this the first time
so that the custom IIS settings are not changed.
57. To verify the IIS Management Console is available, on Tools within Server Manager and click
Internet Information Services (IIS) Manager.
58. Expand the FlexBeacon web server and click on Application Pools where you should see the
Flexera Beacon and SAPServiceAppPool application pools used by the beacon:
59. Expand the Sites Default Web Site and you will see the following applications/virtual
directories.
4. From the Password Manager, click New to create a new Password Manager entry
and enter the following in the text boxes on the right-hand side of the screen:
a. Logical Name = Domain Admin
b. Account Type = Windows domain account
c. Domain = flexeratraining
d. User = Administrator
e. Password = F1exera!
f. Confirm Password = F1exera!
g. Click Apply to save.
5. Select the Domain Admin account on the left and you will be able to view the details and/or edit
the account if needed.
g. In the Filter window, add flexbeacon and flexdcdata under Device names separated by
a comma (make sure to read the text to understand how to apply filters).
8. To view sites and subnets that have been imported from Active Directory (AD), open the
Inventory/Network Discovery/All Subnets page.
9. Expand the sites by clicking the + signs or by using the Expand All icon.
10. You should already see the following sites and three subnets as examples.
a. Chicago – 10.200.0.0/16
b. Chicago – 192.168.0.0/16
Note that while the subnets under Chicago are marked as Enabled, they are NOT assigned to a
beacon since there is no Beacon name.
11. Open the Inventory/Network Discovery/Unassigned Subnets page.
12. Select each subnet for Chicago.
16. To change the assigned beacon, click the Edit button for a subnet, then you will be
able to select a beacon from the resulting drop-down menu under the Beacon name column.
Note: You can only assign subnets to beacons. You cannot assign sites to beacons. However, even
manually created subnets should be added to sites to streamline targeting for Discovery & Inventory
Rules.
Note: Subnets should be created within sites to streamline discovery and inventory targeting.
18. Name the site Atlanta. Sites usually have names associated with locations such as Chicago or
San Jose. Make sure to click to save the site name.
20. Type in the following subnet using standard CIDR notation: 172.26.80.0/24.
Tip: This should match one of the systems found in the Unmanaged Devices view. Adding the subnet
to a beacon will force the subnet to be managed and the device will no longer be found in
Unmanaged Devices.
21. Select ITAM SCCM Beacon under the Beacon name column, select Enabled then click then click
the Save icon to save.
Tip: Pressing the ENTER key on your keyboard will also save the entry if you are in the IP text field
but will not work after selecting the pull-down menu. Making sure the new subnet is assigned to an
active beacon is critical; if the subnet is unassigned, it cannot be used for discovery or inventory.
22. Create a second IP subnet under the Atlanta site to match the subnet of ITAM SCCM Beacon
and all the servers in our training environment. Make sure to assign that subnet to ITAM SCCM
Beacon.
a. FlexDCData: 10.160.0.6
b. FlexBeacon: 10.160.0.8
In this case, the IP range is defined by 10.160.0.0/24. Create the entry under the Atlanta site
assigned to ITAM SCCM Beacon as well, so that there are now two subnets managed by the
ITAM SCCM Beacon in the Atlanta site.
23. After saving the subnets and assigning the beacons, lets now go check out the Unmanaged
Devices to see if this caused any change in the list. Navigate to Inventory/Network
Discovery/Unmanaged Devices.
The objective of this lesson is to create a rule that will initiate discovery and inventory on the subnet where the
Beacon resides (created in the Managing Sites and Subnets lab).
9. The “on these Targets” should already have the Training Site attached. If not, click Targets to
Add To Rule Builder next to Training Site.
10. Now that you have a target and action, you are ready to schedule and create the rule. Click
Schedule in the rule builder at the top to continue building the new rule.
15. Then click the Save button to save the new rule.
16. The resulting rule will show in the list of rules under the Rules tab.
Note: You can verify the rules currently configured on the beacon by viewing the Rules page of the
FlexNet Beacon application. The rule will appear until it is run. Once the rule is run, if it will not be
repeated, it will disappear from the Rules tab.
17. Make sure you are logged on to the FlexBeacon system (Blue).
18. Open the Beacon application and navigate to the view of Rules/task lists which are under
Discovery.
19. If My First Rule is not already visible, click the Update Rules button to force an update of the
new rules, this will take a minute or so.
20. You can force the rule to run by selecting My First Rule from the list, and then clicking the Run
26. Make sure your Only show last run filter is set to No (if you have forced the rule to run).
27. Click on the “+” in from of the My First Rule task to refresh the System Task status periodically it
completes.
29. Create a second rule. Click on Targets and use the same target (Training Site) and click Add to
rule builder.
33. Make sure that the box for General hardware and software inventory Gather hardware and
software inventory from all target devices is unchecked.
34. Check all boxes under VMware infrastructure and Hyper-V.
35. Scroll down to the bottom of the page and click Create.
39. Name the new rule Atlanta VM infrastructure and ensure it is Enabled and then click Save.
Tip: Rules should be named so they can be clearly and uniquely identified from the Rules page. You
should establish a naming convention before setting up rules that cover multiple actions, targets, and
schedules.
40. Return the Rules tab in the Beacon application, click Update Rules.
41. Wait a minute or two until the beacon policy is downloaded, and the new rule will appear. You
should also see your first rule in the list and if it has already run, it will have a Last run date but
not a Next run date as it was a Once only rule.
Tip: You can choose to run the rule by selecting the rule in the Beacon application Rules list and
clicking the Run button. Newly discovered devices will appear in Flexera One after the Beacon has
uploaded its discovery data.
43. Sometimes you must navigate away from the Rules page in the Beacon UI for it to refresh, but
eventually you should see a Last run date for each of your rules.
44. On the Beacon VM, you can review the file to view the rules in the Beacon Policy:
C:\ProgramData\Flexera Software\Beacon\BeaconPolicy.xml
45. Rules will run according to the schedule set for the rule. The beacon engine triggers the rules to
be run. Beacon engine log files can be found on the beacon in:
C:\ProgramData\Flexera Software\Compliance\Logging\BeaconEngine\BeaconEngine.log
46. Additional logging can be configured in the etdp.trace log file. This should have been configured
in an earlier lab, but you can confirm the Discovery was enabled, and if so, you can then check
the log file. The trace configuration file can be found at:
Verify the # pound sign in front of + Discovery has been deleted to uncomment the tracing.
Right-click and use Notepad or Notepad++ to edit the file.
C:\ManageSoft.log
Tip: You can change this path by editing etdp.trace as we showed in an earlier lab.
49. Discovery and inventory rule results are uploaded to the application server by the Upload
Flexera logs and inventories scheduled task on the beacon.
50. If the data is waiting to be uploaded, it can be found in the following location:
C:\ProgramData\Flexera Software\Incoming\Discovery
51. If you find a BadLogs folder, open the folder to see if any of the discovery jobs were uploaded
here.
52. If there are discovery files copied here, it is always worth a try to copy the files back to the
C:\ProgramData\Flexera Software\Incoming\Discovery folder to attempt to have them
resolved again.
55. The Rule Execution Details will list each system that a task was attempted to run on with the
results shown in the summary.
56. Return to Data Collection/IT Assets Inventory Status/System Tasks list again.
57. Click the Expand all icon to expand the Rule to see which beacons the rule was run on and
the steps on each beacon.
Tip: If the rule appears to have run on the beacon, but you don’t see any System Task, or the System
task appears to hang as In progress without updating, it could be because the status logs from the
beacon have gotten hung up.
59. Results of discovery and inventory rules will appear in Flexera One under Inventory/Network
Discovery/All Discovered Devices. You can filter by IP address begins with 10.160
60. Open the FlexDCData discovered device by clicking on the name hyperlink.
61. Under the status tab , you should be able to view the Rules applied to the
device, as well as the Discovery status of which rule discovered the device when.
62. Every night, or when a reconcile with Update inventory for reconciliation is run, Flexera
normalizes the inventory which will be reflected in Inventory/Inventory/All Inventory page.
63. Filter the All Inventory view of Name Begins with Flex.
64. Go ahead and run a reconciliation at Data Collection/Process Data/Reconcile with a full
inventory import to view the results of the inventory on the FlexDCData system.
65. Once the discovery has completed, the beacon will also upload log files that are available in the
Activity Log of Flexera one.
67. It is helpful to group this view by Source type as well. Most logs related to Discovery and
Inventory Rules will appear under the Source type: Beacon.
Tip: When you use the adoption feature of IT Asset Management, the configuration of the agent will
occur automatically.
9. Close the beacon policy file. We now are ready to install the agent, assured that the agent can
download its initial configuration from the beacon.
Good Practice: It is best to use the latest agent since it will often contain updates to the agent
functionality, as well as periodic fixes. Most customers use third-party deployment tools like
Microsoft Endpoint Configuration Manager to deploy their agents, which will require updates to
deployment packages when a newer agent version is released. Do not feel required to upgrade to the
latest agent every time. It is best to check out the latest Features by Release and Gathering
Inventory documentation to see if there are useful changes to the agent.
14. Click Download after selecting the appropriate agent. This will download a zipped file.
Tip: All other operating systems specify the OS in the agent’s name, but the Windows agent is called
FlexNet Inventory Agent. Make sure to use the latest agent version available which should be the
highest version number (which is found at the bottom of the drop list of agents).
16. Return to Flexera One and the Inventory agent for download section. Click on Download
bootstrapping template file. Click Keep to continue the download if prompted.
17. Right-click on the mgssetup.ini file and click Show in folder. Copy the file to the folder of the
agent i.e. the folder managesoft-xx.x.x.
18. In the folder managesoft-xx.x.x, right-click the mgssetup.ini file and choose Edit or Edit with
Notepad++ to open and view the file.
20. Scroll down until you find the DEPLOYSERVERURL setting. Make sure there is no semicolon in
front of the line. Make sure the DEPLOYSERVERURL is set to the name of your beacon server
download URL. In our case http://flexbeacon.flexeratraining.com/ManageSoftDL.
21. Scroll down until you find the section for Arbitrary command to run at completion of
installation.
22. Uncomment and edit the two lines as follows:
RUNCMD = cmd.exe
RUNCMDARGS = /C start ndtrack -t Machine -o
UploadLocation=http://flexbeacon.flexeratraining.com/ManageSoftRL
Good Practice: It is a good practice to initiate an inventory scan immediately after the installation of
an agent. The RUNCMD executing on completion of the installation helps do to this. The RUNCMD
cannot contain system variables or spaces.
Note: While we could initiate an MSI silent installation command, it is good to see the installation
options, so we will run the setup.exe directly which then calls the ManageSoft for managed
devices.msi. All the options we will be viewing can be set either in an MST transform file, or in the
command line options of the installation command.
25. If prompted from SmartScreen, click Run. Click Next when presented with the Welcome screen.
26. Put a check in I agree to the Clickthrough Purchase Agreement then click Next.
27. Enter any User Name and Company then click Next. (This is not a critical configuration).
32. Choose to Directly access the internet instead of using a proxy then click Next. This setting has
more to do with how the client communicates to the beacon instead of how it communicates to
the internet.
33. Click Install on the final page to commence the application installation.
34. Click Finish to complete the installation and close the installation wizard.
Tip: The ultimate test of the client being adopted and receiving its critical configuration is to make
sure the client has downloaded its client schedule that tells the client what to do and when to do it
which is in C:\ProgramData\ManageSoft Corp\ManageSoft\Schedule Agent\Schedules
35. To verify if the inventory scan occurred, open the File Explorer, navigate to C:\Users\fnms-
admin\AppData\Local\Temp\ManageSoft.
Note: If the tracker.log file is not found there, look under C:\Windows\Temp\ManageSoft which is
where the agent service will record its logs.
36. Double-click (or right-click for Notepad++) on the tracker.log to open the file.
37. Scroll down to make sure that the inventory uploaded, and the program exited successfully.
39. To confirm this schedule has located the beacon from the mgssetup.ini DEPLOYRSERVERURL
setting and downloaded the policy and schedule as defined in the INSTALLMACHINEPOLICY
setting, you can open the schedule from the FlexDCData server, open the following folder path
in Windows Explorer.
C:\ProgramData\ManageSoft Corp\ManageSoft\Schedule Agent\Schedules
40. Right-click on the sched.nds file and select Edit with Notepad++.
42. Note the time of the next inventory. The inventory should run so that the automated reconcile
with an inventory import that occurs overnight will result in the inventory appearing in
Inventory/Inventory/All Inventory.
43. As a troubleshooting tactic you can also open the schedule agent and run the inventory
manually.
Note: Since we are logged into the beacon, this is the same as local directory.
C:\Program Files (x86)\Flexera Software\Inventory Beacon\RemoteExecution\Public\Inventory
But this will not usually be the case. The UNC provided is the default folder used by the beacon to
share for remote execution of the inventory during Discovery and Inventory tasks.
Good Practice: Because the newly deployed beacon will always contain the latest inventory tracker
files, we should copy the latest files from the beacon after the beacon has been updated to any
folder we use to execute a command line inventory from.
Tip for non-Windows device inventory: use the ndtrack.ini and ndtrack.sh files to deploy the light
scanner on a UNIX or Linux system. For more information on NDTRACK see
GatheringFlexNetInventory.pdf
48. Run the following command to kick off an inventory scan and upload to the beacon.
49. Check the tracker log file located underneath the %temp%\ManageSoft directory for
Administrator:
C:\Users\fnms-admin\AppData\Local\Temp\ManageSoft\tracker.log
— or —
C:\Users\fnms-admin\AppData\Local\Temp\2\ManageSoft\tracker.log
50. From this log file, you can view the collection of inventories, as well as the upload status of the
inventory. If there is an issue with the upload you will see it here. Look for the Uploading file
and Upload successful messages.
52. Enable the scheduled tasks again and force them all to run.
The FlexBeacon inventory record is uploaded to the Flexera One but is not merged into the
Normalized database yet since a full reconcile needs to be run with an inventory import.
53. Use the same process to run the command line ndtrack on FlexDCData.
54. Open Flexera One and navigate to Data Collection/Process Data/Reconcile.
55. Check the box to “Update inventory for reconciliation” and click Reconcile.
56. Once the reconcile is complete, navigate to Inventory/Inventory/All Inventory page to view the
updated inventory.
57. Enter and search for the beacon server name into the global search field in All Inventory.
58. Scroll to the right to find the Last Inventory Date column. You should see today's date on the
beacon record after the inventory has been reconciled in Flexera One.
59. To view the exact time of the last update, open the beacon inventory record and view the
History tab where you will find a list of updates with date and time.
Warning: There will be an error condition in this exercise to help with troubleshooting, please do not
be alarmed.
3. Click the New button to create a connection to a SQL Server data source.
Note: To choose other data sources, select the drop-down arrow next to the New button.
Tip: Make sure to tab out of all the fields you have entered data in before clicking to Test the
connection.
Issue Alert: If the connection fails, you will still want to save so we can see the errors that occur
when connecting to the DB and we can troubleshoot later.
11. The resulting inventory connections list should look as follows on the Inventory systems page of
the Beacon UI:
17. Click Save at the bottom right of the screen to save the change of schedule, click OK.
18. Do the same for the My New SCCM inventory connection, but this time select the Default daily
schedule.
21. The inventory will now import into the FNMSInventory database according to the selected
schedule.
24. The uploaded data can be found in the following file location on the FlexBeacon system until
the Upload third party inventory data scheduled task has run:
C:\ProgramData\Flexera Software\Beacon\IntermediateData
C:\ProgramData\Flexera Software\Beacon\IntermediateData\Uploaded
C:\ProgramData\Flexera Software\Compliance\Logging\ComplianceReader\importer*.log
27. If the zip files were not immediately updated, you can expedite the upload process by manually
executing the Upload third party inventory data scheduled task.
Note: If you have an issue with the imports, you can reboot all three of your systems and try again.
At times there are issues with the CloudShare network that can be reset by either rebooting or
disabling and re-enabling the network connections in console mode (the reboots seem to work more
often).
Troubleshoot Connectivity
28. To view the progress of your inventory imports in Flexera One, navigate to Data
Collection/System Tasks view.
29. View the My Old SMS and My New SCCM Imports.
30. Once the imports have been completed, you should see the following:
31. To diagnose the permissions issue, we will want to look at the SQL permissions for the svc-
flexnet services account on the SMS database.
connect.
34.
38. Select the SCCM database which was successful to view the permissions assigned. The
permissions should be db_owner & public.
43. Return to Flexera One. In System Tasks, make sure that the import and reconciliation completes.
44. The status will remain in progress if the system task is running. You can refresh the web page to
view a status change.
46. Once the import and reconcile has finished, view the successful status from the System Tasks:
48. The expanded steps will also show each steps status, and any log files available for download.
49. Look at the status of the two SCCM data imports and make sure to download and view the logs.
50. From Flexera One, navigate to Data Collection/IT Assets Inventory Tasks/Data Imports.
51. Select the Inventory Data tab.
52. You should see both inventory connections: My New SCCM and My Old SMS.
53. Check the drop-down arrow on the right of the My New SCCM Inventory Data connection.
54. From here you can view the status of the inventory source connections, including which beacon
they are connected to as well as the number of devices imported. Make Primary will set a
particular inventory source as the primary inventory source.
57. Change the Tasks run in the last 14 days to Tasks run in the last 30 days.
58. When you want to focus on one data source, you can add a Filter on the Task type. Filter on
Task Type = Inventory Import.
59. You should now see all inventory imports from the last 30 days, including the spreadsheet and
several FlexNet Manager Suite Inventory sources.
66. Execute the follow commands (answer Yes on the questions, or “A” for All):
67. Open the Beacon UI and select the Inventory systems page.
68. Click the New button to create a connection to a PowerShell source.
69. Enter the following under PowerShell Connection properties:
a. Connection name: FlexCustomer Azure Inventory
b. Source Type: Microsoft Azure
c. Azure Tenant ID: 06f0db06-cac1-41f9-9681-8c5bb4f537bd
d. Application ID: 17817e9c-64f7-469a-bbc4-50a8ccebcae5
e. Application Password: mEN8Q~eDzG82u2ugYpMiNWX-zzCngowjd0qBOagB
f. Environment: Leave Blank
70. Click Test Connection button to test the connection. This will take a while. Click Save for
inventory connection.
71. In the beacon click Save and click OK.
72. Select the Scheduling menu on the left. Select the Daily 1 PM Test Schedule
73. Click Save at the bottom right of the screen to save the change of schedule, click OK.
74. Highlight the connection ITAM Azure Inventory and click Execute Now.
75. If the zip files were not immediately updated, you can expedite the upload process by manually
executing the Upload third party inventory data scheduled task.
76. Run the scheduled task for 3rd party inventory.
77. Observe the task in System Tasks including Reconciliation.
85. Add the column “Windows Server AHB”. Observe the PAYG for Pay As You Go and BYOL for
Bring Your Own License.
86. You should see several Azure instances; likely most will be terminated/stopped.
Note: Typically, data flows from IT Asset Management to IT Visibility but this needs to be requested
at the time of the org provisioning.
4. Verify the connection and resulting ZIP file in the following directory:
5. If the Intermediate never shows up, you can check Compliance Logging on the Beacon under:
6. If the Intermediate does show up, you can check Compliance Upload Logging on the Beacon
under:
7. You can also check the status of the schedule task designed to upload third party data.
8. Once the data has been uploaded you will find the zip file in on the beacon in the following
folder:
9. You can extract the zip file to verify the data collected from the inventory data source.
10. Sometimes, the Beacon Engine can be misconfigured, and cause issues upload date. You can
check Beacon Engine logging on the Beacon under:
Properties
4. While the Update AltEmail object is highlighted in the left pane, update the items in the right
pane:
a. In Properties, uncheck Encrypt Connection Information.
b. In CSV File Properties, check First row contains column names.
c. Open the file under File Name: (clicking on the three dots on the right of the field)
d. The Query Text should read “select * from [Email Update Adapter Data File.csv]”
e. Click on the refresh icon ( ) to load the fields. The status bar at the bottom should
state “Property list has been successfully loaded.”
f. Scroll to Tracing, check Created records, Deleted records, Updated records, Rejected
records. Set the Column(s) for tracing to [accountName].
5. Click in the left field list on Data. Click Load Data to see the field list and rows.
Location
7. Right-click on the Update AltEmail in the left pane and choose Add New Item Enterprise
Groups Location.
Corporate Unit
12. Right-click on the Location in the left pane and choose Add New Item Enterprise Groups
Corporate Unit.
13. Click on Corporate Unit in the left pane.
a. Check the Update existing objects in the database.
b. Confirm the check for Create new object in the database.
c. Change Update Rule from null to Reject duplicate records (this produces a unique set of
Corporate Units).
14. Select the Name field under Corporate Unit on the left, and set the following:
a. Properties fields
i. Source = Field Value
ii. Value = corporateunit
User
23. Right-click on the Cost Center in the left pane and choose Add New Item User.
24. Click on the User object. In the right pane, make sure the following Import Rules are set on the
User object:
a. Update existing object in the database is checked.
b. Create new object in the database is unchecked.
c. Object ID set to default User_ID (this ID is used when joining other objects for import)
d. From the Update Rule, set the rule to Reject duplicate records.
25. Select the Account Name field under User on the left, and set the following:
a. Properties fields
i. Source = Field Value
ii. Value = accountName (the spelling suggests the field is not selected)
iii. Update rule: Never replace an existing value with blank.
b. Matching fields
i. Check Use this property for matching existing data.
ii. If null value is found = Discard the record
c. Data Transformation fields
i. Read Order = Forward
d. Advanced Properties
i. If value is missing = Do nothing. (The import will fail.)
Property Value
Account Name accountName
User Full Name displayName
First Name givenName
Last Name surname
AlternateEmail mail
Location ID Location_ID
Corporate Unit ID CorporateUnit_ID
Cost Center ID CostCenter_ID
Fixed "Update User AltEmail"
Inventory Source
Update rule “Always update the property”
27. Click Save. Close the Adapter. Click Save in the Beacon UI.
28. Select the Update AltEmail adapter then click the Schedule button and choose the Daily 1AM
Schedule. Click OK. Click the Save button to save the new schedule for the adapter.
29. Click on Update AltEmail adapter. Click Execute Now. Click OK.
30. Return to Flexera One. The results may be immediate or require a few hours to update (usually
after the first run). Check the Data Collection/IT Asset Inventory Status/System Tasks.
31. Check Organization/All IT Asset Users. All the column “Last inventory source”. Filter on “Update
User AltEmail” for the Last inventory source or filter the domain “flexcustomer.com”.
32. Check Organization/IT Asset Locations. The Description should match the location name (and
not be generic).
The package will install under C:\Program Files (x86)\Flexera\Business Adapter Studio.
39. Click Finish when the installer completes.
41. Launch Microsoft SQL Server Management Studio from the Start Menu.
42. Enter FlexDCData for the Server name and click Connect.
44. Paste the contents in from Notepad from the FNMSStageCreation.sql file and click the Execute
button.
46. Expand Databases and you should now see the FNMSStaging database.
48. Click on User Mapping, put a check in FNMSStaging, put a check in db_owner and click OK.
49. You can now close Notepad but you can leave Microsoft SQL Server Management Studio open
or minimized.
53. Enter the following connection details, click Test Connection then click OK.
56. Right-click on the Import1 and click Rename and call the adapter Assets_Staged.
57. Make sure you’re still on the Assets_Staged menu item and in the pane to the right, choose CSV
File from the “Type:” drop-list.
62. Scroll down to the bottom and make sure to check Use Physical Table is checked in the
Advanced Properties section.
63. In the left pane, click on Data and then click Load Data in the right pane.
64. You will then be able to see the results of the CSV file.
65. Click on File and Save As and save the file as Assets_Staged.xml and keep it in the
C:\ClassFiles\ITAM folder and click Save. Commented [GL2]: Same \ITAM
66. Click back on the Assets_Staged in the left pane, click Tools and Import.
67. In the next window, click the Start button and click Yes to continue.
69. Go back to Microsoft SQL Server Management Studio, expand the FNMSStaging database,
expand the Tables menu and you should now see the dbo.ECMImport_Assets_Staged table.
71. You can now close Microsoft SQL Server Management Studio (do not save anything) and close
Business Adapter Studio (and save if it prompts).
80. Click Save, to save the adapter configuration and open the Business Adapter Studio with no
default template loaded.
88. Make sure that the check box for Encrypt Connection Information is unchecked.
89. Click the Refresh button to verify the connection to the data.
90. Click the Data node on the left and click the Load Data button which will load the dataset for
reference in the Data node.
91. You should see the dataset now.
92. Click back on the top-level node Simple Asset Adapter and scroll down on the right until you
view the Tracing options for the adapter. Set the following tracing options for the adapter.
a. Created records is unchecked.
b. Updated records is unchecked
c. Deleted records is unchecked.
d. Rejected records is checked.
e. Column(s) for tracing: [AssetName]
94. The Corporate Unit object and all fields will now be displayed. By default, you will be on the top-
level Corporate Unit node. Make sure the following Import Rules are set on the Corporate Unit
object:
a. Update existing object in the database is unchecked.
b. Create new object in the database is unchecked.
c. Object ID set to default CorporateUnit_ID (this ID is used when joining other objects for
import)
d. Leave the Update Rule blank.
e. Make sure that All levels provided is checked.
95. Select the Name field for Corporate Unit and set the following properties.
a. Properties fields
i. Source = Field Value
ii. Value = ITAMBU – Note the field value pull-down list is drawing fields from the
header of the database connection we configured earlier
b. Matching fields
i. Check Use this property for matching existing data.
ii. If null value is found = Discard the record
Note: This means you will need to make sure there is a value in every
ITAMBU field in the data being imported
97. The Location object and all fields will now be displayed. Make sure the following Import Rules
are set on the Location object:
a. Update existing object in the database is unchecked.
b. Create new object in the database is unchecked.
c. Object ID set to default Location_ID (this ID is used when joining other objects for
import)
d. Leave the Update Rule blank.
e. Make sure that All levels provided is checked.
98. Select the Name field for Location and set the following properties.
a. Properties fields
i. Source = Field Value
ii. Value = ITAMLocation
b. Matching fields
i. Check Use this property for matching existing data.
ii. If null value is found = Discard the record
c. Data Transformation fields
i. Read Order = Forward
d. Advanced Properties
i. If value is missing = Do nothing. (The import will fail.)
99. Right-click on the Simple Asset Adapter node on the left and select Add New Item
Enterprise Groups Cost Center.
103. The Asset object and all fields will now be displayed. By default, you will be on the top-level
Asset Node. Make sure the following Import Rules are set on the Asset object:
You should now see a list of all the possible fields that can be imported for an Asset Adapter
expanded below the Asset node.
104. Select Asset Name field on the left and set the following properties.
a. Properties fields
i. Source = Field Value
ii. Value = AssetName
b. Matching fields
i. Check Use this property for matching existing data.
ii. If null value is found = Discard the record
c. Data Transformation fields
i. Read Order = Forward
d. Advanced Properties
i. If value is missing = Do nothing. (The import will fail.)
Note: This means you will need to make sure there is a value in every
AssetName field in the data being imported.
105. Select Serial Number field on the left and set the following properties.
a. Properties fields
i. Source = Field Value
ii. Value = SerialNo
b. Matching fields
i. Check Use this property for matching existing data.
ii. If null value is found = Discard the record
c. Data Transformation fields
We will not use this field for matching, which means we can change the
asset type on future imports.
107. Select Asset Status field on the left and set the following properties.
a. Properties fields
i. Source = Field Value
ii. Value = AssetStatus
iii. Update rule = Always update the property
b. Matching fields
i. Use this property for matching existing data is NOT checked.
c. Data Transformation fields
i. Read Order = Forward
d. Advanced Properties
i. If value is missing = Do nothing. (The import will fail.)
108. Select Manufacturer field on the left and set the following properties.
a. Properties fields
i. Source = Field Value
We will not use this field for matching, which means we can change the
asset type on future imports.
We will not use this field for matching, which means we can change the
asset type on future imports.
110. Your adapter window should have green marked for the fields that we have configured for
import and should look like this:
111. Click Save icon on the toolbar (or File Save) to save the adapter.
112. Our sample adapter xml can be found in the following folder location on the beacon.
C:\ProgramData\Flexera Software\Beacon\BusinessAdapter
Tip: XML Adapter files that have been developed and tested elsewhere can be copied into this
location. However, after you copy the adapter, you will want to open it on the beacon and verify the
data source can be reached. Also make sure the adapter is enabled.
113. Exit the Business Adapter Studio (File Exit), click Save on the Edit business connection
window and you should now see your simple adapter listed in the Beacon UI under Data
collection Business importer
116. This brings you to the Scheduling page. Click the + next to Not scheduled to expand the list.
You will see your new business adapter under the Not scheduled list.
117. Click on the New button to create a new schedule and enter the following information:
a. Schedule name = Daily 1 AM Schedule
b. Scheduling Options = Daily at 1:00 AM
c. Click OK to save the schedule
Note: The Beacon UI does not have to be open for the adapters to run. The Beacon Service will run
the adapter imports at the scheduled time.
Good Practice: Since there is no way to test the adapter before running it, we will run this. It is
always a good idea to run the adapter first with a very small data set to test the adapter before
extending it to the entire dataset. Also, it is highly recommended to build adapters first in a
development environment first and not your production environment.
122. Eventually (it may take up 5 minutes, but it is generally quick) you will see a zip file for the
Simple Asset Adapter located in the following location:
C:\ProgramData\Flexera Software\Beacon\IntermediateData\Uploaded
Good Practice: While this upload directory should purge itself on a regular schedule, if you notice this
folder of uploaded data growing larger than expected, you should delete older files.
129. Clicking on the link for 5 row(s) found with rejection messages will display a breakdown for
why the records were rejected.
Note: If you disable tracing, the adapters will run and reject records, but will show as Completed (but
without the with errors). Tracing is normally used when you're first creating adapters or for
troubleshooting if you have higher than average rejected records.
Without tracing enabled, you cannot individually review the rejected rows.
132. Navigate back to Hardware Device Assets and you will now see that we now have 20
assets imported.
This is only possible with the staging tables, not the direct to Flexera One adapter.
This will result in the following tag in the XML file to be changed.
2. Select API credentials. Click Create API Refresh Token. Copy string, paste into Notepad.
4. Navigate to Automation/Credentials
5. Click New Credential
6. For Credential Type choose “OAuth2”
7. Name Credential: “Flexera One Refresh Token for StudentXX”
8. Grant Type: Refresh Token
9. Token URL: https://login.flexera.com/oidc/token
10. Client Authentication Method: Token
11. Token: Paste in your API Refresh Token value
12. Provider: flexera
13. Click Validate.
7. Click on Collections on the left. Expand Flexera One, select POST iam - Request Access Token.
Note: For the training orgs in the EU shard, please change the URL to api.flexera.eu
4. Create a report . Click the “X” to remove the Getting Started banner.
5. Select “Application”, click Add. The Name appears by default and is check for Include in search.
6. Scroll down the field list and click on “+” to add Publisher. Check Include in search.
7. Next choose the table Installations and click Add.
8. Remove the fields Application Name, Publisher and Version. We know have our fields.
9. Click Preview and filter. Change the column order to Publisher, Name, Inventory device name.
10. Click on funnel under Inventory device name. Select “Is not empty”.
11. Click Save as.
12. Title: Microsoft Device Applications. Public access. Click Save.
13. Enter “Microsoft” in the search bar. Click Run report.
14. Export to XSLX. Open the workbook. Review and Close the workbook.
30. Download the Salesforce Power BI template from the Flexera Community.
https://community.flexera.com/t5/Flexera-One-Knowledge-Base/Salesforce-Power-BI-
Reporting-for-Flexera-One-s-SaaS-Management/ta-p/265033
31. Open the template in Power BI.
32. Fill out the form as follows:
FlexeraManagedSFCID n/a