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

Ubuntu
$ sudo apt-get 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
easy install; download the binaries, unpack and update your $PATH

4) soap4r - implements SOAP 1.1
$	sudo jruby -S gem install jruby-openssl
$ sudo jruby -S gem install soap4r


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

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


----------------------------------------------
NRM 10 custom attributes (version >= 10.3)
----------------------------------------------
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 server_configuration.rb (do not touch METHODS)
NAMESPACE = 'http://mysite.org/wsdl/InventoryMgmt'
HOST = 'localhost' # webservice host
PORT = 2000 # webservice port
VISHOST = HOST # Visionael NRM10 server
VISPORT = 3700 # Visionael NRM10 server port
SPAREDEVSPEC = 'SparePart'

METHODS=[
	%w(FindDevice name),
	%w(CheckIn user_id date serial_number part_number vendor_part_number depot_string),
	%w(CheckOut user_id date serial_number part_number vendor_part_number depot_string asset_tag facebook_part_number failed_part_rma),
	%w(CaptureFailedPart user_id date serial_number part_number vendor_part_number depot_string asset_tag facebook_part_number rma parent_serial_number parent_asset_tag),
	%w(RMA user_id date serial_number part_number vendor_part_number depot_string asset_tag facebook_part_number rma carrier_name carrier_traking_number)
]


----------------------------------------------
Spares model creation
----------------------------------------------
Log in into NRM and go to the 'Equiment Library' application
create a new Chassis with the following attributes
name    : SparePart
vendor  : Spares
subtype : SparePart
width   : 30
depth   : 30
height  : 10
descr.  : Spare part model used by the Aricent demo


----------------------------------------------
Test
----------------------------------------------
$ cd aricent
$ ./server.rb #start the webservice

$ ./client_find_device 'Cisco 12410 Router' # this device is in the nmr10 sample repository

$ ./client_stubs.rb # call the stubs methods defined in the nrm8 version of the facebook application

$ ./client_checkin.rb # call the checkin method. edit the file to change the parameters. 


----------------------------------------------
Updates
----------------------------------------------
I have setup a notification email to [email protected] everytime I make changes to the code.
To update your local copy execute:
$ cd aricent
$ git pull