ASG Product Fix
Author : Philippe Laval
Product Name : TrackBird
Product Version : 3.2
Build : 747
Component Name : Mac OS X Clients

FIX OVERVIEW

NEW OPTIONS OF THE UNIX CLIENT IN VERSION 3.2

I - General

The content of the file "netbird.cfg" could be distroyed (duplicated entries or entries without content) due to simultaneous write access of differents components of TrackBird client. This is now fixed and only one component (nbamacx, nbcmacx, nbmmacx) can access this configuration file at the time.

In order to use TrackBird properly, you need to have unique "outputname". This name can be :

  • the "Computer name" set in the "Sharing" pane ("System Preferences" application).
  • or a random number.
  • If you choose "Computer name", you have to ensure that :

  • it is set on all Mac OS 9.x and 10.x computers.
  • and it is unique (you have to create a scheme like : building_floor_room_number - take characters in the set [0-9a-zA-Z_]).
  • We have modified the "random number" method because we had find evidence that our method was not good enough to assure unicity of "outputname". The new method now take :

  • if possible the MAC adress of the primary ethernet card (builtin card). This must unique by definition.
  • if not available, the serial number + _H:M:S:MS (hour:minute:second:millisecond)
  • if not available, a number based on H:M:S:MS (hour:minute:second:millisecond).
  • II - Installer (nbinstmacx)

    This tool allow you to install a Macintosh client running MacOS 10.x the same way you would have installed a client for Solaris, AIX, HP/UX or Linux.

    We assume in the commands below that :

    You have to run it with “admin” privilege. The typical install will be :

    If you want to be more precise or change the install path (ie not using the one set in TrackBird Admin IP), the syntax is :
    sudo ./nbinstmacx –server=192.168.42.209 –port=80 –alias=”trackbird” –installPath=”/ Library/Application Support/tbclient/”

    If you want to know the version and build of the installer :
    sudo ./nbinstmacx –version
    Password:
    ASG-TrackBird : 3.2.0.4
    Copyright (c) 2004-2005 Allen Systems Group, Inc. All rights reserved.

    If you want to know the syntax of the installer :
    sudo ./nbinstmacx –help

  • The daemon script files are now installed by the installer in the folder "/System/Library/StartupItems/nbimacx_script/". This allows the daemon to be launched on either Mac OS X Client or Mac OS X Server. The old location "/Library/StartupItems/nbimacx_script/" can not be used on Mac OS X Server.
  • Due to a security feature of Mac OS X Server 10.4, we had also to insure that all the daemon script files and folders have a uid:gid of 0:0 (root:wheel). It is now the case with the new installer.
  • III - Daemon (nbimacx)

    $ ./nbimacx -v
    ASG-TrackBird : 3.2.0.4
    Copyright (c) 2004-2005 Allen Systems Group, Inc. All rights reserved.

  • The daemon launch now the agent (nbamacx) and monitoring (nbmmacx) with or without a user logged in (no session openned). This allows the collector (nbcmacx) to be launched on :
    1. Mac OS X Server without a session open (normal state of this kind of computer)
    2. Mac OS X Client, when no user is using the computer.
  • The default parameter for awake period is changed from 120 minutes to 60 minutes. It may be tailored by modifying the file "nbimacx.pref"
  • $ emacs /Library/Application\ Support/tbclient/data/nbimacx.pref
    or
    $ pico /Library/Application\ Support/tbclient/data/nbimacx.pref

    IV - Agent (nbamacx)

    $ ./nbamacx -v
    ASG-TrackBird : 3.2.0.4
    Copyright (c) 2004-2005 Allen Systems Group, Inc. All rights reserved.

  • Due to a bug (detection of process), the agent could stop working (problem with the location of the file netbird.cfg). This lead in the agent not launching the collector (nbcmacx) after a period of time. The TrackBird client was not updating it's data to the server. This is now fixed.
  • V - Collector (nbcmacx)

    $ ./nbcmacx -v
    ASG-TrackBird : 3.2.0.4
    Copyright (c) 2004-2005 Allen Systems Group, Inc. All rights reserved.

    A new option allows to import user data in the TrackBird database.

    In order to do it, we have to figure out the identifiants (or ID) of elements or characteristics in the TrackBird tree.

  • Switch to DEBUG mode in TrackBird Server and choose the "Administration/Fields" menu.
  • Choose the element or characteristics then do a right clic droit and choose "Properties".
  • Use the "debug" tab and note the elem ID or carac ID.
  • Build an xml file with these information.
  • For example, create the file "user_data.xml" in the folder /usr/local/tbclient/data.

    <?xml version="1.0" encoding="UTF-8"?>
    <trackbird>
      <user_import>
        <element id="1027">
        <keyword id="65542">Philippe</keyword>
        <keyword id="65543">Laval</keyword>
        </element>
        <element id="1029">
        <keyword id="65544">Sophia Antipolis</keyword>
        <keyword id="65559">Centre ABS</keyword>
        </element>
      </user_import>
    </trackbird>
    

  • A bug in the detection of the screen capabilities attached to the computer was fixed (EDID) is now fixed.
  • Detection of new models of Macintosh :
    1. Mac mini
    2. Power Mac G5 single processor (smaller mainboard)
    3. PowerBook G4 - 12/15/17 inch (Jan 05)
  • The change from a GUI application (nbcmacx.app) to a tool (nbcmacx) introduced a bug in memory detection method (detection of process). This is now fixed.
  • We have fixed a bug where Cocoa and Carbon applications build in a bundle could not match the creator in the Macintosh glossary (they could not be reported as “known” applications). The creator of bundle application is now detected correctly.
  • More debug output are built-in (this may be helpfull in case of debugging).

    FIX INSTALLATION

    1. Quit TrackBird Admin IP
    2. Copy all components (xxx.cnb) to the "components" directory (default : C:\Program Files\ISTRIA\TrackBird IP Server\VirtualDir\files\components).
    3. Launch TrackBird Admin IP.
      1. Validate the new CRC found by TrackBird Admin IP.
      2. Save your configuration in order to distribute the new components in the collection points.