Unpack it into $JBOSS_HOME. This should create a $JBOSS_HOME/bin/META-INF directory with a series of subdirectories.
Or do what I do - unpack it to a temporary location and copy the META-INF directory to $JBOSS_HOME/bin.
must I change anything else so that jboss recognizes that there are libaries in this directory ?
I think I am going to have to retract some of my earlier answer. Why? Because I was going to tell you that the run scripts already automatically look for, and take into account, the JBoss Native files. While that statement is true, the details have changed.
Looking at the run scripts for 4.2.x, they all assume that JBoss Native installs into directory bin/native. JBoss 5.0.0.CR2, on the other hand, assumes JBoss Native installs into bin/META-INF.
Looking at JBoss Native 2.0.1, it contains the bin/native directory. However, 2.0.4 and 2.0.5 contain bin/META-INF. I don't have 2.0.2 or 2.0.3 on my system (and am too lazy to download them at this time), so I do not know exactly in which version the directory structure changed.
So now my advice is: if you are using JBossAS 5.0, use JBoss Native 2.0.5 (or 2.0.4). If you are using JBossAS 4.2.x, use the latest version of JBoss Native 2.0.x that uses the old (bin/native) directory structure. If you do that, the the run scripts will properly reference the native libraries.
but is there an offical statement when to use which version (I'm using jboss 4.2.2.) ?
is there an offical statement when to use which version
Not that I have ever seen - as you pointed out there is not even any readme or installation document that comes with the software. The only docs I know of are these wiki pages:
and they don't give any version numbers. Your best bet is to go with my guidelines.