----------------------------------------------
git version control system http://git-scm.com/
----------------------------------------------
openSUSE
$ sudo zypper install git-core


----------------------------------------------
development server
----------------------------------------------
openSUSE 11.2

peppe@linux-1bgn:~> uname -a
Linux linux-1bgn 2.6.31.5-0.1-desktop #1 SMP PREEMPT 2009-10-26 15:49:03 +0100 x86_64 x86_64 x86_64 GNU/Linux
peppe@linux-1bgn:~> java -version
java version "1.6.0_23"
Java(TM) SE Runtime Environment (build 1.6.0_23-b05)
Java HotSpot(TM) 64-Bit Server VM (build 19.0-b09, mixed mode)
peppe@linux-1bgn:~> jruby -v
jruby 1.6.0.RC1 (ruby 1.8.7 patchlevel 330) (2011-01-10 769f847) (Java HotSpot(TM) 64-Bit Server VM 1.6.0_23) [linux-amd64-java]


----------------------------------------------
Prerequisites
----------------------------------------------
1) Visionael NRM (tested on Version: 10.3.0-SNAPSHOT)

2) java

3) jruby - http://www.jruby.org/getting-started
download the binaries, unpack and update your $PATH


----------------------------------------------
Installation
----------------------------------------------
$ git clone git://github.com/priviterag/thingmagic.git

update your $CLASSPATH to add the jars in the libs subdir
e.g.: export CLASSPATH=$CLASSPATH:/opt/thingmagic/libs/libs/mercuryapi.jar:/opt/thingmagic/libs/appserv-admin-2.1.jar:/opt/thingmagic/libs/appserv-deployment-client-2.1.jar:/opt/thingmagic/libs/appserv-ext-2.1.jar:/opt/thingmagic/libs/appserv-rt-2.1.jar:/opt/thingmagic/libs/imqjmsra-2.1.jar:/opt/thingmagic/libs/j3d-core-1.3.1.jar:/opt/thingmagic/libs/javaee-2.1.jar:/opt/thingmagic/libs/log4j-1.2.16.jar:/opt/thingmagic/libs/vecmath-1.3.1.jar:/opt/thingmagic/libs/vnd_core_api-10.3.0-SNAPSHOT.jar:/opt/thingmagic/libs/vnd_entities.jar


----------------------------------------------
NRM 10 custom attributes (version >= 10.3)
----------------------------------------------
IMPORTANT! do not override existing files
merge or copy custom_attributes/mixinAssignment.json and custom_attributes/mixinDefinition.json
into the 'persist' subdir of your nrm10 installation path

restart the nrm


----------------------------------------------
Configuration
----------------------------------------------
to change the default values, edit configuration.rb 
VISHOST = 'localhost' # Visionael NRM10 server
VISPORT = 3700 # Visionael NRM10 server port

CARDBOXCHASSISSPEC = 'Cardbox' # 50 slot virtual chassis used to place cards

#readers configuration
DURATION = 500 # the time to spend reading tags, in milliseconds 
REGION = Reader::Region::NA 

READERS = [
  ['FP-bay002-Centigram Cabinet-001', 'tmr://192.168.1.200'],
  ['FP-bay002-System Cabinet-001', 'tmr://192.168.1.201'],
  ['Atlanta Datacenter', 'tmr://192.168.1.202'],  
  ['Sample - Depot Plan', 'tmr://192.168.1.203']
]

SIMULATED = true #used for tests without real reader


----------------------------------------------
Cardbox model creation
----------------------------------------------
Log in into NRM and go to the 'Equiment Library' application
create a new Chassis with the following attributes
name    : Cardbox
vendor  : Spares
subtype : SparePart
width   : 30
depth   : 30
height  : 200
descr.  : Cardbox container for cards

add slots, at least the same number of gear you want to manage
save and publish


----------------------------------------------
RFID tags gear association
----------------------------------------------
Log in into NRM and go to the 'Facilities Designer' application
for each device/card you want to manage set the following attributes:
RFID tag: the tag associated with the device
Slot    : the slot number of the cardbox where the device is going to be moved. Make sure each device goes to a different slot


----------------------------------------------
Test
----------------------------------------------
$ cd thingmagic
$ ./reader.rb #start the readers process


----------------------------------------------
Updates
----------------------------------------------
$ cd thingmagic
$ git pull