Introducing AppClarity 5.2
How it works
Working with AppClarity
Technical support for AppClarity
AppClarity 5.2 - Implementing and Using Lab Guide
Ex 1 - AppClarity 5.2 - Installing the 1E Catalog and the 1E SLA Platform
Ex 2 - AppClarity 5.2 - Scouting for devices and applications
Ex 3 - AppClarity 5.2 - Getting data from a restored CM database
Ex 4 - AppClarity 5.2 - Installing AppClarity
Ex 5 - AppClarity 5.2 - Connectivity and Integration with ActiveEfficiency
Ex 6 - AppClarity 5.2 - Exploring Applications, Products and Installations
Ex 7 - AppClarity 5.2 - Working with Management Groups
Ex 8 - AppClarity 5.2 - Entitlement Management and Compliance
Ex 9 - AppClarity 5.2 - Software Reclaim
- Ex 1 - AppClarity 5.2 - Installing the 1E Catalog and the 1E SLA Platform
- AppClarity 5.2 - Implementing and Using Lab Guide
Scouting for devices and applications
The ActiveEfficiency Scout is the component that discovers information from an external data source and stores it in the ActiveEfficiency database in a common form that can be used by other 1E solutions. In the previous lab, you installed the scout with the ConfigMgr mode selected, which enables the scout to collect data from Configuration Manager.
In this lab, you will execute the Scout manually to observe the process of getting data from ConfigMgr into ActiveEfficiency. Later you will install AppClarity and the use the ActiveEfficiency Synchronization Manager to create a Windows Scheduled Task to complete the end-to-end synchronization process that includes running the scout first followed by the AppClarity synchronization.
Getting data from ConfigMgr
In this exercise, you will run the ActiveEfficiency Scout manually to find computers in ConfigMgr and retrieve a number of properties of these devices, including details of installed applications and when they were last run.
Run the Scout in ConfigMgr mode
In this task you will execute the scout directly from a command line so you can observe the data gathering process.
- On 1ETRNAP, open a command prompt and change directory to C:\Program Files (x86)\1E\ActiveEfficiency\Scout
- Run the following command line
Observe the data returned by the Scout
The data retrieved in the previous task is stored in various tables in the ActiveEfficiency database. It can also be viewed through the ActiveEfficiency web service. In this task, you will observe the basic data that has been discovered by running the scout in ConfigMgr mode.
- On 1ETRNAP, open Internet Explorer and browse to http://localhost/activeefficiency to open the ActiveEfficiency web service interface
- Click the URI link to the right of Devices and observe the devices that have been discovered in the ConfigMgr database. This information corresponds to the data in the Devices table in the ActiveEfficiency database
- Click on the link in the Identity column that corresponds to the 1ETRNW71 device to view detailed properties of the device in the Single Device resource page
- Click the System properties for this device link. This displays the system properties that were obtained by the scout from ConfigMgr and corresponds to the data in the DeviceSystemProperties table in the ActiveEfficiency database
- Click the back button in the browser to return to the Single Device resource page and click the Tags attached to this device link. Device tags are fully extensible "name/value" definitions, with the addition of Category, which can be associated with a device to enable identification of the device by properties other than those defined in the Devices, DeviceSystemProperties and DeviceIdentities tables in the ActiveEfficiency database
- Note there are several device tags that the scout will collect by default from ConfigMgr. The information on this page corresponds to the data in the DeviceTags table in the ActiveEfficiency database
- Click the back button in the browser to return to the Single Device resource page and click the Installations for this device link. This shows all the installed software that the scout discovered from data in ConfigMgr. It corresponds to the data in the Installations table in the ActiveEfficiency database. You can click on the link in the Id column to view specific details of any Installation
- Click the back button in the browser to return to the Single Device resource page and click the Usage types for this device link
- Click the back button in the browser until you return to the 1E ActiveEfficiency web service page and then click the URI link to the right of DiscoveryHistory. This shows the start and end time of the last scout execution and corresponds to the DiscoveryHistory table in the ActiveEfficiency database
- Click the back button in the browser to return to the ActiveEfficiency page and then click the URI link to the right of Applications. Note that there are no Applications discovered by the scout
Getting App-V Application and Installation data
ActiveEfficiency gathers and stores information about App-V applications that are available in the environment and information about installations of these applications. Information about the virtual applications is gathered by the VirtualAppExporter. Information about installations of these applications is gathered from ConfigMgr by the Scout. In this exercise, you will run the App Exporter on a library of App-V virtual applications to discover the metadata about the virtual applications we are likely to encounter in the environment. You will then install and execute a virtual application on a workstation, ensure the inventory data is returned to ConfigMgr, then run the Scout and observe the results of each of these actions.
Run the VirtualAppExporter
The VirtualAppExporter scans a folder (defined in the command line) recursively for virtual applications. It then gathers information from the data files that make up the virtual applications that it finds and exports these to an XML file.
- On 1ETRNAP, open a command prompt and change directory to C:\Program Files (x86)\1E\ActiveEfficiency\Scout\Exporter
- Run the following command line (all on one line)
- Open C:\ProgramData\1E\ActiveEfficiency and note the PackageXml folder. Open this folder and note the Packages.xml file that was just generated by the VirtualAppExporter
- Open Packages.xml and observe the Packages that the exporter identified. Note that the Adobe2_CS5 package (Adobe Creative Suite 5) includes a number of Applications
Install and run a virtual application
A virtual application (Microsoft Office Word Viewer 2003) has been made available to the lab clients through ConfigMgr. In this task, you will install the viewer on 1ETRNW71 and run it (to generate 'last used' data).
- Log onto 1ETRNW71 as 1ETRN\User. You should see a pop-up notification that new software is available. Click on the notification to open Software Center (if you don't see the pop-up, you can start ConfigMgr Software Center from the Start menu)
- From Software Center (Available Software tab), select Microsoft Office Word Viewer 2003 and click Install
- When the installation has completed, run the Microsoft Office Word Viewer 2003 (from All Programs in the Start menu). Word Viewer opens with a dialog box to select the Word document you want to open – just cancel this dialog box and close the application (we only need to start the application to register usage)
- Repeat steps 17 - 19 on 1ETRNW72, logged in as 1ETRN\User
Send inventory to ConfigMgr
Before the ActiveEfficiency scout can discover the newly installed and executed virtual application, we need to ensure the necessary inventory data has been sent and processed by ConfigMgr. In this task you will run the ConfigMgr Hardware Inventory process on the client and confirm the required data is in the ConfigMgr database for the scout to find.
- On 1ETRNW71, double-click the Configuration Manager shortcut on the desktop to open the Configuration Manager Properties dialog box and select the Actions tab
- Select Hardware Inventory Cycle from the Actions list and click Run Now
- The Hardware Inventory collection activity on the client can be monitored in C:\Windows\CCM\Logs\InventoryAgent.log and entries like the entries below will indicate that the information has been sent to the ConfigMgr server
- Repeat steps 21-23 on 1ETRNW72, logged in as 1ETRN\User
- Log on to 1ETRNCM as 1ETRN\SCCMAdmin and open the Configuration Manager Console from the Start menu
- From the Assets and Compliance workspace (console bottom-left), select the Devices node (console top-left) and then right-click either 1ETRNW71 or 1ETRNW72 (whichever one successfully sent up a hardware inventory) and select Start > Resource Explorer
- In the Resource Explorer, expand the Hardware node and scroll down to Virtual Applications. Confirm that Microsoft Office Word Viewer 2003 is listed with the Last launch on system (UTC) column showing the time you ran the viewer on 1ETRNW71 (you may need to refresh the display a couple of times if the latest inventory information hasn't yet been processed)
Execute the scout to gather virtual application data
We now have the necessary data in the Packages.xml file and ConfigMgr database for the ActiveEfficiency scout to discover installations and usage of virtual applications in the environment. In this task, you will execute the scout in ConfigMgr mode again to collect this information and observe the results.
- On 1ETRNAP logged on as AppInstaller, repeat the process in steps 75-76 to run the scout in ConfigMgr mode
- Open the scout.log file and note that the first task the scout did this time around was to process Packages.xml
- Use the ActiveEfficiency web service pages to navigate to the Application Usage page for 1ETRNW71 and/or 1ETRNW72
- Note that Microsoft Office Word Viewer 2003 is now listed as an application (the File Description identifies it as Microsoft Office Word Viewer), along with the last run time
In this lab, you have learned how the ActiveEfficiency Scout can be used to gather data from ConfigMgr relating to properties of devices that are managed by ConfigMgr as well as physical and virtual applications installed in those devices.
You have learned that discovery of Virtual Applications requires the application packages to be scanned for metadata using the VirtualAppExporter before the scout can use this information and create the associated installations in the ActiveEfficiency database.
You have also used the ActiveEfficiency Web Service (through the respective web pages) to view data from the ActiveEfficiency database, and identified the underlying tables used to store this data.