Beruflich Dokumente
Kultur Dokumente
Version 2017 R2
Revision 17.5
Modified Aug 23rd, 2017
Lab URL: The instructor will provide a Class URL and Passphrase
Lab Environment:
You should be able to verify which system you are logged on by the desktop background. Each system will have
a different color and will have the name of the system on the background:
a) flexbeacon.flexeratraining.com – FNMS Beacon (Blue)
Page 2 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Overview ...............................................................................................................................6
Lab 1. Start Systems and verify all systems .........................................................................7
Module 1 Start up the initial systems .................................................................................................................7
Lab 2. FNMS System Administration ................................................................................. 10
Module 2 Set the Time on your server ............................................................................................................ 10
Module 3 System Menu ................................................................................................................................... 11
Module 4 Manage System Settings ................................................................................................................. 17
Module 5 Review Users, Operators and Roles ................................................................................................ 19
Module 6 Create a Restricted Operator Role .................................................................................................. 23
Lab 3. Managing Organizational Structure and Enterprise Groups ..................................... 26
Module 7 Enterprise Groups ............................................................................................................................ 26
Lab 4. Install and Configure the Beacon ............................................................................ 28
Module 8 Download the Beacon ..................................................................................................................... 28
Module 9 Download & Install the Beacon ....................................................................................................... 30
Module 10 Register your Beacon ................................................................................................................... 33
Module 11 Configure your beacon ................................................................................................................ 35
Module 12 Verify Business Adapter Configurations ...................................................................................... 43
Module 13 Import from Active Directory ...................................................................................................... 45
Module 14 Enabling additional logging on the Beacon ................................................................................. 47
Lab 5. Manage Users Imported via Active Directory & Create Operators ........................... 48
Module 15 Create an Account and Assign a Role .......................................................................................... 48
Module 16 Log On with a Different Role ....................................................................................................... 49
Module 17 User Resources and Responsibilities Handover .......................................................................... 50
Lab 6. Connect the Beacon to Third Party Inventory Data .................................................. 52
Module 18 Connect the Beacon to SCCM Databases .................................................................................... 52
Module 19 View the Inventory from All Inventory ........................................................................................ 63
Lab 7. Collect Initial Inventory .......................................................................................... 65
Module 20 Import Inventory from a Spreadsheet ......................................................................................... 65
Module 21 Scheduled Spreadsheet Inventory Import from a Beacon .......................................................... 69
Module 22 Verify the Local Running of an Inventory from a Batch File ........................................................ 70
Module 23 Run an Inventory and upload resulting inventory to a local file folder....................................... 74
Page 3 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Page 4 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Appendix 2.2 Optional Lab - Update Implementation Lab Files .................................................................. 139
Appendix 2.3 Inventory Connection on a Beacon ....................................................................................... 140
Appendix 2.4 Troubleshooting Inventory Collection in FlexNet Manager Platform On-Premises .............. 142
Appendix 2.5 Web UI Logging for On-Premises........................................................................................... 143
Lab 14. Please Conduct Online Student Survey.................................................................. 144
Page 5 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Overview
Page 6 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
4) Once you logon you will see the three tabs for each of the systems you will be using, and you can click on
the Start Using This Environment.
Page 7 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
a) There will be a delay the first time you log on to the systems while they start up from a suspended state.
NOTE: The lab images are set to suspend after two hours of inactivity. If you system has suspended, you can
restart them by clicking the Start Using This Environment again and connect to them.
5) You will see the progress of the systems starting up. Wait for the systems to finish starting up before viewing
the virtual systems.
6) 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.
Page 8 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
7) Connect to each system using the following to logon to the Images themselves
a) User: flexeratraining\fnms-admin
b) Pass: F1exera
c) The system should automatically log you on. You can verify by running “whoami” from any command
prompt.
8) Here is a guide to the CloudShare class menu on the left of your browser window.
9) Make sure you get comfortable navigating between the VMware images and the FlexBeacon desktop.
Good Practice: In a production environment, each customer or partner should download their own product
install file to assure they download the appropriate product install files, license key and any other
components to be installed prior to the installation process. Optionally, the instructor may have you
download updated lab files from an FTP server using the optional lab in the appendix at the end of this lab
manual.
Page 9 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Before beginning to use FlexNet Manager Suite in production, we need to make sure all settings are set correctly
as well as check the overall System Health. Then we will need to create operator accounts and choose the
appropriate access for them.
Objectives
To set system preferences, create an operator with a restricted role, and apply permissions through the use of
roles.
Best Practice: Your Application Server has several scheduled events which are set to run at night. If the time
zone on your system does not match your time zone, these schedule tasks could run in the middle of the day
and slow down your lab system. The best practice on any of your systems, including test, development and
training systems is to set the time zone of the server.
4) The default time zone will be US Central time. Adjust the time zone to match the time zone where you are
currently located.
Page 10 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
5) Leave ‘Automatically adjust clock for Daylight Saving Time’ checked, then click OK and OK again to close the
Date and Time dialog.
6) Validate that the Time in the lower right ‘System Tray’ is showing your correct time.
System Defaults
7) Log onto FlexBeacon (Blue) as flexeratraining\fnms-admin. Tip for Cloud: The URL for the production
instance of FlexNet Manager Suite in the Cloud is www.flexnetmanager.com/Suite. Our lab environment is
FNMS On-Premises, which is configured with SSO and Windows Authentication.
8) Log on to the Web UI from FlexBeacon (Blue)
Page 11 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
9) Open Internet Explorer and enter the following URL: http://FlexApp.flexeratraining.com/Suite (You might
also want to set this as your home page on your preferred browser if it is not)
If you are prompted for credentials, enter the following:
a) User: flexeratraining\fnms-admin
b) password: F1exera
10) From the System menu in the upper right hand corner choose System Health and choose System Health
Dashboard
.
11) Review the items displayed in System Health, and look for any outstanding issues.
a) Make sure to scroll down and view the status of all system health items including:
i) License Reconciliation
ii) ARL
iii) SKU Library
iv) PURL
v) Beacons with issues (You will notice the Demo Beacon will have issues This is a virtual beacon for
demonstration purposes that does not exist and will never be connected)
vi) Inventory data inputs with issues
vii) Business data inputs with issues
Data Inputs
12) From the System menu, choose Data Inputs.
13) We will come back to this screen later after we perform some more data inputs.
Page 12 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
a) Examine both the Business Data and Inventory data tabs. Also note the extra buttons in the upper right
of each page as we will be using these later.
System Defaults
14) From the System menu, choose “System Defaults”.
15) You will notice three tabs to switch between:
a) Time Zone
b) Currency Settings
c) Exchange Rates
16) From the Time Zones tab, change the Time Zone to the time zone for the class.
19) Click Add a currency to add a currency with the following details
a) Currency: British Pound (GBP)
b) Set the default exchange rate to the following: 1 GBP to 1.35 or one British Pound to 1.35 US dollars
(since US dollars are the reference currency in this environment).
c) Leave the rest of the settings as is.
Page 13 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
d) This rate will be entered on the default exchange rate table for the GBP and can be changed at any time.
21) Add additional currencies as follows (feel free to check today’s conversion rate and substitute):
a) €1 Euro (EUR) to $1.14 USD
b) $1 Australian (AUD) Dollar to $0. 964 USD
i) Please note: When entering more than two decimal places, the two decimal places of the dollar
amount will be visible; however, the entire amount entered is saved in the FNMS database.
Good Practice: While maintaining multiple currency snapshots of differing exchange rates is possible, it’s
not a required item for License Compliance. As such, it’s easiest to maintain just one exchange rate for all
currencies by not creating multiple exchange rates. This default rate can then be revised from time to time,
so reports that reflect financial risks will always be displayed using a current conversion rate. Also, in many
environments, past purchase data is converted to the default currency before importing (in this case US
dollars), so that the historical financial reports will also remain stable in relation to their value.
22) When it’s time to review or change the default exchange rate, you can do so from the Exchange Rates tab.
Click on the Exchange Rates tab on the left to view the current default exchange rate.
23) To change an exchange rate, from the exchange rates tab, click the Edit icon for the Standard Rate.
Page 14 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Page 15 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
29) Note the values and column header all show US dollars.
30) To view your account personal preferences, which are separate from system preferences, choose the
account menu (Flexeratraining\fnms-admin pull down) and select My Preferences.
31) From the My Preferences screen, choose a preferred currency of British Pounds.
32) Scroll to the bottom of My Preferences and Click Save to save your preferences.
33) Re-Open the Procurement > Purchases > All Purchases view, and you should be viewing purchases converted
to British Pounds.
34) Return to the Account Settings and Select the currency of your choice under My Preferences for the
remainder of the labs.
35) From the My Preferences, you can also review your preferred time zone. You might also want to change the
‘Preferred Time Zone’ to the time zone of the class. Just make sure and save if any changes were made.
Page 16 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
36) Also note the Task Monitoring settings are set to display all System Task types. We will leave this as is since
we want to be able to view all System Tasks for troubleshooting purposes.
Page 17 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
40) Click the Plus Sign next to one of the existing serial numbers on the blacklist.
41) Enter the following as a blacklisted serial number:
a) 0000000000 (ten zeros)
42) Click the Plus Sign again and enter the following:
a) 1111111111 (ten ones)
43) Click Save to save the new blacklisted serial numbers.
44) Scroll to the bottom of the Inventory Settings page to review the Activity Logs Settings.
45) Change the settings from 30 days to 60 days.
Page 18 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Tip: Even though these settings are under the Inventory Settings page and are labelled Activity Logs, they
affect all Activity and System Task logs being retained in the system, and for all task types such as business
importers, one off imports, inventory imports and reconciliation. While it may seem like a good idea to keep
the logs active for longer than 30-days, because Tasks and Events are running every day, the logs in the
database can start to pile up, so be careful when extending the number of days beyond 30.
51) In the search bar on the upper right (next to the magnifying glass) enter Alex and press the enter key to
initiate the search.
Page 19 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
52) View the different users matching “alex” in any column, and note which account is associated with the
flexeratraining domain and account name of “alexmullins”.
Warning: Often times a business adapter might create user accounts not associated with domain accounts.
That was the case with the stand alone Alex account, where an adapter to assign a manager to a contract
created a user in the system. Normalizing users on import is a critical step to making sure the user records
do not have duplicate user records which represent the same user.
53) Also search for the users matching “austin”. As with “alex,” note the user with domain “flexeratraining” and
account name of “austinmullins”.
Tip for On-Premises: For a user account to be authenticated and managed as a FNMS operator account in FNMS
On-Premises, it needs to be associated with a recognized Active Directory account for authentication. Accounts in
the training image that have passwords and can be used include flexeratraining\alex, flexeratraining\austin, and
flexeratraining\abigail (all have a password of F1exera.)
54) To view current operator accounts, from the System drop down Menu select Accounts.
55) You will see only two accounts listed. These accounts were created automatically during the install process.
a) One is the flexeratraining\fnms-admin account who was the logged on user during the installation of
this On-Premises environment.
b) And the second is the flexeratraining\svc-flexnet account which was configured to run scheduled tasks
and services during the installation process.
Page 20 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
56) Click on the Unassigned Accounts tab on the left, and you will notice that there are no unassigned accounts.
Both accounts have already been assigned to a role.
Create a Role
57) Click on the Roles tab on the left to view the default roles and how many accounts are assigned to each.
58) Click on the “2 Accounts” for the Administrator role (this is a link to show the two accounts in the
Administrators role).
59) You can now view all accounts that have been assigned to the Administrator Role.
a) Also look at the Role column next to Flexeratraining\fnms-admin to notice that flexeratraining\fnms-
admin is actually assigned to two separate roles.
60) Click the “Back” button to go back to the Roles tab of the account (not your browser back button).
61) Select “Show Details” under the Roles heading to view detailed descriptions of the four default roles:
Page 21 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
e) Web Service
63) Click the Edit icon (the pencil) to the right side of the screen for the Operator Role. Note the tooltip.
64) Note the default rights applied for each object and click the left arrow next to the rights to expand the
rights.
65) Expand the Administration section by clicking the Arrow next to the “Custom” heading to see how the
custom rights were applied.
a) Namely, “Configure operator of the FlexNet Manager Platform” as well as “Troubleshooting: advanced
access and log downloads” were both disallowed.
66) When you are finished reviewing the rights for the roles, you can close the Role by scrolling to the bottom of
the page and clicking the ‘Close’ button located at the bottom left of the screen. You do not need to save
the changes.
Page 22 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Good Practice: It is good practice to leave the default roles as is. If you would like to create a Role similar to
an existing role with a few different rights, you can use the “Copy Role” icon on the main Roles screen:
to copy the role then revise the rights. Below we are going to copy the Operator role to create a Restricted
Operator role.
68) Enter “Restricted Operator” in the name of the role, and edit the Description by adding the following
sentence:
Restricted Operators will not be able to perform any administrative management tasks such as
importing inventory.
Page 23 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
71) For Corporate Units, change ”Full” privileges to ”Read only”.’ (This setting can be found after expanding the
Corporate Units section then looking in the upper left under “Corporate Units”.)
Page 24 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
72) Change the rights for Cost Centers by changing “Full” privileges to “Read only”.
73) Change the rights for Locations by changing the “Full” privileges to “Read only”.
74) Change the rights for Roles by changing the “Full” privileges to “Read only”.
75) Scroll to the bottom and click the Create button at the bottom to create the new role.
76) To verify the role, you should see all roles listed including the new Restricted Operator role under the Roles
tab.
Note for On-Premises: The next step would usually be to create an account; however, we need to install a
beacon first for Active Directory synchronization, since this is a requirement for account creation in FNMS On-
Premises.
Page 25 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Most organizations will want to manage or report on software by corporate units, cost centers, or locations. So
related source data such as purchases, contracts and hardware also needs to be managed according to this
enterprise structure. Before importing records, it’s important to make sure the correct enterprise group
structure is set up ahead of time to match the data that will be uploaded.
Objectives
The objectives of this lab are to make sure our enterprise group structure is prepared for future data that will be
uploaded, including purchases, hardware assets, contracts and users.
3) Open the Enterprise > Structure > Cost Centers page and browse Cost Centers.
4) Open the Enterprise > Structure > Locations structure page.
5) You should expand the rows per page to view all location rows.
Page 26 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
c) Add Richmond as a city under Virginia (this time click Add (plus sign) on the Virginia line item).
Page 27 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Objectives
Install the Beacon on the FlexBeacon system and connect up to the web services on the FlexApp Application
Server.
4) Scroll down to find the Beacon Settings section, and click the pull-down menu next to “Beacon version
approved for use:”.
5) Select the specific version instead of leaving always using the latest version so that the beacon will not
automatically upgrade themselves when you upgrade your Application Server.
6) We will start by selecting an older version to deploy. Make sure to select version 12.0.0.14093 (Or the latest
version, but not ‘Always use the latest version’ as that could cause an automated update of the beacons.
Page 28 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Good Practice: If you have updated the version of the Application Server, you should see different versions for
every time the Application Server was updated making those versions of the beacon available. Once you start
to upgrade your version of the Application Server, newer versions of the beacon will be available for
deployment. It’s a good practice to test the deployment of a new beacon before approving it for general
release in your environment.
Download a Beacon
8) Log on to the FlexBeacon system.
Warning: Make absolutely sure you are on the beacon and not in one of the VMware images, as we want to
make sure we download and install the beacon on the correct system
Page 29 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Review the Beacon Set Up section, then click “Download a beacon”. You can also click the link to “View Change
History for FlexNet Beacon” to view recent beacon versions and affected features for each version.
12) Click past any security message in your browser, and choose to download the file.
a) Depending on which browser you are using, your file will be downloaded to either
i) C:\Temp
ii) C:\This PC\Downloads
15) Click “Yes” if asked if you want to allow the following program to makes changes to the computer.
Pre Requisites: From time to time, the beacon installer might need to install pre-requisites. If prompted to
install pre-requisites such as “MS Visual C++ versions, click to install these.
Page 30 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
17) Choose to “Accept” the terms of the license agreement, then click OK.
18) Choose “Custom” when asked to select a setup type and click “Next” to continue.
Tip: To be able to change the installation directory to a drive other than the C:\ Drive, you will need to select a
custom installation so you can change the installation path on the Custom screen.
19) Leave the default Custom features selected, verify the installation directory, and click “Next” on the Custom
Setup screen. Notice that the beacon will also install the Inventory agent.
20) On the Reporting Endpoint screen, enter the URL of your central FNMP Application Server. For our lab
environment, enter:
a) Server: http://flexapp.flexeratraining.com
b) Suite Path: Suite
Page 31 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
21) Leave the default Distribution Folder set as C:\ProgramData\Flexera Software and click “Next”.
a) This folder is used for storing native Flexera inventory and discovery related data prior to uploading.
22) When prompted to Configure Schedule Tasks screen, choose “Configure scheduled tasks” and “Run as a
named user:” Enter the credentials for the FNMP Service account as follows:
a) Username: Flexeratraining\svc-flexnet
b) Password: F1exera
Tip: It’s best to use the Services account from the Application server when the beacon resides in the same
domain as the application server. The service account used for the beacon will need to be configured to run
as a service on the beacon.
Page 32 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
25) On the Ready to Install the Program screen, click “Install” and the installation will begin.
26) When prompted that the Install Wizard has completed, click “Finish”.
c) Open Administrative Tools > Services and scroll down to find the FlexNet Beacon Engine service.
d) Note there are two other services that were installed for the Flexera Inventory Agent.
Tip: The Flexera Inventory Agent was installed along with the Beacon as the Beacon will utilize many of the
same services used by the Flexera agent, so these services should remain. The agent however is not fully
adopted as it has not downloaded a policy or schedule. The agent would have to be adopted before it would
start retuning regular inventory from the Beacon itself.
Page 33 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Tip: It’s 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.
29) To verify the scheduled tasks, right click the Windows icon to open Start > Control Panel > Administrative
Tools > Task Scheduler.
30) Expand the tree on the left to show Flexera Inventory Beacon Tasks. As an ongoing item, 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.
Page 34 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
a) If the FlexNet Beacon is not apparent, use the Search function in the upper right to find it.
Page 35 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
b) You can right click on the icon and choose to pin to the taskbar for easier access later.
36) Click “Yes” when prompted to allow the application to run.
37) From the menu on the left of the Beacon UI, select Local web server, then select “Self-hosted web server.”
38) On the Parent connection page of the Beacon UI, under Connection Details, check the “Enable parent
connection” checkbox and click “Test Connection”.
Page 36 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
39) The initial test will connect, but will not get a response from the parent server. This is normal; we will
complete the configuration shortly.
40) You will see the statuses of the connections listed below the test connection button.
41) From the Parent connection page, Under “Configure inventory beacon connection” section, click the
“Download Configuration” button.
Page 37 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
44) When the web page Configure a Beacon opens, you should see the beacon Unique ID and a blank name field
after scrolling to the bottom of the page.
a) Enter FlexBeacon as the name for your FlexNet Beacon and
TIP: The Beacon page to configure you beacon remains open, but once you click the Download configuration
button, it save the details of the new beacon including its beacon name and unique identifier to the DB and
this web page can be closed to prevent any further confusion.
46) When prompted to save the file, save the file in the C:\Temp directory by selecting the arrow to the right of
the Save button and selecting “Save as”.
Page 38 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
47) Go back to the FlexNet Beacon interface, and from the Parent connection tab, click the “Import
configuration” button.
48) Navigate to the C:\Temp directory and select the .flxconfig file, then click Open. The file name will be the
same as the Unique ID for the beacon.
49) You will receive a message showing that there are no credentials specified for connecting to the parent.
Click “Yes” to enter them now.
50) Under Parent URL, enter the service account username and password.
a) Parent URL: (leave this as is) http://flexapp.flexeratraining.com
b) User Name: flexeratraining\svc-flexnet
Page 39 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
c) Password: F1exera
d) Click to use the same account and password for the following specialized URLs
51) Click Test Connection, which should return successfully. Click OK connection dialog.
Page 40 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
59) Under the Status section of the Beacon Properties, confirm the “Enabled” radio button is selected.
Page 41 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Good Practice: At this point, if we wanted to upgrade to a newer version beacon, we would start by
authorizing the beacon to update to the latest version. From the Upgrade mode you would click on the pull
down arrow, then select “Choose a specific version”. By choosing a specific version for one beacon that is
later than the approved version, we designate this beacon to install the newer version for testing before
authorizing the latest version for all beacons. Once testing is approved, we can then update the approved
version by setting all beacons to always update to the “latest approved version” then to have one beacon
that is your test beacon where you always control the version it updates to on the beacon itself by choosing a
specific version as we did here.
Page 42 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Tip: The beacon will check within 15 minutes for its policy (which can be forced by choosing to update the
Rules on the beacon) and that’s when it will verify it needs to upgrade. The upgrade will happen
automatically and you may be prompted when attempting to open a beacon that it is currently being
upgraded. Wait 5 minutes then attempt to open the beacon again. You will see the version of the beacon on
the splash screen immediately after launching the Beacon UI. If the Beacon UI is open when the upgrade is
attempted, you will be prompted to close the beacon.
63) From the Beacon system (Blue), Re-open the Beacon UI. You should be able to view the version in the splash
screen when the beacon loads. Make sure the version matches the version you expect.
Page 43 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
65) This will clear itself when the beacon engine downloads the initial business importer templates. In addition,
all of 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.
66) 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. We will not be creating an adapter just yet.
67) You can view the DDI templates once they are downloaded in the following directory:
C:\ProgramData\Flexera Software\Beacon\DDI
68) 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 then opening the following log:
C:\ProgramData\Flexera Software\Compliance\Logging\BeaconEngine\BeaconEngine.log
Page 44 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Disable the schedule task to upload log files so we can review them before uploading
70) Since the log files located in the Flexera Software\Incoming folder are uploaded by the Windows scheduled
task “Upload Flexera logs and inventories” we will want to disable this task before performing our Active
Directory synchronization.
71) Open the system Schedule Tasks (you can use the shortcut on the task bar ), then right click on
‘Upload Flexera logs and inventories’ and choose to disable this task.
Page 45 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Tip: While using the current domain for AD synchronization will work for most environments by default, you
can add specific domains and credentials to query those domains from the Active Directory tab of the Beacon
UI.
76) On the server, 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
Note: If the beacon is working correctly, you will NOT see the file cached here. Instead it will automatically be
uploaded to the FlexApp Server. We will see the results of the Active Directory synchronization later in class
as we view imported sites and subnets.
77) Re-enables the schedule task to ‘Upload Flexera logs and inventories’ after you have reviewed the log files.
78) Once the Active Directory data is uploaded to the application Server, it will be added to the Inventory
Manager database, which is where all raw computer data from all sources is stored prior to merging into
unified computer records for display in the Inventory node of FNMP.
79) To force the synchronization of the data in the Inventory Manager database with FNMP, you will need to run
a complete license reconcile with an inventory update. From the FNMS Web User Interface opened in IE
click on Licenses > Reconcile page, check the box to “Update inventory for reconciliation” and click the
“Reconcile” button.
Go to System Settings drop down menu and select “System Tasks”. Validate that the Reconciliation line item has
completed successfully.
Page 46 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Tip: Often, the default logging is not enough to report on advanced features or troubleshooting. Additional
logging can be enabled using Flexera’s built-in tracing capabilities for the Beacon which is controlled by a
trace file found at: “C:\Program Files (x86)\Flexera Software\Inventory Beacon\etdp.trace”
80) Open Windows Explorer on FlexBeacon and navigate to the following folder:
C:\Program Files (x86)\Flexera Software\Inventory Beacon
81) Right click on the etdp.trace file and choose Edit with Notepad++
82) Find the filename designation and confirm the default log file path of C:\ManageSoft.log.
83) Scroll down till you find the sections designating Discovery and Inventory, and uncomment the top level line
of each as shown below by removing the # sign.
Tip: With the release of FNMS 2015R2 more logging information is being uploaded to the Application Server
and exposed through the Web UI via System Tasks and Activity Logs. Hence the advanced tracing using the
trace files is becoming less necessary, but still helpful for some particularly sticky issues, especially when the
beacon is not uploading to the Application Server.
Page 47 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Lab 5. Manage Users Imported via Active Directory & Create Operators
Now that we have synchronized the Beacon with Active Directory, and those Active Directory user accounts
have been reconciled into FNMS, we can now create operator accounts linked to those Active Directory
accounts.
2) In the Web UI, navigate to the System > Accounts page and make sure you are on the “All Accounts” tab.
3) From the All Accounts tab, click “Create an account” to add a new operator account.
4) Enter the following details on the General tab of the Account:
a) Account: alex
i) Click Search after entering the name to select the AD user for synchronization,
ii) You can verify you get the right Alex from the flexeratraining.com domain by adding the Domain
name column to the search view.
iii) Make sure to choose the Alex with a FullName of “Alex.Mullins” as the account name of “Alex” as
this is the account that matches the current AD synchronization. (The other Alex is coming from an
inventory record where alex used a previous logon. This is an example of where changing account
names in AD can result in multiple user accounts showing up in FNMS)
iv) Select the right alex account then click “Get account details” to synchronize.
b) Account: FLEXERATRAINING\Alex (will be automatically populated)
c) Name: Alex.Mullins (will be automatically populated)
d) Status: Enabled
e) Role: Restricted Operator
Page 48 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
5) Scroll to the bottom and click the Create button. Note: you might also have to scroll to the right after
scrolling to the bottom to view the Create button.
6) Optional: You can create a second account for “austin” following steps 3 through 5 adding her to the View
Only role for testing later. You can set “Social Media Manager” as her title. She’s always been the one to
socialize
Page 49 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
13) Optional: You created an account for Austin, try logging on as Austin with the same password to see what a
View Only role can access.
17) Select the user alex (Make sure to select the Alex that is NOT associated with the flexeratraining domain.
18) After selecting the correct Alex, click the checkbox, then click the Handover button.
a) Select Transfer as the “Handover action to perform:” (You can also remove resources and
responsibilities by selecting Remove.)
19) Search for user flexeratraining\austin, who will be the recipient of the transferred resources and
responsibilities.
20) Select the Austin with the account name then click the “Select user” button.
Page 50 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
a) Select all resources and responsibilities and click “Save” to finish the handover.
Page 51 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Objectives
For the purposes of this lab, we will connect to an existing third party inventory data source using a default
inventory adapter. Business Adapters will be covered in a separate lab.
c) Click the New button to create a connection to a SQL Server data source. (To choose a
non-SQL Server data source, select the drop down arrow next to the New button.)
2) Enter the following SQL Source Connection properties:
a) Connection name: My Old SMS
b) Type: SCCM
c) Server: flexdata.flexeratraining.com
d) Authentication: Windows (specific account)
Good practice: It’s usually best to specify the account to connect to your database for the inventory import.
e) Username: flexeratraining\svc-flexnet
f) Password: F1exera
g) Database: SMS
h) Verify “Connection is in test mode” is unchecked
i) Verify “Import the inventory from this source for possible merging” is selected.
Page 52 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Tip: Make sure to tab out of all the fields you have entered data in before clicking to Test the connection.
Page 53 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
7) You can walk through the same steps to connect to the SCCM database, but make sure the connection name
is different.
a) Connection name: My New SCCM
b) Type: SCCM
c) Server: flexdata.flexeratraining.com
d) Authentication: Windows (specific account)
e) Username: flexeratraining\svc-flexnet
f) Password: F1exera
g) Database: SCCM
Issue Alert: If the connection fails, go ahead and save so we can see the error’s that occur when connecting
to the DB and we can troubleshoot later.
9) The resulting inventory connections list should look as follows on the Inventory Systems page of the Beacon
UI.:
Page 54 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
a) Do the same for the “My New SCCM” inventory connection, but this time select the “Default daily
schedule”.
15) Click Save at the bottom of the screen to save the schedules.
Page 55 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
18) The inventory will now import into the Inventory Manager database according to the selected schedule.
21) 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
22) After the task has run, the data is located in:
C:\ProgramData\Flexera Software\Beacon\IntermediateData\Uploaded
a) Examine the log for the inventory reader in the following folder location:
C:\ProgramData\Flexera Software\Compliance\Logging\ComplianceReader\importer.log
23) 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.
Page 56 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
If Tip for On-Premises: If the data has been uploaded but not resolved to FNMP, you can viewed the cached
files on the FNMP application server at:
C:\ProgramData\Flexera Software\Beacon\IntermediateData\
25) To view the staged data that has been uploaded to the Application Server, Open the FlexApp System (Light
Rose) in VMWare by selecting the VMWare Workstation icon in the Task Bar on the Beacon, and selecting
the FlexApp Image.
26) Open the following folder “C:\ProgramData\Flexera Software\Beacon\IntermediateData”
27) Here you might see the two staged inventory imported zip files ready to be reconciled.
30) While the reconcile is in progress, you will view not be able to see the Reconcile button and instead will
view a message stating the reconcile has been scheduled.
Page 57 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
34) To diagnose the permissions issue we will want to look at the SQL permissions for the svc-flexnet services
account on the SMS database.
36) Open SQL Server Management Tools using the shortcut from the task bar at the bottom.
37) Expand the Security > Logins node to find the FLEXERATRAINING\svc-flexnet account
40) Select the SCCM database which was successful to view the permissions assigned.
a) The permissions should be db_datareader & public
Page 58 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
41) Now select the SMS database to view the permissions on this account.
a) The permissions are incorrect. You will need to uncheck db_datawriter and select db_datareader to
match the permissions assigned to the SCCM database.
42) Click OK to save the changes.
43) Log back on to your FlexBeacon server,
a) open the Beacon UI
b) choose from the Inventory Import, select the “My Old SMS” inventory connection
c) click the “Execute Now” button
44) Verify the Old SMS results were uploaded and have been copied to the following directory:
a) C:\Program Data\Flexera Software\Beacon\IntermediateData\Uploaded
b) Make sure to verify the time stamp to assure the most recent import was uploaded
45) From the web browser, re-run your full reconcile with an Inventory Import (as instructed in step 28).
46) Once the import and reconcile has finished, you should view the successful status from the System Tasks:
47) The status will remain in progress as long as the system task is running. You can refresh the web page to
view a status change.
Page 59 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
49) To view all the task steps for the imports, click the Expand all icon from the System Tasks page.
50) The expanded steps will also show each steps status, and any log files available for download.
51) Take a look at the status of the two SCCM data imports. Make sure to download and view the logs.
Page 60 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
56) 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. You can also select a primary inventory source.
Page 61 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Note: The default “FlexNet Manager Suite” inventory connection represents native Flexera inventory
managed by the FNMS application server and not by any one beacon.
58) You will notice that the default System Task filters only show only the last run tasks. Change this filter to
show Only show last run “No”
59) Change the Tasks run in the last 14 days to Tasks run in the last 30 days.
60) When you want to focus on one particular data source, you can add a filter on the Task/Step.
Page 62 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
65) Select the System Status bar, or System > System Health > System Tasks menu to navigate Back to the
System Tasks page.
66) Change the rows per page to 1,000 to accommodate additional tasks that we will be viewing.
67) Look through the other System tasks and get used to this view. We will be coming back here to diagnose
Business Adapters and Other Inventory Imports later.
68) Notice also that a Reconciliation tasks always seems to follow inventory imports. Though Reconciliation
events can be by themselves when you run a License Reconciliation without any Inventory Import.
Page 63 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
c) Drag the “Last Inventory Source” column from the Choose columns pane to the data grid header.
d) Also add the “Connection Name” column.
e) Close the Choose columns pane.
f) Click the “Show column groupings” icon to group by columns.
Page 64 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Initial inventory can be imported from a spreadsheet Inventory can also be collected from devices even if they
are not managed devices (that is, even if they do not have the agent installed and communicating with FlexNet
Manager Platform). Instead of installing the agent, agentless inventory can be collected by running the agent
executable in “light scanner” mode, using the command line, a batch file, a logon script, or some other
command-line execution mechanism. This method is typically the easiest way to collect Flexera inventory from
a given device because, in most organizations, it requires fewer levels of change control, authorizations, or
permissions than more automated mechanisms such as Flexera remote inventory execution or installing the
inventory agent.
Objectives
Import inventory from a spreadsheet and then edit a batch file for running command-line inventory, and then
run the inventory.
Page 65 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
b) Click Upload and make sure you see the “File uploaded successfully” message and click Open to open
the file.
c) Next to the Installation evidence field select Browse to select the following file:
d) C:\Temp\FlexApp\LabFiles\ImportingData\SpreadsheetInventoryImport\OneOff-
InventorySampleImports \InstallerEvidence.xlsx
e) Click Upload and verify the file uploaded successfully
f) Once you have uploaded both files, scroll down to the bottom of the page. From there you will be able
to click the “Start processing” button.
6) You should be able to view the status of your new One Off import under the Inventory tab of the Data Inputs
page. Click the arrow on the right to expand the summary and view the summary while in progress.
7) At the bottom of the summary for Last completed import, click the link to “View more in System Tasks”
8) You should be able to view the “First Spreadsheet Upload” listed as a Task type of Compliance import. Click
the plus sign to expand the task summaries.
9) View all of the summary info. Make sure to click on the “Validation errors” link to view the validation errors.
a) You can click the Back arrow in the browser to go back to system tasks.
10) When the import is complete, click the download log file for the Import Inventory devices task:
Page 66 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
11) Click Open in the browser to choose to open the zip file that was downloaded. You can then double click on
the file to open it.
12) Look through the log file then close the log file.
13) Close the Zip file in Windows Explorer.
Note: You will also note a Reconciliation task that was invoked with the inventory import. This assures the
inventory will be imported into the Compliance database as soon as it’s uploaded. You can verify this by
viewing the results in the All Inventory view.
15) From the Web UI open the Discovery & Inventory > Inventory > All Inventory view.
Page 67 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
21) Expand the Connection name to view the inventory records that were imported from the spreadsheet.
22) select the DSK-01 inventory record and click the “Open” button
a) Click on the tabs on the right of the screen to view its hardware details as well as applications.
b) Note an application was recognized from the installer evidence imported along with the computer.
Page 68 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Warning: If you just click on the “New” button directly, it will create a SQL inventory connection by default.
Note: This is a different set of inventory spreadsheets than were imported before.
Page 69 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
33) Once you verify the zip file was in the upload folder and uploaded, open the Web UI and navigate to the
System > Data Inputs > Inventory page to view all of the Data Inputs including the new Beacon Spreadsheet
Inventory connection.
Warning: If you find an error when importing the Spreadsheet records from the beacon it could be because
you selected the wrong spreadsheets to import. Make sure to select the folder “2015R2-
OneOffInventorySampleData” which are different from the previous worksheets imported via the UI.
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.
36) Copy the required Windows files selected above (the unselected files are used for non-windows) for running
the light scanner files for Windows to a directory for running them locally:
C:\Temp\FlexBeacon\LabFiles\Discovery-Inventory\NDTrack\NDTrack
37) When you paste the files into the NDTrack directory, you will be asked to replace the files. Choose to replace
the files in the destination. This will update the older versions of the inventory files in this directory.
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.
Page 70 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
39) Find the GetInventory.bat file, then right click and choose to edit the file.
Note: This is an example batch file for running ndtrack.exe, the agent executable, in “light scanner” mode by
invoking a command line with appropriate options. It can be used to schedule inventory by configuring a
Windows scheduled task to run the batch file.
Tip for On-Premises: The current Upload Location will place the files in a directory next to the NDTrack
folder. Uploads from the light scanner can be sent directly to the application server, bypassing any beacon,
but you must ensure that you do not overload the application server with upload connections. Typically this
is done by randomizing the start time of the light scanner on different devices, or else by using a beacon to
handle the load balancing.
41) This command line which is remarked out will cause the batch file to use an option of “InventoryDirectory”
to store the inventory file locally.
42) Add “REM” in front of the following command:
43) Remove the “REM” from the front of the following command.
REM set INVENTORY_UPLOAD_LOCATION=”%file_Path%Results”
44) It should now read:
set INVENTORY_UPLOAD_LOCATION=”%file_Path%Results”
45) However this current path will upload the resulting inventory files directly to the application server (which is
good for troubleshooting if you want to check if the upload will work to the application server but not to the
beacon).
46) Edit the path to instead point to the beacon server. “http://flexbeacon.flexeratraining.com%Results”
47) Examine the command-line syntax for ndtrack.exe. The Option to UploadLocation should now use the
variable to upload the resulting inventory file to the flexbeacon upload location.
Page 71 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
52) Once the batch file has finished, press any key to close the command prompt.
53) Check the tracker log file located underneath the temp directory for Administrator:
Tip: You can type %temp% in the Windows Explorer path to open the current user’s temp directory.
C:\Users\Administrator\AppData\Local\Temp\ManageSoft\tracker.log
54) From this log file, you can view the collection of inventory 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 upload finishing and success messages.
55) Check the Incoming folder on the Beacon to make sure the inventory has been uploaded to the FlexApp
server.
a) C:\ProgramData\Flexera Software\Incoming\Inventories
b) All inventory files are uploaded to the server from this folder – not just FlexBeacon. This folder on the
Beacon serves as a central collection point prior to upload. If the file is not here, it could have already
been uploaded to the Application Server by the Schedule Task to upload inventory files, “Upload Flexera
logs and inventories”
Page 72 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
56) The FlexBeacon inventory record is uploaded to the Inventory Manager database, but is not merged into the
FNMP database unless a full reconcile is run with an inventory import.
a) Open the Web UI (if not already open) and open Licenses > Events > Reconcile.
b) Check the box to “Update inventory for reconciliation” and click Reconcile.
57) While the reconcile is running, open the Discovery & Inventory > Inventory > All Inventory page in another
tab by opening the navigation menu, then right clicking on the link and choose “Open link in another tab”.
58) Once the reconcile is complete, open the Discovery & Inventory > Inventory > All Inventory page to view the
updated inventory.
59) Enter “flexbeacon” into the global search field in the upper right of the All Inventory page and press the
enter key to find the flexbeacon inventory record.
60) Scroll to the right to find the “Last Inventory Date” column. You should see today’s date on the flexbeacon
record after the inventory has been reconciled into the FNMP database.
61) To view the exact time of the last update, open the flexbeacon inventory record and view the History tab.
You will find lists of updates with date and time.
Page 73 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Module 23 Run an Inventory and upload resulting inventory to a local file folder
Good Practice: Often times, you will need to run a scan on remote systems that might not have network
access to a Flexera Beacon or to the Application Server. In these cases, you can run the Inventory light
scanner, and simply load the resulting file to a local file location for capture later.
66) Because we want to copy the results to the local file path instead of an Upload Location, we also need to
change the command line option from “UploadLocation” to “InventoryDirectory” as follows:
67) Save and run the Batch file once more as an administrator.
68) The resulting inventory file can be found in the following directory.
C:\Temp\FlexBeacon\LabFiles\Discovery-Inventory\NDTrack\Results
69) Copy this file and paste in the folder where inventory files are uploaded.
C:\ProgramData\Flexera Software\Incoming\Inventories
70) The schedule task will automatically upload this file to the Application Server within ten minutes.
71) The next time you run a Reconcile with Inventory Import, the new inventory will be loaded from the IM
database into the FNMP database.
Page 74 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Before beginning to conduct discovery and inventory tasks, you must first configure which subnets each Beacon
will use for its discovery and inventory tasks. A structure of sites and subnets is automatically imported from
Active Directory; additional sites and subnets can also be created manually. Once this is done, you can then set
up discovery and inventory tasks targeting the sites and subnets.
Objectives
The objective of this lesson is to prepare for running discovery and inventory tasks by configuring credentials in
the Password Store for task execution and by establishing a set of sites and subnets for discovery and inventory
tasks and to align them with Beacons.
3) From the Password Store, click “New” to create a new Password Store 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.
4) Select the Domain Admin account on the left and you will be able to view the details and/or edit the account
if needed. (The password is encrypted and not visible.)
Page 75 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
g) In the Filter window, add “FlexBeacon, FlexApp, FlexData” under Device names separated by a comma
(make sure to read the text to understand how to apply filters).
Page 76 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Note: CIDR Notation (Classless Inter-Domain Routing) is a method for allocating IP addresses and routing
Internet Protocol packets. It defines a base IP address along with the number of bits defined by the notation
which forms a range of IP addresses. FNMS uses CIDR notation for defining subnets. A /24 suffix is used to
indicate a class C subnet (i.e. xxx.yyy.zzz.0 – xxx.yyy.zzz.255). For more information on CIDR notation view
the online help or view the Wikipedia page below.
http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation
1) In the Web UI, open Discovery & Inventory > Discovery > Unmanaged Devices.
2) Change the view to display 1,000 rows per page.
4) Write down the total devices under the “Unmanaged Devices” view: _____________
5) Note the class C IP subnet range in CIDR format for FlexBeacon: _____________
(Example: 10.160.0.0/24)
Tip: After the FlexNet Beacon installed on FlexBeacon initially synchronizes with Active Directory, any sites
and subnets configured in Active Directory will be added to FNMP. As a result, you should automatically see
AD sites and subnets in FNMP, but you will still need to manually create any new sites and subnets not
configured in Active Directory, and then assign all subnets to beacons.
6) To view sites and subnets that have been imported from Active Directory (AD), open the Discovery &
Inventory > Network > Subnets page.
7) Expand the sites by clicking the plus signs or by using the “Expand All” icon.
8) 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
c) London – 172.100.0.0/16
Page 77 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
9) Note however that while the subnets under Chicago and London are marked as enabled, they are NOT
assigned to a Beacon as there is no Beacon name. We will take care of this shortly.
10) Open the Discovery & Inventory > Network > Unassigned Subnets page.
11) Select each subnet by clicking the Checkbox next to each subnet or by selecting the checkbox at the top to
select all.
Page 78 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
17) To change the assigned beacon, click the “Edit” button for a particular subnet, then you will be
able to select a beacon from the resulting drop down menu under the Beacon name column. Make sure to
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 always be created within sites, in order to streamline discovery and inventory
targeting.
Page 79 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
20) Name the site “Atlanta”. Sites usually have names associated with locations such as Chicago or San Jose.
22) 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.
23) Select “FlexBeacon” under the Beacon name column 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.
24) Create a second IP subnet under the Atlanta site to match the subnet of FlexBeacon and all of the servers in
our training environment (written down earlier in this lab). Make sure to assign that subnet to FlexBeacon.
a) FlexApp: 10.160.0.4
b) FlexData: 10.160.0.3
c) FlexBeacon: 10.160.0.5
d) In this case, the IP range is defined by 10.160.0.0/24. Create the entry under the Atlanta site assigned to
FlexBeacon as well, so that there are now two subnets managed by the FlexBeacon in the Atlanta site.
Page 80 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Tip: When manually creating a subnet range, it’s important to leave the ‘Update automatically’ set to No, or
else when a synchronization with an Active Directory Site occurs, the subnet could be removed from the list if
not found in the automated synchronization. Those subnets marked as ‘Update automatically’ as Yes are
usually those coming from an AD synchronization.
25) After saving the subnets and assigning the beacons, let’s now go check out the Unmanaged Devices to see if
this caused any change in the list.
26) Open Discovery & Inventory > Discovery > Unmanaged Devices
a) What has changed in the list?
Page 81 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Discovery and Inventory tasks are managed by creating rules that define how to run discovery and inventory
tasks. Rules contain:
Actions
Targets
Schedules
Objectives
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).
the Add button to add the selected site as the included site for the target.
Page 82 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
6) Click “Add to rule builder” to add the new “Training Site” target to the rule we are building. This will display
the rule builder.
7) Click the Actions Tab on the left to display the Action options.
8) We will use the default action for “Full discovery and inventory” in our initial rule.
9) Click “Add to rule builder” to add the full discovery and inventory action to the rule.
Page 83 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
12) For this initial schedule, choose to run “Once” and choose a time of about 10 minutes from now.
13) Make sure to also enter “Commence within 5 minutes.” The commencement time window randomizes start
times of jobs distributed from the beacon and is important for load balancing.
16) Then click the “Save” button to save the new rule.
17) The resulting rule will show in the list of rules under the “Rules” tab.
Page 84 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Tip: new rules created on the application server will automatically be downloaded to the Beacon based on
the beacon policy and if the targets in the rule are applied to that beacon via the assigned subnets. This
should only take a few minutes. You can also force an update of rules by clicking on the “Update Rules”
button on the Rules page of the Beacon UI.
18) You can verify the rules currently configured on the beacon by viewing the “Rules” page of the FlexNet
Beacon UI. The rule will appear till it is run. Once the rule is run, if it will not be repeated, it will disappear
from the Rules tab.
19) Make sure you are logged on to the FlexBeacon system (Blue).
20) Open the Beacon UI, and navigate to the view of Rules which are under Discovery & Inventory.
Note: If you create a rule to run as soon as possible or to run once, the rule might appear in the Beacon UI for
only a short time, then disappear after it is run. Only persistent rules will remain in the Rules list on the
Beacon UI. Also, only rules targeting subnets managed by that beacon will appear on that beacon.
21) If “My First Rule” is not already visible, click the “Update Rules” button to force an update of the new rules.
22) You can force the rule to run by selecting My First Rule from the list, and then clicking the Run button at the
Page 85 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
27) Make sure your ‘Only show last run’ filter is set to No.
28) Refresh the browser window to refresh the System Task list from time to time when checking on system
tasks.
34) Set the name to be “VM Infrastructure” and the description to “VM discovery and inventory.”
35) Click “Expand all” to see the available actions.
Page 86 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
36) Uncheck the box for “General hardware and software inventory > Gather hardware and software inventory
from all target devices”.
Note: if you attempt to uncheck all discovery methods, and still conduct a VMWare discovery, you will be
prompted that “At least one of the discovery methods needs to be selected in the “General devices
discovery and inventory” section.
38) Scroll down to the bottom of the page and click Create.
39) Add the new “VM Infrastructure” rule to the rule builder.
40) Click the Targets Tab and Add the Training Site target to the Rule Builder. (It doesn’t really matter if you add
the target first or last)
41) Click the Schedule button to schedule the rule.
42) Schedule the rule to run daily starting 1 hour from the current time with a 10 minute commencement time
window, then click “Save as.”
Page 87 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
43) Name the new rule “Atlanta VM infrastructure” and ensure it is enabled. 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.
44) The rule must next be downloaded to the Beacon. From the Rules tab of the Beacon UI, click “Update
Rules”.
45) 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 UI Rules list and clicking the “Run”
button. Newly discovered devices will appear in the Web UI after the Beacon has uploaded its discovery data.
Refer to the Appendix for the steps for a new rule, and locations for the data flow and logs.
46) To force the rules to run if they have not, from the Beacon UI, select the rule then click the Run button.
47)
48) Sometimes you have to 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.
Page 88 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
49) On the Beacon system (Blue), you can view the C:\ProgramData\Flexera Software\Beacon\BeaconPolicy.xml
file to view the rules in the Beacon Policy.
50) 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:
a) C:\ProgramData\Flexera Software\Compliance\Logging\BeaconEngine\BeaconEngine.log
51) 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:
C:\Program Files(x86)\Flexera Software\Inventory Beacon\etdp.trace
Verify the “#” pound sign in front of +Discovery has been deleted in order to uncomment the tracing.
(Right-click and use Notepad or WordPad to edit the file.)
52) Run the rule “Atlanta VM Infrastructure” from the Rules tab of the FlexNet Beacon.
Page 89 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
53) View detailed results from running rules on the Beacon by opening the log file configured in etdp.trace,
which by default can be found at:
C:\ManageSoft.log
Tip: You can change this path by editing etdp.trace as we showed in an earlier lab.
54) Discovery and inventory rule results are uploaded to the application server by the “Upload Flexera logs and
inventories” scheduled task on the beacon.
a) If the data is waiting to be uploaded, it can be found in the following location:
C:\ProgramData\Flexera Software\Incoming\Discovery
55) If you find a BadLogs folder, open the folder to see if any of the discovery jobs were uploaded here.
56) If there are discovery files copied here, it’s always worth a try to copy the files back to the
ProgramData\Flexera Software\Incoming\Discovery folder to attempt to have them resolved again.
58) Click the “see details: link in the summary on the right to open the Rule Execution Details.
Page 90 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
59) The Rule Execution Details will list each and every system that a task was attempted to run on with the
results shown in the summary.
60) Open the System > System Health > System Tasks list again.
61) Click the Expand all icon to expand the Rule to see which beacons the rule was run on and the steps
on each beacon.
Page 91 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
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.
62) Log on to the Application Server (Light Rose) to view the Status logs uploaded to the Application Server from
the Beacon.
63) Open the following directory to see if any logs are still unresolved, or if there are bad logs in the BadLogs
folder.
C:\ProgramData\Flexera Software\Incoming\BeaconEngine\BeaconEngine.log
64) If problems exist, log on to the Beacon system (Burgundy.
a) Then to troubleshoot any status that is not being resolved, look in the following folder on the beacon for
the Beacon Status log
C:\ProgramData\Flexera Software\Compliance\Logging\BeaconStatus
65) Results of discovery and inventory rules are immediately resolved into the Inventory Manager (IM) database
and will appear in the Web UI under Discovery & Inventory > Discovery > All Discovered Devices. You can
filter by IP address Begins with 10.160.0
66) Open the FlexApp Discovered Device by clicking on the name hyperlink.
67) 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.
Page 92 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
68) Every night, or when a reconcile with “Update inventory for reconciliation” is run, Flexera discovery and
Inventory data is imported from the IM database and the All Discovered Devices page into the FNMP
database and the Discovery & Inventory > Inventory > All Inventory page.
69) Filter the All Inventory view of Name Begins with “Flex”
70) You will notice the FlexApp system even though it may have been inventoried, is not appearing under the All
Inventory view till a complete inventory import and reconcile occurs.
71) Go ahead and run a reconciliation with a full inventory import to view the results of the inventory on the
FlexApp and FlexData system.
72) Once the Discovery Job has completed, the beacon will also upload log files that are available in the Activity
Log of the UI. To access the Activity Log, open the System Menu > System Health Page.
73) Click the Activity Log button.
Page 93 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
74) It’s often helpful to group this view by Source type as well. Most logs related to Discovery & Inventory Rules
will appear under the Beacon source type.
Page 94 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Objectives
Configure the agent installation files for direct installation.
Tip: When you use the adoption feature of FlexNet Manager Suite, the configuration of the agent will occur
automatically.
Standard Practice: When an agent is first installed, it requires an initial configuration. These configuration
settings reside on the Beacon as part of the beacon policy. Before adopting devices by installing the agent,
the beacon must have the appropriate configuration settings, and the agent must know how to check with a
beacon during the install process to receive its initial configuration. When an agent is installed but does not
receive its initial configuration, it is orphaned and will never be able to report inventory.
1) Review the inventory configuration settings on the server. Open the Discovery & Inventory > Settings page.
Page 95 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
9) The beacon policy file will contain beacon configuration settings used by the beacon as well as agent
schedules and the inventory settings from the Web UI.
10) To find the inventory settings for agents, scroll down in the Beacon Policy xml file to the <Agent Schedule>
tag.
11) Here you will see the inventory triggers:
Page 96 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
12) 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.
Warning: If you logon as an Operator, you will be able to view the Download Inventory Agent page, but you
will not be able to select an inventory agent to download. Close the browser and make sure you are logged
on as someone with an Administrator role.
16) Open the following page, Settings > Data Inputs> Inventory Data.
Good Practice: This is an older version, but will still work. This is normal practice as an older version of the
agent is usually approved and we don’t always want to upgrade the agents every time we upgrade the
Application server.
Tip: If you cannot select an inventory agent from the pull-down list you might not be logged on as an
Administrator. Close the browser and make sure to log on as an Administrator.
21) If you are not using Internet Explorer, the file might be automatically downloaded to the users download
directory. Find the file and copy the zip file to the C:\Temp directory.
Page 97 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Tip: All other operating systems specify the OS in the agent name, but the Windows agent is always called
simply “ManageSoft for managed devices.” You can find versions of all the agents on the Application Server
under F:\ProgramData\Flexera Software\Warehouse\Repository\Packages\Flexera\Adoption\10.3.0\Rev1.0.
The latest package version for download will be placed in the same Adoption directory whenever you update
your Application server to a new FNMS version, and made available via the Web UI for download.
22) Once you have saved the zip file, Right click on the managesoft-xx.x.x.zip file and select Z-Zip > Extract to
“managesoft-xx.x.x\”.
23) To complete the installation package for a given environment, download and configure a bootstrapping file.
Tip: The bootstrap file (mgssetup.ini) contains all the initial configuration settings used by the agent. To
complete the agent installation package, download and edit this file and place it in the same folder as the
other installation files to be included in the package.
24) From the Download Inventory Agent page, download the mgssetup.ini bootstrapping template file.
Page 98 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
25) If you are prompted to Leave the page, go ahead and click leave the page.
26) Save the file in the same folder as the agent installation files:
C:\Temp\ managesoft-xx.x.x\
27) Open the File Explorer and navigate to the agent installation folder C:\Temp\ managesoft-xx.x.x.
28) Right click the mgssetup.ini file and choose Edit to open and edit the required sections of the file.
Warning: There are two critical settings that you need to make sure are uncommented and configured in the
mgssetup.ini file. These are the INSTALLMACHINEPOLICY setting and the DEPLOYSERVERURL. While the other
settings are optional and helpful, these two settings must be configured correctly or else the client agent will
be installed, but will not be able to download its initial configuration and schedule and as a result will be
orphaned and idle.
29) Scroll down till you find the INSTALLMACHINEPOLICY setting. Make sure there is no semicolon in front of the
line. The semicolon acts as a comment marker, and when it’s there the line will not be read by the installer.
30) Make sure the INSTALLMACHINEPOLICY=1
31) Scroll down till you find the DEPLOYSERVERURL setting. Make sure there is no semicolon in front of the line.
The semicolon acts as a comment marker, and when it’s there the line will not be read by the installer.
32) Make sure the DEPLOYSERVERURL is set to the name of your beacon server download URL. In our case
http://flexbeacon.flexeratraining.com/ManageSoftDL
33) Scroll down till you find the section for “;Arbitrary command to run at completion of installation”.
34) Uncomment and edit the two lines as follows:
a) RUNCMD = cmd.exe
b) RUNCMDARGS = /C start ndtrack -t Machine -o
UploadLocation=http://flexapp.flexeratraining.com/ManageSoftRL
Page 99 of 146
© 2017 Flexera | Company Confidential | Product Education
FNM-1350: FlexNet Manager Suite 2017 Administration Lab Manual
Good Practice: It’s 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.
39) Enter any User Name and Company then click next. (This is not a critical configuration)
40) Choose Custom Install and click Next for the Choose Custom to view the client components that are
installed.
41) View the components, and then click Next.
a) This is the screen where you can again set the installation path.
b) Note all of the different components that make up the inventory agent.
42) Check the option to “Yes, record application usage statistics” then click Next.
Good Practice: It’s always good practice for License Optimization to collect usage data, however often times
usage data will be disabled by default then enabled later after testing.
43) Choose to “Directly” access the internet instead of using a proxy then click Next.
a) This setting has more to do with how the client communicates to the beacon instead of how it
communicates to the internet.
44) Click Install on the final page to commence the application installation.
45) Click Finish to complete the installation and close the installation wizard.
Tip: The ultimate test of the client being adopted and receiving it’s critical configuration is to make sure the
client has downloaded it’s client schedule that tells the client what to do and when to do it which is located in
C:\ProgramData\ManageSoft Corp\ManageSoft\Schedule Agent\Schedules
46) To verify if the inventory scan occurred, open the File Explorer, and path to %TEMP% which should take you
to “C:\Users\fnms-admin\AppData\Local\Temp”
NOTE: If the tracker.log file is not found there, look under “C:\Windows\Temp\ManageSoft”
47) Open the ManageSoft folder and look for the tracker log.
50) You should also find the locally cached inventory .ndi file in the following location:
C:\ProgramData\ManageSoft Corp\ManageSoft\Tracker\Inventories
51) 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 using the following command line.
52) From the FlexData server, open the following folder path in Windows Explorer.
C:\ProgramData\ManageSoft Corp\ManageSoft\Schedule Agent\Schedules
53) Right Click on the “sched.nds” file and select “Open with” then choose to open with Notepad.
55) 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 FNMS All Inventory.
56) As a troubleshooting tactic you can also open the schedule agent and run the inventory manually.
Note: When running ndschedag.exe from a command line, you need to make sure you open the command
prompt to run as an administrator. The ndschedag.exe must be run as an administrator in order to view the
machine schedule.
57) Click the Windows start button, and type “Command Prompt” in the search. Then Right Click on the
Command Prompt icon in the Taskbar at the bottom of the screen Command and choose to “Run as
administrator”.
58) Using CD commands, change directories till you are in the following directory:
C:\Program Files (x86)\ManageSoft\Schedule Agent
a) CD \
b) CD Program Files (x86)\ManageSoft\Schedule Agent
59) From the command prompt, you can now type the following command:
ndschedag.exe –t machine
60) Then press enter to run the command
61) This command will open the Schedule Agent UI (This UI is only used for troubleshooting purposes as the
schedule agent will run silently for each schedule task)
62) From the Schedule Agent UI, you can Right Click on the “Generate Inventory” schedule task and choose to
Run.
63) While the inventory agent is running, you will see it appear in the Task Manager Control panel.
64) To confirm the date and time stamp of the last inventory that has been run on the client, you can find a
cached copy of the inventory results file in the following location.
C:\Program Data\ManageSoft Corp\Tracker\Inventories
Tip: There are actually two folders with cached inventory that appear here. If the inventory was executed
using the installed agent, it will appear in the Inventories folder. If the inventory was generated via a
command line directly or from a remote execution inventory rule from a beacon, the cached inventory file
will appear under the ZeroTouch folder.
65) If the inventory was run on the client, but was unable to upload to the Beacon, you will find the resulting
inventory file waiting to be uploaded in the following directory.
C:\ProgramData\ManageSoft Corp\ManageSoft\Common\Uploads\Inventories
66) Files are cleared from this Uploads location once they have been uploaded from the client.
67) You can also verify the last details of the inventory tool (also referred to as the tracker) by referring to the
system log files.
68) In File Explorer, open the following location C:\Windows\Temp\Managesoft
69) Open the tracker.log file from this directory.
70) You should see a successful upload of the inventory, as well as the steps used during the inventory.
71) You now can feel confident that the client is adopted correctly and since it has a schedule is not orphaned.
Note: Now would be a good time to check additional logging in your trace file. View the resulting logs in
C:\ManageSoft.log file. Also, can you track the inventory after it is uploaded to the Beacon and then after the
Beacon uploads it to the Application Server.
Note: Because the Business Adapter Studio loaded on the Beacon is designed to run in disconnected mode
such that it does not connect directly to the database, it does not support running test imports or custom SQL
code in the adapter.
1) Make sure you are logged on to the FlexBeacon system (Blue), and minimize VMWare Workstation.
2) You can find the Data Domain Interface (DDI) templates on the beacon in the following folder location:
C:\ProgramData\Flexera Software\Beacon\DDI
3) Example CSV templates for use with the DDI business adapters can be found in the following folder location.
Note: these files differ from the CSV file templates for uploading data directly via the Web UI.
C:\ProgramData\Flexera Software\Beacon\ExampleCSV
4) Additional configuration files for Business Adapter Studio on the Beacon can be found in the following
folder:
C:\ProgramData\Flexera Software\Beacon\BAS
a) Choose the Custom Importer template from the Adapter Template pull-down menu.
b) Enter “A Simple Asset Adapter” as the Adapter name:
c) Choose to Execute as: “Windows (current account)”. During normal operations this will run under the
account used for the Beacon Service.
d) Leave the Username: and Password: blank
5) Click Save, to save the adapter configuration and open the Business Adapter Studio with no default template
loaded.
9) Click the “Data” node on the left, and click the “Load Data” button which will load the dataset for reference
in the Data node.
10) You should see the dataset now.
11) Click back on the top level node “A Simple Asset Adapter”, and scroll down on the right till you view the
Tracing Options for the adapter.
12) Set the following tracing options for the adapter.
a) Created Records is checked
b) Updated records is checked
c) Deleted records is checked
d) Rejected records is checked
e) Column(s) for tracing: [AssetName]
15) At the top level of the Asset Object, you should see the Import Rules for this Asset Adapter.
16) From the Update Rule, set the rule to “Reject duplicate records”.
17) You should now see a list of all the possible fields that can be imported for an Asset Adapter expanded
below the Asset node.
18) Click on a few fields and review the following sections of properties for a few fields:
a) Properties
b) Matching
c) Data Transformation
d) Advanced Properties
19) Select “Asset Name” field on the left, and set the following properties
a) Properties fields
i) Source: Field Value
ii) Value: AssetName (Note the field value pull-down list is actually drawing fields from the header of
the CSV file we loaded earlier)
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.)
(1) Note that this means you will need to make sure there is a value in every Asset Name field in the
data being imported
20) 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) Use this property for matching existing data is checked
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.)
21) Select “Asset Type” field on the left, and set the following properties
a) Properties fields
i) Source: Field Value
ii) Value: assettype
24) Click “Save” on the Business Adapter Studio Menu to save the adapter.
25) Our sample adapter xml can be found in the following folder location on the beacon
a) C:\Program Data\Flexera Software\ Beacon\Business Adapter
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.
26) Close the Business Adapter Studio, and you should now see your simple adapter listed in the Beacon UI
under “Data collection > Business Importer”
27) To schedule the adapter to run, you must first create a generic schedule that can be applied to multiple
objects. To do so, click on the “Data collection > Scheduling” link in the menu on the left.
28) This brings you to the Scheduling page. You will see your new business adapter under the “Not scheduled”
list. Click the + next to Not scheduled to expand the list.
29) Click on the “New” button to create a new schedule and enter the following information:
a) Schedule name: Daily 1AM Schedule (I’ve found naming schedules by timing is helpful when applying
schedules to different imports.)
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.
30) Navigate back to the “Data collection > Business importer” page,
31) Select your adapter then click the Schedule button and choose the “Daily 1AM Schedule”
32) Click the Save button to save the new schedule for the adapter.
33) Close the Beacon UI so we can refresh it easily.
Good Practice: Since there is no way to test the adapter before running it, we will run this. It’s always a good
idea to run the adapter first with a very small data set if possible to first test the adapter before extending it
to the entire dataset. Also, adapters should be built in a development environment and not while connected
to your production database.
36) Eventually (it may take 5 minutes or so) you will see a zip file for the “A Simple Asset Adapter” located in the
following location:
C:\ProgramData\Flexera Software\Beacon\IntermediateData
37) However the data will only show up here for a short time before it is automatically uploaded. Once the zip
file is uploaded, you will see it in the ‘Uploaded’ folder in this location.
38) Once the Adapter results are uploaded to the Application Server, the zip file will be cached for a few days in
the ‘Uploaded’ folder in this location.
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.
39) Once the adapter results are uploaded, to verify the Business Adapter has also been imported on the
Application Server, open the Web-UI and navigate to System > Data Inputs”.
40) If you do not see the Adapter listed, click on the ‘Process Imports’ button to process any data that has been
uploaded from beacons.
41) To see what was uploaded, copy the associated zip file on the beacon from the C:\ProgramData\Flexera
Software\Beacon\IntermediateData\Uploaded folder to the C:\Temp Directory, right click on the file and
choose to Extract All.
50) From the Business Import Rejection Messages view, scroll down to find all of the rows were rejected
because the serial number was blank, and since the serial number is a required field they were rejected. You
could attempt to edit the csv file directly to add a unique serial number for a few of these records then re-
run the adapter to see if the records can be imported.
54) Scroll down the list of recent activity, and you should see those with a Source Type of ‘Business Import’
55) You can also view more detailed logs in the database directly.
56) Once data is uploaded to the Application server and imported into the database, log files are kept for each
import. You can verify these from the following table in the FNMP Database:
a) ECMImportLog_Detail
b) ECMImportLog_Object
c) ECMImportLog_Summary
57) Open SQL Server Management Console.
58) Click “New Query” and make sure the FNMP Database is selected in the pull-down menu.
7) Click Next
8) Click Install to install the adapter studio
9) Click Finish to complete the installation
Tip: The first difference you will notice between this adapter UI and the one from the beacon is the presence
of the top level database node, where you can define your database connection to the FNMP database. This
adapter will not be creating intermediate data files like the adapter on the beacon, but will be importing
data directly into the FNMP database itself, which is why it needs a data connection defined.
16) From the FlexNet Manager Platform Database node, Click “Use the specific connection information below”
17) Click the ellipsis for the Connection String to build the connection string pointing to our current FNMP
database.
18) Verify the correct server name and database name, then click “Test Connection” to test the connection.
Good Practice: You should be more creative with your asset adapter names such as “CMDB Asset Adapter”
22) Then from the Data node, click “Load Data” to verify you can load data.
24) Click the minus sign next to each of the objects to condense the objects and view all the different items that
are imported by a simple Asset adapter.
27) From the tools menu, select ‘Simulate’ to test the adapter,
29) View the results in the screen and look to see if the adapter would have created and/or updated any assets.
The status should be shown near the bottom. You can see errors, warnings and if the simulated import
completed which is a good thing
35) View the results to see if data was updated and/or imported
36) To view the history of imports to look for further issues, from the tools menu select ‘View History’
37) When expanding the history, you can often find reasons why certain records were rejected, along with the
record number (which corresponds to the row# in your import data)
4) The Sample MLS import will show unique joins of data columns as well as filters and concatenations. This is
the type of adapter that uses custom SQL code to define and cleans the data that cannot be run directly
from a Beacon.
Each of the cases below, describes an issue that you have to troubleshoot. The corresponding files can be found
under LabFiles\BAS_Troubleshooting folder. If you have difficulty finding the right solution, you can refer to the
Appendix proposed solutions, but only after attempting to resolve the issue on your own.
The customer requested location data from their financial system be loaded to the newly implemented FNMS
tool. The onsite consultant noticed that additional hierarchy was created. The onsite consultant noticed that
there are additional slashes in the “Name” field of the location text file. The source cannot be changed by the
customer directly. The data is fed from a third party provider. The customer agreed that the data can be
modified prior to loading and the slashes changed to hyphens. Fix the adapter to account for this change.
Module 38 Case #2 – Error when running Schedule Task for Business Adapter
The consultant has developed all the business adapters that were required by the customer. The consultant has
tested each of the business adapters and they function as expected. The consultant has developed an
executable to be attached to a scheduled task so that the business adapters run daily at night as included in the
customer requirements. Upon testing the scheduled job the consultant notices that the business unit adapter is
receiving an error. Fix the issue so that the business unit adapter will run correctly during the scheduled nightly
time.
Module 39 Case #3 – Special Characters appear in Adapter after copying the XML
The consultant has developed all the business adapters that were included in the customer requirements. The
adapters have been tested individually and in the batch job and function as expected in the customer’s
development environment. The same adapters need to be deployed in the customer’s production environment.
The consultant copies the business adapters from the development application server to the customer’s
production application server. The consultant notices that there are a bunch of special characters in the adapter
xml files; however that is not how the xml files looked in the development environment. Fix the adapter so that
the connection information does not have special characters.
The consultant is onsite with the customer in a conference room. The consultant walks through the user
business adapter with the customer. The customer notices that there are 4 user records that were rejected
from the load. The customer would like to understand why those 4 user records were not loaded as the
customer had recently gone through a data clean up activity. How does the consultant show the customer the 4
failing records? Why didn’t they load?
To fix the values in the “Name” field, include an additional SQL query to update the value in the Name field prior
to updating the FNMP database.
Module 42 Case #2 Solution - Error when running Schedule Task for Business Adapter
The executable is not functioning properly. There is a misspelling in the file which is causing the adapter to not
run and the scheduled task to fail. Correct the spelling of the adapter (.xml) file in the executable and it will run
successfully. To test, run the sample TesAdpaters.cmd command file which calls MGSBI.exe to see the errors.
Module 43 Case #3 Solution - Special Characters appear in Adapter after copying the XML
The encryption flag is checked for the adapter. Uncheck the Encryption flag or remove the encryption text from
the .xml file. Save the adapter and re-copy the adapter.
This will result in the following tag in the XML file to be changed.
The errors can be identified by querying tables in the FNMP. Execute the queries listed in the illustration below
in order. In the ECMImportLog_Detail lists the reasons why the records errored out. Then look at the data file
to look at the data itself to figure out why it is erroring out.
Pre-requisites
1) The following items have already been completed on the training system, but are good to verify when
updating a standard system.
2) Make sure that operational service account exists
3) Make sure the SQL Server database collation is case-insensitive
4) Make sure that the .Net Framework is installed
5) Make sure to turn off Internet Explorer Enhanced Security Configuration settings
6) Make sure PowerShell version installed is 3 or above
8) Disable all Flexera related Schedule Tasks in the Task Scheduler Control Panel
11) Make sure the Recovery Model is set to Simple for the database
12) Back up any customized files to a temporary location (This will not be needed on the Training system as
there are no customized files)
13) On the FlexData server, find the DatabaseMigration\Normal folder execute the following commands
14) mgsDatabaseUpdate.exe -i ComplianceMigration.xml -nsu -l CMmig.log -s flexapp.flexeratraining.com -d
FNMP –l CMMig.log
15) Re-Index the database by running ReIndexAll.sql in SQL Server Management Studio (This will not be needed
on the Training system at this time)
26) Enter the following details for the FNMS application pool
a) UserName: flexeratraining\svc-flexnet
b) Password: F1exera
c) Check to use the same credentials…
27) Enter the following details for the Beacon Service and External Services
a) UserName: flexeratraining\svc-flexnet
b) Password: F1exera
c) Check to use the same credentials…
d) URL of batch scheduling Server: http://flexapp.flexeratraining.com
e) URL of inventory server: http://flexapp.flexeratraining.com
f) Leave the Host Name as: FLEXAPP.FLEXERATRAINING.COM
30) Verify the following Schedule Tasks are enabled and running after your reboot. You can select multiple tasks
to enable at the same time by selecting the tasks, then right-clicking them to select enable.
Schedule Tasks to Enable include:
a) Data warehouse export
b) Delete activity log history
c) FlexNet inventory data maintenance
d) FlexNet Manager Suite database support task
e) Import Active Directory
f) Import application usage logs
g) Import discovery information
h) Import installation logs
i) Import inventories
j) Import Inventory Beacon activity status
k) Import Inventory Beacon status
l) Import remote task status information
m) Import system status information
n) Import VDI access data
o) Inventory Import and license reconcile
p) Recognition data import
q) Regenerate Business Import config
r) Send contract notifications
s) Update FlexNet Manager Suite software usage history
31) Load a new license key if necessary using the
(Program Files (x86)\Flexera Software\FlexNet Manager
Platform\DotNet\bin\ManageSoft.Activation.Wizard.exe
32) Load the new ARL/PURL/SKU libraries. From the Task Schedule Control Panel, right click and run the
following FlexNet Manager Platform task: “Recognition data import” (you might have to click run twice)
33) To update the Sample Reporting Package
a) Verify the IBM Cognos service is running.
b) Copy the “FlexNetManagerPlatformReportsAndDashboard.zip” file to the following location
c) C:\Program Files (x86)\Report Designer\c10\deployment (you will need to overwrite the existing
package)
d) From the C:\Program Files (x86)\Flexera Software\FlexNet Manager
Platform\Cognos\BusinessReportingAuthenticationService\bin directory run
“CognosPackageImport.exe”
36) From the Discovery & Inventory > Network > Beacons page, choose to edit the “Demo Beacon” record
37) Make sure to set the “Upgrade mode:” to always use the most current version.
38) Because this beacon does not live connected to the system, you will not see it auto-upgrade
5) The connection should open to the implementation files on the remote system on the right, and the
C:\Temp directory on the left (FlexData system).
6) In the folder directory on the right, make sure you are in the FNM-1300 folder, and then drag the FlexData
folder to the C:\Temp directory on the FlexData server. Note, this process could take up to an hour if there
are a considerable number of files to be updated.
a) Drag the selected folders from the remote system to the local system window.
7) Because we have pre-loaded most of the files, you will be prompted if you want to overwrite or not. Choose
“Overwrite if source newer”, and ”Always use this action“.
8) While the files are downloading on the first system, repeat this process on the FlexApp server to download
the FlexApp Server folder to the C:\Temp folder on the FlexApp Server.
9) You will also want to repeat this process on the FlexBeacon host system.
a) On the FlexBeacon system, copy the FlexBeacon folder to the C:\Temp folder as well.
10) Once downloads are complete, verify the files transferred to all three machines with no “Failed Transfers.”
4) Verify the connection and resulting ZIP file in the following directory
C:\Program Data\Flexera Software\Beacon\Intermediate Data
5) If the Intermediate never shows up, you can check Compliance Logging on the Beacon under:
C:Program Data\Flexera Software\Compliance\Logging
6) If the Intermediate does show up, you can check Compliance Upload Logging on the Beacon under:
C:Program Data\Flexera Software\ComplianceUpload\Logging
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:
C:\Program Data\Flexera Software\Beacon\Intermediate Data\Uploaded
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:
C:Program Data\Flexera Software\BeaconEngine\Logging
11) On the Application Server, you will find the intermediate data in the following folder:
C:\Program Data\Flexera Software\Beacon\Intermediate Data
12) The Application Server will then need to perform a Compliance Import to import any inventory data form
beacons. You can perform this manually using the following command line:
C:\Program Files(x86)\Flexera Software\Inventory Beacon\DotNet\bin\ComplianceReader.exe
a) You might want to write the results of the command prompt to a log file using the following syntax
ComplianceReader.exe –sdw > C:\CompRead.log
13) You can also check the Activity Log on the server for the beacon. From the Web UI, go to Discovery &
Inventory > Beacons and edit your beacon. Then click the link to “View activity log”
14) Also, you can view the System Menu > System Health > Activity Log and filter on “Source Type = Compliance
import”
1) When running the agent or light scanner, if the inventory is collected, and not uploaded there are two places
to look:
a) Is the upload location reachable form the client? View the tracker.log for details.
b) Is the path correct, but the Application Server not responding correctly?
c) For Cloud, troubleshooting must be done by Support.
d) For On-Premises, you will need to view the native IIS logs located on the application server under:
C:\inetpu\logs\LogFiles\W3SVC1
2) If the issue resides on the server, you will need to troubleshoot the ManageSoftRL site. Often time
authentication on the site in IIS will need to be verified.
3) Once uploaded, the resulting inventory will appear in the Computers Table of the IM database. You can
verify this directly in the database by running a script similar to:
USE IM
SELECT *
FROM Computer
WHERE ComputerCN LIKE ‘%flexbeacon%’
4) The next step in the process, is to then upload inventory from IM into FNMP. This is done with the Inventory
Import/Reconcile process, but can be manually executed using:
C:\Program Files(x86)\Flexera Software\Inventory Beacon\DotNet\bin\ComplianceReader.exe
a) You might want to write the results of the command prompt to a log file using the following syntax
ComplianceReader.exe –sdw > C:\CompRead.log
5) Once the data is imported into FNMP, you should then be able to view the inventory record in the FNMS
WebUI under Discovery & Inventory > Inventory > All Inventory
Participant