Altiris Inventory Solution for Macintosh
Upcoming SlideShare
Loading in...5
×
 

Altiris Inventory Solution for Macintosh

on

  • 898 views

 

Statistics

Views

Total Views
898
Views on SlideShare
898
Embed Views
0

Actions

Likes
0
Downloads
3
Comments
0

0 Embeds 0

No embeds

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

Altiris Inventory Solution for Macintosh Altiris Inventory Solution for Macintosh Document Transcript

  • ALTIRIS® INVENTORY SOLUTION® FOR MAC 6.1 SP1® HELP
  • Notice Copyright © 2000-2005 Altiris Inc. All rights reserved. Product Version: 6.1 Document Date: December 13, 2005 Protected by one or more of the following U.S. Patents: 5764593, 6144992, 5978805, 5778395, 5907672, 4701745, 5016009, 5126739, 5146221, 5414425, 5463390, 5506580. Other patents pending. Due to the inherently complex nature of computer software, Altiris does not warrant that the Altiris software is error-free, will operate without interruption, is compatible with all equipment and software configurations, or will otherwise meet your needs. The content of this documentation is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Altiris. Altiris, Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in this documentation. For the latest documentation, visit our Web site at www.altiris.com. Altiris, the Altiris logo, BootWorks, Eality, ImageBlaster, Inventory Solution, PC Transplant, RapiDeploy, RapidInstall, and Vision are registered trademarks of Altiris, Inc. in the United States. Altiris, the Altiris Logo, and ManageFusion are registered trademarks of Altiris, Inc. in other countries. Altiris Connector, Altiris eXpress, Altiris Protect, Application Management Solution, Application Metering Solution, Asset Control Solution, Asset Management Suite, Carbon Copy Solution, Client Management Suite, Compliance Toolkit, Connector Solution, Contract Management Solution, Deployment Server, Deployment Solution, Energy Saver Toolkit, Education Management Suite, Handheld Management Suite, Helpdesk Solution, Lab Management Suite, ManageFusion, Migration Toolkit, Mobile Client for SMS, Monitor Solution, Network Discovery, Notification Server, Package Importer, Patch Management Solution, Problem Management Suite, Recovery Solution, Security Solution, Server Management Suite, Site Monitor Solution, Software Delivery Solution, SNMP Management, Software Delivery Suite, TCO Management Solution, UNIX Client for SMS, Web Administrator, Web Reports, and other product names are trademarks of Altiris, Inc. in the United States and other countries. Audit on Connecct, Audit on Detect, AuditExpress, Scan on Detect, and SecurityExpressions are a trademarks of Pedestal Software Inc. in the United States. WebLens and Guaranteeing Your Net Works is a registered trademarks of Tonic Software Inc. in the United States. WebInsight and RUM are a trademarks of Tonic Software Inc. in the United States. Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries. HP and Compaq are registered trademarks of the Hewlett-Packard Corporation. Dell is a registered trademark of Dell Inc. Macintosh is a registered trademark of the Apple Computer Corporation. Palm OS is a registered trademark of Palm Computing, Inc. BlackBerry is a service mark and a trademark of Research In Motion Limited Corporation. RIM is a service mark and trademark of Research In Motion (RIM). All other brand names are trademarks or registered trademarks of their respective companies. Altiris Inventory Solution for Mac 6.1 SP 1 Help 2
  • Contents Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Chapter 1: Introducing Inventory Solution for Mac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Overview ......................................................................... 5 Features and Benefits ............................................................... 6 Component Overview ............................................................... 7 Mac Inventory Agent Package ..................................................... 7 Inventory Agents ............................................................ 7 Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Effect ..................................................................... 7 Collections .................................................................... 7 Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Use and Deployment ................................................................ 8 Chapter 2: Installing and Using Inventory Solution for Mac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Installing on the Notification Server .................................................... 9 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Step 1 – Installing Inventory Solution for Mac on the Notification Server . . . . . . . . . . . . . . . . . . . . . 9 Step 2 – Installing Licenses on the Notification Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Macintosh Computer Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Enabling and Scheduling or Disabling Inventory Scans on Macintosh Computers . . . . . . . . . . . . . . . 11 Chapter 3: Customizing Inventory Solution for Mac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 MacInventory Agent Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Modifying the MacInventory Agent Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Software Inventory Agent Configuration File (SWScan.ini) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Modifying SWScan.ini . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Software Inventory Agent for Mac Configuration File (SWScan.cfg) .......................... 14 Modifying SWScan.cfg .......................................................... 14 Scanning for a Single File or Files of a Given File Type ............................. 15 Scanning for Just One File or a Few Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Scanning For Data Files ..................................................... 16 Including or Excluding Volumes or Folders from the Software Scan . . . . . . . . . . . . . . . . . . . . 16 Hardware Inventory Agent —MachineInv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Modifying HWScan.ini .......................................................... 17 Excluding Specific Inventory Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Including Specific Inventory Groups ............................................ 17 Altiris Inventory Solution for Mac 6.1 SP 1 Help 3
  • Contents Chapter 4: Viewing Inventory Scan Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Viewing Inventory Software Scan Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Viewing Inventory Hardware Scan Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Using Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Chapter 5: Agents and Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Hardware Inventory Agent — MachineInv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 MachineInv Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Inventory Collector Agent — InvCollector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 InvCollector Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Software Inventory Agent — SoftwareScan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 SoftwareScan Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Chapter 6: Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Timeouts Posting Data from Remote Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Appendix A: Inventory Group Table Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Altiris Inventory Solution for Mac 6.1 SP 1 Help 4
  • Chapter 1: Introducing Inventory Solution for Mac This introduction includes the following topics: • Overview (page 5) • Features and Benefits (page 6) • Component Overview (page 7) • Use and Deployment (page 8) Overview Inventory Solution for Mac is designed to meet the demands of today’s diverse network environments. It gathers comprehensive software and hardware data from computers running Macintosh Operating System 10.2.8, 10.3.7, and later. Note: Use Altiris Inventory Solution for Mac 6.0 SP 1 to gather comprehensive software and hardware data from computers running Macintosh Operating System 8.6 and later. A variety of deployment and data collection options ensures that Inventory Solution for Mac 6.1 SP 1 works in many environments. To help maximize your investment, Inventory Solution for Mac 6.1 SP 1 goes beyond simple data gathering, by providing a Web-based management console, policies to alert you of critical information, and professional quality Web Reports. Inventory Solution for Mac 6.1 SP 1 includes the tools you need to transform your inventory data into useful information. The Altiris Inventory Solution for Mac agents are deployed and installed on Macintosh computers using the Altiris Agent for Mac and an Inventory task policy. The inventory is collected using Inventory Solution for Mac agents on the Macintosh computer and the inventory is then sent to the Notification Server. There are several ways to gather the inventory on Macintosh computers using Inventory Solution for Mac 6.1 SP 1, including scheduling inventory scan times using the policies and manually running the inventory scans on the computers. Altiris Inventory Solution for Mac 6.1 SP 1 Help 5
  • Chapter 1: Introducing Inventory Solution for Mac Features and Benefits When an inventory scan is run, Inventory Solution for Mac 6.1 SP 1 collects comprehensive inventory data (including serial number, hardware inventory, and software inventory) and generates easy-to-understand inventory reports. Note: We also provide Inventory Solutions for computers running Windows, UNIX, Pocket PC, Palm operating systems, and RIM devices. Note: You can refer to the Altiris Connector for Microsoft SMS Product Guide for information about integrating SMS. Features and Benefits Inventory Solution for Mac 6.1 SP 1 provides the following features and benefits: • It provides full access to the data from most browsers. Data can be accessed through Web Reports on the Altiris Console. • It includes integrated Web Reports. Inventory Solution for Mac 6.1 SP 1 comes with numerous built-in reports that help you analyze and make proactive management decisions based upon the Inventory Solution for Mac 6.1 SP 1 data. This allows quick and easy access to inventory information without having to create custom SQL scripts. Custom reports may also be added and scheduled to run automatically. • It posts data through HTTP. Inventory Solution for Mac 6.1 SP 1 data can be sent to the Notification Server through an HTTP post to the Notification Server. • The Inventory Solution for Mac agents are installed using the Inventory Task policy. The inventory gathered by Inventory Solution for Mac includes • Computer serial number. Altiris Inventory Solution for Mac 6.1 SP 1 Help 6
  • Chapter 1: Introducing Inventory Solution for Mac Component Overview • Comprehensive software inventory. • Disk, operating system, and system configuration settings. • Free disk space and memory. • Peripheral hardware information such as keyboards, mouse devices, USB devices, and so on. Component Overview This overview contains information on the following topics: • Mac Inventory Agent Package (page 7) • Collections (page 7) • Policies (page 7) • Reports (page 8) Mac Inventory Agent Package Section Topics: • Inventory Agents (page 7) • Distribution (page 7) • Effect (page 7) Inventory Agents The Inventory Solution for Mac agents determine what data will be collected during the inventory scan. For more information, see “Agents and Switches” on page 20. Distribution The Mac Inventory Agent Package is pushed from the Inventory policy on the Notification Server. Effect The Mac Inventory Tasks install the inventory agents in each Macintosh computer’s <startupdisk>/ Applications/Utilities/Altiris/NSAgent/.var/packages/{DEC68AD9-46F6-4139-9793- AE0E1B050BFC} folder. Collections We use “collections” to group objects (such as computers) based on common attributes. The predefined collection used by Inventory Solution for Mac 6.1 SP 1 is the All Macintosh Computers with Agent 6.1 SP 1 Collection. Policies Inventory Solution for Mac uses policies to perform a variety of predefined actions when defined conditions occur. Several policies are installed on the Notification Server when Inventory Solution for Mac 6.1 SP 1 is installed. The policies are set up to work with collections and the inventory agents on computers running the Altiris Agent for Mac and the Inventory Solution Agents for Mac. The policies will help you track new computers, inactive computers, duplicate computers, and so forth. Each of the policies can be modified and new policies can be created using the Altiris console. For information on modifying and creating policies, see the Altiris Notification Server Help. Altiris Inventory Solution for Mac 6.1 SP 1 Help 7
  • Chapter 1: Introducing Inventory Solution for Mac Use and Deployment Reports Inventory Solution for Mac uses data gathered from inventory scans to produce and host Web Reports. The reports can help you analyze inventory data from your Macintosh computers. The reports are in the Altiris Console under the Reports tab and they can be viewed by selecting Assets and Inventory > Inventory > Macintosh. The deployment reports help you understand which computers are new, which ones are no longer reporting current information, and the size of the inventory data being transmitted over the network. The other reports provide details about the inventory data that is gathered. All reports can be modified and new reports can be created using the Altiris Console. For information on modifying and creating reports, see the Altiris Notification Server Help. Use and Deployment Special emphasis has been placed on ease of deployment, small agent size, and non-intrusive operation (by using unused CPU cycles and network resources). Inventory data can be collected from Macintosh computers by using policies. Altiris Inventory Solution for Mac 6.1 SP 1 Help 8
  • Chapter 2: Installing and Using Inventory Solution for Mac Installing on the Notification Server Inventory Solution for Mac 6.1 SP 1 must be installed on a computer running Notification Server. For more information, see the Altiris Notification Server Help. Installing and licensing Inventory Solution is done in several steps: • Prerequisites (page 9) • Step 1 – Installing Inventory Solution for Mac on the Notification Server (page 9) • Step 2 – Installing Licenses on the Notification Server (page 10) Prerequisites The Altiris Notification Server must be Installed If you had previously installed Notification Server, run the Altiris Install Helper (NSInstallHelper.exe). The install helper will ensure you are using the most up-to-date Notification Server and then will automatically download and install solutions for the licenses in the folder. For more information, see the Altiris Notification Server Help and Altiris Notification Server Reference. The Altiris Agent for Mac must be Installed on the Notification Server The Altiris Agent for Mac is a necessary software component that is designed to work with Altiris solutions for Mac computers, including the Inventory Solution for Mac and Software Delivery Solution for Mac. The Altiris Agent for Mac establishes the connection between the Notification Server and each discovered Macintosh computer. Note: Altiris solutions for Mac have additional agents that plug-in to this Altiris Agent for Mac, adding functionality specific to each solution’s capabilities. For more information, see the Altiris Agent for Mac Help. Step 1 – Installing Inventory Solution for Mac on the Notification Server Option A: Installing Altiris products using the Altiris Install Helper Using the Altiris Install Helper method: • Installs or upgrades the Altiris Notification Server to the most current version. • Installs or upgrades the Altiris Network Discovery component to the most current version on the Notification Server. • Installs or upgrades the Altiris Agent for Mac to the most current version on the Notification Server Altiris Inventory Solution for Mac 6.1 SP 1 Help 9
  • Chapter 2: Installing and Using Inventory Solution for Mac • Installs or upgrades the each solution in the product (if not already installed) or upgrades the installed Altiris Inventory Solution for Mac to the most current version on the Notification Server. 1 When you receive the product file, unzip it. The zip file contains the Altiris Install Helper (NSInstallHelper.exe), the applicable license file or files (with a .txt file extension or a .lic file extension) for the product and solutions, and some .dll files and .ini files used for language versions and product configuration. 2 Run the Altiris Install Helper (NSInstallHelper.exe) and follow the instructions on the screen. Option B: Installing Altiris products from the Altiris Solution Center in the Altiris Console Using the Solution Center in the Altiris Console method: • Installs or upgrades the Altiris Network Discovery component to the most current version on the Notification Server. • Installs or upgrades the Altiris Agent for Mac to the most current version on the Notification Server • Installs or upgrades the each solution in the product (if not already installed) or upgrades the installed Altiris Inventory Solution for Mac to the most current version on the Notification Server. 1 Open the Altiris Console. Navigate to Start > Programs > Altiris > Altiris Console. 2 Click the Configuration tab. 3 In the left pane, click Configuration > Upgrade/Install Additional Solutions. 4 In the right pane (Solution Center page), click the Available Solutions tab and click Solutions. 5 Scroll down the Solution / Description column to Altiris Inventory Solution for Mac and click on the blue title. 6 When the Solution Suite Download Page — Web Page Dialog appears, click Start. The solution is downloaded, installed, and configured. This process may take several minutes. Step 2 – Installing Licenses on the Notification Server Altiris solutions automatically install with a 7-day trial license. You must apply for a 30-day evaluation license or purchase a full license from the Altiris Web site to continue using this product. To install a license 1 From the Altiris Console, click the Configuration tab view. 2 In the treeview pane, click Licensing. 3 In the right pane, click Install License. Click on the link to the Altiris Web site location for registration. Follow the instructions on the Altiris Web site for registering your product. Your license key will then be sent to you. 4 After you receive your license key, open the Altiris Console, then click the Configuration tab view. 5 Click the Install License tab view. 6 To install from an e-mail message: a Select Paste content of Licenses below. b Copy and paste the license from the e-mail message into the window. c Click Install License. The licenses will be installed. If there is an error, it will appear on the bottom of the page. 7 To install from one or more files: Altiris Inventory Solution for Mac 6.1 SP 1 Help 10
  • Chapter 2: Installing and Using Inventory Solution for Mac a Place your file(s) into a folder containing only the license files you wish to install. Important: This folder should only contain license files. b Select Path to license folder. c Enter the path of the folder or click Browse and browse to the folder. d Click Install License. The licenses will be installed. If there is an error, it will appear on the bottom of the page. 8 Confirm the license(s) installed successfully. a Click on the Configuration tab view. b In the treeview pane, click Licensing. c Select the License Status tab view. For more information on product licenses and how to purchase other Altiris suites or solutions, see the Altiris web site at http://www.altiris.com Inventory Solution for Mac uses the Altiris Agent for Mac that you install on Macintosh computers. The Altiris Agent for Mac software provides communication between the Macintosh computer and the Notification Server, communicates with and responds to the Inventory Solution for Mac policies and provides automated inventory scan scheduling. The Altiris Agent for Mac with the Altiris Inventory Agent for Mac collect inventory data, process the data, and post results on the Notification Database. Macintosh Computer Requirements Hardware Requirements Software Requirements Apple computer with a G3 or better processor Mac OS 10.2.8 and later (this includes all iMac, iBook, and G3 or G4 Altiris Agent for Mac. See the Altiris Agent for PowerBooks and PowerMacs) Mac Help. Free Disk Space: 15 MB Enabling and Scheduling or Disabling Inventory Scans on Macintosh Computers Important: Before you enable Inventory Solution for Mac policies, you may want to modify the contents and execution of the contents in the package. 1 Configure the MacInventory Package as wanted before enabling the policy. See “Customizing Inventory Solution for Mac” on page 13. 2 In the Altiris Console, click the Tasks tab. 3 In the treeview pane, click Tasks > Assets and Inventory > Inventory > Macintosh > Inventory Tasks. 4 Click the inventory policy you want to use on the Macintosh computers. 5 Click the Enable check box to mark (enable) or clear (disable) the box. Tip: Only enable one of the policies. If you enable more then one, some information will be collected twice. 6 Select a collection by clicking the link after Applies to collection. 7 Set the scheduling options. Tip: Select the Run as soon as computer is notified (runs only once) check box. 8 Click Apply. Altiris Inventory Solution for Mac 6.1 SP 1 Help 11
  • Chapter 2: Installing and Using Inventory Solution for Mac Note: When a Inventory Solution for Mac policy is enabled and run, the agents are installed on the Macintosh computer in the default <startupdisk>/Applications/Utilities/Altiris/NSAgent/.var/ packages/{DEC68AD9-46F6-4139-9793-AE0E1B050BFC} folder. Altiris Inventory Solution for Mac 6.1 SP 1 Help 12
  • Chapter 3: Customizing Inventory Solution for Mac Inventory Solution for Mac uses a number of agents to scan for specific types of information and post the data to Notification Server. Many of the agents that run as part of Inventory Solution for Mac have several application switches that control various features of the product. MacInventory Agent Package Before you enable Inventory Solution for Mac policies, you may want to modify the contents and execution of the contents in the package. You modify the Inventory Solution for Mac agents by editing the MacInventoryPackage on the Notification Server before you enable the inventory policies for the Macintosh computers. You can modify the execution of the agents by changing the switches in configuration files and in the Command line field in the MacInventory Agent Package. Modifying the MacInventory Agent Package 1 In the Altiris Console, click the Configuration tab. 2 In the treeview pane, click Configuration > Solutions Settings > Assets and Inventory > Inventory > Macintosh > Inventory Agent Package > Macintosh Inventory Agent Package. 3 In the right pane, click the Programs tab. 4 In the Program field, select the program. 5 In the Command line field, change the switch. 6 Click Apply. Software Inventory Agent Configuration File (SWScan.ini) The Software Inventory Agent for Mac (SoftwareScan), which is installed on the Altiris managed Macintosh computers, uses the SWScan.cfg file to determine what software to scan for when it scans a Macintosh computer. Modifying SWScan.ini 1 On the Notification Server, go to: <Installed Drive>:Program FilesAltirisNotification ServerNSCapBinMacInventorySWSc an.ini. 2 Use a text editor to make the wanted changes in the file. • The SoftwareScan.app switches are documented in “SoftwareScan Switches” on page 22. • The InvCollector.app switches are documented in “InvCollector Switches” on page 21. 3 Save the file. Altiris Inventory Solution for Mac 6.1 SP 1 Help 13
  • Chapter 3: Customizing Inventory Solution for Mac Note: An alternate .cfg file name can be specified for the software inventory agent using the --cfg filename switch in the SWscan.ini. Software Inventory Agent for Mac Configuration File (SWScan.cfg) The default SWScan.cfg file covers the inventory needs of most Macintosh installations. However, you can customize it using a text (or XML-specific) editor. If you are going to modify the XML file, you should know what to do with the tags in the file, especially because Inventory Solution 6.1 for Mac introduces some new design on inventory configuration. The SWScan.cfg file can be modified to control settings, such as which files are ignored in a software inventory scan, how to group sets of applications, and which volumes and folders to include in the scan. Any file or product, such as the utilities included with the base operating system, can be excluded from the scan. This enables you to gather only the specific information you want from your computers and not receive a lot of unnecessary information about files and products that are either part of the operating system or products that you do not care to track. Modifying SWScan.cfg 1 On the Notification Server, go to: <Installed Drive>:Program FilesAltirisNotification ServerNSCapBinMacInventory SWScan.cfg. 2 Open the file with a text (or XML-specific) editor. 3 Modify the file using the following items: Items Description Manufacturer mapping The manufacture mappings provide a way to abbreviate and/or consolidate strings that may encounter in the scans to a unified label (such as “Adobe Systems Inc.” to “Adobe”). Extension mapping Macintosh files are categorized in two different ways: FileType (a 4- character code embedded within the file), or filename extension; files on a Macintosh file system may employ one or the other (though some have both). This section allows grouping/reporting files together which may have only one of the two previously mentioned methods of categorization, and allows Attribute Filters to specify FileType and yet still capture files which use only a filename extension (such extensions being mapped into that FileType). Note that multiple extensions may be mapped to the same FileType (such as in our default configuration, “jpg” and “jpeg” are both mapped to FileType JPEG). Filter Packs A Filter Pack is comprised of one or more filters, each of which is OR’d together (a file need only pass one of the constituent filters within a Filter Pack to be reported). There are two types of Filter Packs: Location Filter Packs and Attribute Filter Packs. Altiris Inventory Solution for Mac 6.1 SP 1 Help 14
  • Chapter 3: Customizing Inventory Solution for Mac Items Description Location Filter Packs Location Filter Packs are comprised of one or more Location Filters. Each Location Filter allows specification of: i. Location within the file system. Note that “Volumes” is the “parent folder” (if you will) of all data drives physically attached to or mounted in a Macintosh, and is the most inclusive location. ii. Subfolder inclusion (<Subfolders>true</Subfolders>.) or exclusion (<Subfolders>false</Subfolders>) – determining whether or not to include items found in subfolders of the specification location. iii. Location inclusion (<Include>true</Include> or exclusion (<Include>false</Include>) – determining whether that location is included or excluded from the areas of the file system to be scanned. Attribute Filter Packs Attribute Filter Packs are comprised of one or more Attribute Filters. Each Attribute Filter allows specification of: i. Conditions of file attributes (filename, filetype, manufacturer, size, and so on), each of which must be met (AND logic) for the file to be reported. ii. Whether files matching a condition are included (<Include>true</Include>) or excluded (<Include>false</Include>) from the reporting. iii. Whether files passing the filter pack are to be listed in the detail report (<Detail>true</Detail>) and/or included in the tallies for disk usage (<DiskUsage>true</DiskUsage>). 4 Save the file. 5 In the Altiris Console, click the Configuration tab. 6 In the treeview pane, click Configuration > Solution Settings > Asswhatets and Inventory > Inventory > Macintosh > Inventory Agent Packages > Macintosh Inventory Agent Package. 7 Click Apply. 8 Click Update Distribution Points. Scanning for a Single File or Files of a Given File Type To scan for specific files or files with a specific file type • To find files of a particular type, you will need to modify the SWScan.cfg file. Provide the file extension type in <FileType> tag. For example, to find all files that are of type PDF, make the following changes. <FileType> <Type>PDF</Type> <Include>true</Include> <Use>true</Use> </FileType> Scanning for Just One File or a Few Files • To find one or a few files, you will need to modify the SWScan.cfg file. You can use the following sections, which are the essential sections to make this work: <AttributeFilterPack> <AttributeFilter> <Name>APPL</Name> <Detail>true</Detail> <DiskUsage>true</DiskUsage> <Package>true</Package> <FileType> <Type>APPL</Type> Altiris Inventory Solution for Mac 6.1 SP 1 Help 15
  • Chapter 3: Customizing Inventory Solution for Mac Hardware Inventory Agent —MachineInv <Include>true</Include> <Use>true</Use> </FileType> <FileName> <Name>InvSoln</Name> <Include>true</Include> <Use>true</Use> </FileName> <Manufacturer> <Name>Altiris</Name> <Include>true</Include> <Use>true</Use> </Manufacturer> </AttributeFilter> <AttributeFilterPack> Scanning For Data Files • To scan the data files, you will need to modify the SWScan.cfg file. Provide the extension of all the data files in the <FileType> tag. For example, to find all data files that are of type TEXT, make the following changes: <FileType> <Type>TEXT</Type> <Include>true</Include> <Use>true</Use> </FileType> Including or Excluding Volumes or Folders from the Software Scan You can include or exclude any volume or any folder on any volume from scanning. The only issue is Volume Name may differ from system to system, so it’s not possible to have a unique config file which can be used on all computers No variable is defined which can fill the name of mounted drive at runtime. To scan root volume only <Location>/</Location> <Subfolders>false</Subfolders> <Include>false</Include> This will exclude mounted drive. So using “/” and then appending any valid folder structure path you can include or exclude mounted drive (or folder on mounted drive). Hardware Inventory Agent —MachineInv The Hardware Inventory Agent, MachineInv, collects and reports data from Macintosh computers that have an installed Altiris Agent for Mac. This is done on the basis of the contents of the MachInv.ini file and the configuration in the HWScan.ini files. The data is gathered from the core Macintosh computers such as the version of the operating system, the logged-on user, the set of local and network volumes, the amount of physical memory, the TCP/IP configuration, and CPU. You can modify the Hardware Inventory Agent configuration by editing the HWScan.ini files using switches. Section Topics: • Modifying HWScan.ini (page 17) The Hardware Inventory Agent for Mac uses the MachInv.ini file to either exclude or include inventory groups from the scans. You can create other .ini files and change the switches in the HWScan.ini file to use files other than the MachInv.ini file for the inclusion or exclusions. Altiris Inventory Solution for Mac 6.1 SP 1 Help 16
  • Chapter 3: Customizing Inventory Solution for Mac Hardware Inventory Agent —MachineInv Modifying HWScan.ini 1 On the Notification Server, go to: <Installed Drive>:Program FilesAltirisNotification ServerNSCapBinMacInventoryHWS can.ini. 2 Use a text editor to make the wanted changes in the file. • The MachineInv.app switches are documented in “MachineInv Switches” on page 20. • The InvCollector.app switches are documented in “InvCollector Switches” on page 21. 3 Save the file. Excluding Specific Inventory Groups The line “MachineInv --ini MachInv.ini” in the HWScan.ini file is used to exclude the inventory groups in the MachInv.ini file from the hardware scan. To exclude specific inventory groups from the hardware inventory scan 1 Create the MachInv.ini file with a list of the inventory groups you want to exclude in the hardware inventory scan. For a list of inventory groups, see “Inventory Group Table Reference” on page 24. Example: You could create a MachInv.ini file with the following inventory groups: EU Logon Users HW CDRom HW CPU HW USB HW Video 2 Place the MachInv.ini file on the server’s <Install Drive>:Program FilesAltirisNotification ServerNSCapBinMacInventory folder. 3 Modify the MachineInv switches in the HWScan.ini file as follows: MachineInv --ini MachInv.ini Note: See “MachineInv Switches” on page 20 for other options. 4 Save the file. 5 In the Altiris Console, click the Configuration tab. 6 In the tree view pane, click Configuration > Solution Settings > Assets and Inventory > Inventory > Macintosh > Inventory Agent Packages > Macintosh Inventory Agent Package. 7 Click Apply. 8 Click Update Distribution Points. When hardware scans are run, the inventory groups will be excluded. Including Specific Inventory Groups The line “MachineInv --ini MachInv.ini --inc” in the HWScan.ini file is used to include the inventory groups in the MachInv.ini file in the hardware scan. The MachInv.ini file and the --inc switch in the HWScan.ini file are used to include specific inventory groups in the hardware scan. To include only specific inventory groups in the hardware inventory scan 1 Create the MachInv.ini file with a list of the inventory groups you want to include in the hardware inventory scan. For a list of inventory groups, see “Inventory Group Table Reference” on page 24. Example: You could create a MachInv.ini file with the following inventory groups: Altiris Inventory Solution for Mac 6.1 SP 1 Help 17
  • Chapter 3: Customizing Inventory Solution for Mac Hardware Inventory Agent —MachineInv EU Logon Users HW CDRom HW CPU HW USB HW Video 2 Place the MachInv.ini file on the Notification Server’s <Installed Drive>:Program FilesAltirisNotification ServerNSCapBinMacInventory folder. 3 Modify the MachineInv switches in the HWScan.ini file as follows: MachineInv --ini MachInv.ini --inc Note: See “MachineInv Switches” on page 20 for other options. 4 Save the file. 5 In the Altiris Console, click the Configuration tab. 6 In the tree view pane, click Configuration > Solution Settings > Assets and Inventory > Inventory > Macintosh > Inventory Agent Packages > Macintosh Inventory Agent Package. 7 Click Apply. 8 Click Update Distribution Points. When hardware scans are run, only the inventory groups will be included. Altiris Inventory Solution for Mac 6.1 SP 1 Help 18
  • Chapter 4: Viewing Inventory Scan Results Viewing Inventory Software Scan Results This section tells you how to view hardware inventory results that are generated by hardware inventory agent. 1 In the Altiris Console, click the Resources tab. 2 In the tree view pane, select Resource Management > Collections > Computer Collections > Macintosh Computers > All Macintosh Computers. 3 In the right pane under the All Macintosh Computers heading, double-click the name of the computer on which you ran the Hardware scan. 4 In the Resource Manager, click the Inventory tab. 5 In the left pane: • Click the Hardware folder to view the collected hardware data from the client. • Click the Operating System folder to view the information about the operating system. • Click the User folder to view the information about logged on user. The Inventory scan results can be viewed using the Resource Manager. From the Altiris Console, Reports tab, a group called Mac Inventory Results records the collection time, the file count, the total size, and the version (the version of collector posting the data). Viewing Inventory Hardware Scan Results This section tells you how to view inventory results that are generated after changing the HWScan.ini configuration file. 1 In the Altiris Console, click the Resources tab. 2 In the treeview pane, select Resource Management > Collections > Computer Collections > Macintosh Computers > All Macintosh Computers. 3 In the right pane under the All Macintosh Computers heading, double-click the name of the computer on which you ran the scan. This opens (or refreshes a currently open) Resource Manager window in a new browser. 4 In the Resource Manager, click the Inventory tab. Using Reports 1 In the Altiris Console, click the Reports tab. 2 In the treeview pane, click Reports > Assets and Inventory > Inventory > Macintosh and select the wanted report folder and report. 3 In the right pane, click the report option. Altiris Inventory Solution for Mac 6.1 SP 1 Help 19
  • Chapter 5: Agents and Switches When the Altiris Agent for Mac is installed on a Macintosh computer, a <startup disk>/ Applications/Utilities/Altiris/NSAgent/ folder is created and software is copied to the folder. To install the Altiris Agent for Mac, see the Altiris Agent for Mac Help. Altiris inventory agents are programs that scan the hardware and software on a computer, collect the inventory data, processes the data, and forward the data to the Notification Database. When the inventory policies are enabled and run, the Altiris inventory agents are installed on the Macintosh computers in the collection, the Macintosh computers communicate with and respond to the Inventory Solution for Mac policies issued by the Notification Server. The policies are used with collections to do activities like scheduling inventory scans on the collections. Hardware Inventory Agent — MachineInv The Hardware Inventory Agent, MachineInv, collects and reports data from Macintosh computers that have an installed Altiris Agent for Macintosh. This is done on the basis of the contents of the MACHINV.INI file and the configuration in the HWScan.ini file. The data is gathered from the core Macintosh computers such as the version of the operating system, the logged on user, the set of local and network volumes, the amount of physical memory, the TCP/IP configuration, and CPU. MachineInv Switches (Used in HWScan.ini) MachineInv Switches Switch Description -? Displays this help -o .nsi file full path The .nsi file output path. Specifies the directory where the files need to be written. If this application switch also includes a file, then only a single file will be written to the output path. --outfilename .nsi file name filename is the name of the .nsi file to be generated. Specifies a specific file where it needs to be written, relative to the default output directory (hence no multi file output). If neither the -o or the -- outfilename switches are used, then MachineInv will generate multiple files in the default output directory. --ini File Path The full path including the filename of HWScan.ini file. This is used to specify those groups that are included or excluded from the hardware inventory scan. The default is to exclude named groups. See also the description for --inc parameter below. --inc Include groups named in the HWScan.ini file and exclude all others. The default behavior, without --inc, is to exclude. The Hardware Inventory Agent for Mac uses the MachInv.ini file to either exclude or include inventory groups from the scans. You can create other .ini files and change the switches in the HWScan.ini file to use files other than the MachInv.ini file for the inclusion or exclusions. Altiris Inventory Solution for Mac 6.1 SP 1 Help 20
  • Chapter 5: Agents and Switches Inventory Collector Agent — InvCollector Inventory Collector Agent — InvCollector InvCollector gathers data from the various .nsi files along with the computer’s GUID, and then posts this data through HTTP to the Notification Server. InvCollector Switches You can modify the Inventory Collector Agent configuration by editing the HWScan.ini, and SWScan.ini files using the following switches. InvCollector Switches Switches Description -? Shows a usage dialog. -s SourceDir The source directory for the inventory files. The default is <Startup Disk>:Applications: Utilities:Altiris:NSAgent:.var:packages: {DEC68AD9-46F6-4139-9793-AE0E1B050BFC}: Inventory. --url “URL” Specifies the URL where the NS remote event file will be posted. The URL must be in double-quotes. --forcenoprompt Closes after completion (regardless of errors). --hidden Runs in silent mode. It will not prompt you if an error is encountered or when the operation is complete. --noprompt Closes after completion (if no errors). --nocheck Processes all files, regardless of whether they have changed since the last run. Software Inventory Agent — SoftwareScan The Software Inventory Agent provides much more than a raw dump of data — it provides much needed contextual information to help you really see what is important among the tens of thousands of files on the computer. For example, at a glance, you can see the browser settings on the computer. The Software Inventory Agent (SoftwareScan) does the following: • Performs an extensive inventory of the programs and files on the computers. This data can be viewed in real time or forwarded to Notification Server. • Gathers product name from the application files that it finds on the disk. • Generates the data in XML format. You can immediately view the XML formatted results of a software inventory scan. This provides a real time support and diagnostic tool to track workstation software configuration issues. The XML data can also be loaded into the Notification database. • Reports file usage without the hassle of maintaining a knowledge base. • Reports on used disk space of files such as MP3, JPEG, MOV, and so on. • Reports, if an evaluation copy of the software or a licensed copy was run, the agent version, and the date the scan was run on a particular computer. • Can be configured to notify you of any application files that are on your computer that do not have the required resource information. The full path, size, and application type of these unknown files are included in the output file. The Software Inventory Agent receives input on how to run from the following sources: • The Software Inventory Agent uses the SWScan.cfg file to determine what information is reported. The software scan agent generates .nsi files. The SWScan.cfg file needs to be in the same directory as the SoftwareScan application. Altiris Inventory Solution for Mac 6.1 SP 1 Help 21
  • Chapter 5: Agents and Switches Software Inventory Agent — SoftwareScan Other .cfg files may be specified for the Software Inventory Agent configuration using the --cfg filename switch in the SWScan.ini file. For more information, see “Software Inventory Agent Configuration File (SWScan.ini)” on page 13. SoftwareScan Switches (Used in SWScan.ini) The Software Inventory Agent configuration can be modified by editing the SWScan.ini file using the following switches. SoftwareScan Switches Switch Description -? Shows a usage dialog. --cfg filename Use the specified file as the configuration file instead of the default file. Default file is SWScan.cfg. --hidden Makes the progress dialog invisible. End users will not be able to cancel the scan unless they end the process with Process Viewer or using the terminal command “Kill PID [process ID]”. The scan can also be cancelled by doing Force Quit in the case of Mac OS X and later. --dd Delayed dismiss. This only works in non-hidden mode and causes a message box to be opened at the end of the run. The user has an indefinite period to examine data. Without the --dd switch the window automatically closes. -o path The directory where XML output data should be generated. This overrides the default settings. Altiris Inventory Solution for Mac 6.1 SP 1 Help 22
  • Chapter 6: Troubleshooting This section lists common troubleshooting problems and gives probable resolutions. This section includes the following topic: • Timeouts Posting Data from Remote Computers (page 23) Timeouts Posting Data from Remote Computers When posting data to the Notification Server through HTTP (which happens when data is posted from the Altiris Agent for Mac or when you use the --URL switch with InvCollector) the data needs to be posted within the active server page timeout period on your Notification Server. If your Macintosh computers experience problems posting the data before the timeout period, you can change the ASP timeout period. To change the timeout 1 Open the Internet Service Manager MMC console. a Click Start b Click Run. c In the Open box, type mmc. 2 Expand the default Web site and select properties of the Altiris/NS virtual directory. 3 From the Altiris/NS properties, select Configuration (under the application settings). 4 In the Application Configuration properties, change the ASP Script Timeout parameter to a higher number of seconds. Altiris Inventory Solution for Mac 6.1 SP 1 Help 23
  • Appendix A: Inventory Group Table Reference The following table displays a list of inventory group tables that are found in the Notification database. Table Name Description AeX AC Client Agent Provides information about any Altiris clients installed on the client computer. AeX AC Identification Provides summary level inventory information about the client system (OS, User info, etc). AeX AC Roles Determines role of the client computer based on the installed software and services. AeX AC TCPIP Contains detailed TCPIP information, settings, and configuration data for client computers. Mac EU Logon Users Contains information regarding logon user activity on Macintosh computers. Mac HW CPU Contains CPU information for Macintosh computers. Mac HW Disk Space Contains information on how much space TMP and IE Cache files are consuming on the Usage Macintosh computer. Mac HW Memory Contains information on total physical memory on the Macintosh computer. Mac HW Memory Contains information about installed RAM modules on the Macintosh computer. Modules Mac HW Mouse Contains information about installed mouse devices on the Macintosh computer. Mac HW CDROM Contains information about the installed CD ROM drives. Mac HW Disk Volumes Contains information about the mounted disk volumes. Mac HW Keyboard Contains information about the installed keyboard. Mac HW Open Firmware Contains information about the open firmware. Mac Inventory Results Contains information about the last inventory scan. Mac HW Printer Contains information on installed printers on the Macintosh computer—network and local. Mac HW FireWire Contains information on installed FireWire devices on the Macintosh computer. Mac HW SCSI Contains information on installed SCSI devices on the Macintosh computer. Mac HW USB Contains information on installed USB devices on the Macintosh computer. Mac HW Serial Number Contains serial number and computer model for the Macintosh computer. Mac HW Video Contains information on installed video adapters and drivers on the Macintosh computer. Mac OS Operating Contains version and installation information for the OS on the Macintosh computer. System Mac SW Audit Results Contains summary information on the last software inventory performed on the Macintosh computer. Mac SW Audit Software Contains information of the disk space that is used by different types of files on the Macintosh computer. Mac SW Disk Usage Provides summary level information on the total number of files scanned and their total Summary disk usage. Altiris Inventory Solution for Mac 6.1 SP 1 Help 24
  • Index Symbols switches 20 (AeXMacAuditPls) Hardware Inventory Agent (MachInv) modifying configuration 13 .ini AeXInvSoln 13 modifying configuration 17 Software Inventory Agent MachInv 17 hardware inventory scan (SoftwareScan) 21 viewing results 19 switches 22 A hardware scan software inventory scan excluding inventory group 17 viewing results 19 AeXInvSoln.ini 13 including inventory group 17 SoftwareScan, see "Software Inventory AeXMacAuditPls, see "Software Agent" 21, 22 Inventory Agent" 13 I switches Agent Hardware Inventory Agent 20 Hardware Inventory 16 including inventory group in hardware InvCollector 21 Inventory Collector 21 Inventory Collector Agent 21 Software Inventory 13, 21, 22 scan 17 introduction 5 MachineInv 20 Altiris Client for Macintosh Software Inventory Agent 22 modifying settings 13 InvCollector, see "Inventory Collector SoftwareScan 22 Agent" 21 B inventory 24 T benefits 6 Inventory Collector Agent table reference (InvCollector) 21 inventory group 24 C switches 21 timeout 23 Client Install Package inventory group excluding from hardware scan 17 troubleshooting distribution 7 timeouts posting data from remote effect 7 including in hardware scan 17 table reference 24 computer 23 collection 7 components 7 inventory table reference 24 V copyright 2 L version 2 creation date of document 2 legal notice 2 D M data files MachineInv, see "Hardware Inventory scanning for 16 Agent" 16 data reference 24 MachInv.ini 17 deployment, use 8 document N print date 2 notice 2 E O excluding overview, components 7 inventory group from hardware scan 17 P F policy 7 features 6 product version 2 file R scanning for 15 searching for 15 report 8 file type results scanning for 15 viewing hardware inventory scan 19 viewing software inventory scan 19 H S Hardware Inventory Agent (MachineInv) 16 Software Inventory Agent Altiris Inventory Solution for Mac 6.1 SP 1 Help 25