This chapter provides JBoss developers with a guide to the QA lab. It covers usage guidelines as well as setup documentation
Use ssh to log into dev02.pub.qa.atl.jboss.com. All of the servers in the Q/A lab have the same public keys and accounts as cvs.jboss.com. If you can't connect, contact it-ops@jboss.com. Dev02 is available for ad-hoc testing by developers and support engineers. No scheduling is required for this box.
To avoid port conflicts with others, bind listeners to your assigned address. Currently, each account has 4 IP addresses available. These are available as environment variables: $MYTESTIP_1,$MYTESTIP_2, $MYTESTIP_3, $MYTESIP_4. For instance:
./run.sh -b $MYTESTIP_1 -c default
You will find assorted tools and JVM's under /opt. If you can't find something you need, please raise the issue on the JBIT project in JIRA.
Each node has a public IP address for services such as SSH and HTTP, in addition to 256 private IP addresses. The local network is Gigabit Ethernet, with connectivity to the public Internet via a DS3.
To prevent port conflicts, each listener/server process must be bound to a specific private IP address. These IP addresses are delineated per node and per user in the /opt/etc/assigned-ips file, available on each machine. Currently, each user is assigned 4 IP addresses per node. These are automatically set as the environment variables $MYTESTIP_1 $MYTESTIP_2, etc. All ports for a given private IP address may be accessed via SSH tunneling.
The /opt and /home directories on each machine are mapped to the corresponding directories on dev01 via NFS. So your home directory is the same on each machine. The /opt directory holds common packages needed across all nodes, preventing unecessary duplication. Under /opt, you will find several useful packages such as:
Many jdks, including IBM, Sun & JRockit
JDBC drivers under /opt/jdbc-drivers
Under /opt/src, several binary & src distros of JBoss
Several versions of Ant
This section documents the available databases in the QA lab, how to start, stop & access them. JDBC drivers are available under /opt/jdbc-drivers.
For sudo acces to sybase & oracle, see "How do I get DB admin access?"
Table 16.1. Available Databases
| Database | Connection URL | Start/Stop | New User |
|---|---|---|---|
| Oracle 10.1.0.3 | jdbc:oracle:thin:@dev01-priv:1521:qadb01 | /etc/init.d/dbora start|stop | $ sudo su - oracle $ export ORACLE_SID=qadb01 $ sqlplus "/ as sysdba " CREATE USER your_username_here IDENTIFIED BY your_password_here DEFAULT TABLESPACE users TEMPORARY TABLESPACE temp QUOTA UNLIMITED ON users; GRANT DBA to your_username_here; |
| MySQL 4.1.10a | jdbc:mysql://dev01-priv/your_database_here | /etc/init.d/mysql.server start|stop | $ /opt/mysql/bin/mysql -u qa -h qadb01 -p Enter password: #request from JBIT in JIRA GRANT ALL PRIVILEGES ON your_db_here.* TO 'your_username_here'@'%' IDENTIFIED BY 'your_password_here'; flush privileges; create database your_database_here; |
| Sybase ASE 12.5.2 | jdbc:sybase:Tds:dev01-priv:4100 | sudo su - sybase startserver -f \ ~/sybase/ASE-12_5/install/RUN_sybase01 #stop sudo su - sybase isql -Usa -P -Ssybase01 shutdown go | $ sudo su - sybase $ isql -Usa -P -Ssybase01 sp_addlogin "yourusernamehere", "yourpasswordhere" go create database yourdbhere go use yourdbhere go sp_changedbowner yourusernamehere go |
This section lists the available servers and their configurations. We can move between Windows/SLES/RHEL very quickly. Please ask if you need a different OS. All servers have the domain name of dev??.pub.qa.atl.jboss.com.
Table 16.2. Available Servers
| Host | Purpose | OS | CPU | Memory |
|---|---|---|---|---|
| dev01 | Database/NFS server | RHEL 3/2.4 Kernel | 2 x 3.06 GHz P4 Xeon | 4GB |
| dev02 | General usage | RHEL 3/2.4 Kernel | 2 x 3.06 GHz P4 Xeon | 2GB |
| dev03 | General usage | RHEL 3/2.4 Kernel | 2 x 3.06 GHz P4 Xeon | 2GB |
| dev04 | General usage | SLES 9/2.6 Kernel | 2 x 3.06 GHz P4 Xeon | 2GB |
| dev05 | Cruisecontrol - no general access | RHEL 3/2.4 Kernel | 2 x 3.06 GHz P4 Xeon | 2GB |
| dev07 | General usage | RHEL 4/2.6 Kernel/64 bit | 2 x 1.4 GHz IA-64 Itanium 2 | 2GB |
| dev08 | General usage | RHEL 4/2.6 Kernel/64 bit | 2 x 1.4 GHz IA-64 Itanium 2 | 2GB |
| dev12 | General usage | Solaris 8 | 2 x 1.2HGz Sun V210 | 4GB |
| dev13 | General usage | Solaris ? | 2 x 1.8GHz Sun V20z | |
| dev14 | General usage | RHEL 4/2.6 Kernel/64 bit | 1 x 1.5 GHz IA-64 Itanium 2 | 4 GB |
| dev15 | General usage | RHEL 4/2.6 Kernel/64 bit | 1 x 1.5 GHz IA-64 Itanium 2 | 4 GB |
| dev16 | SPECJ | RHEL 4/2.6 Kernel/64 bit | 2 x 3.6 GHz Xeon EM64T | 4 GB |
| dev17 | SPECJ | RHEL 4/2.6 Kernel/64 bit | 2 x 3.6 GHz Xeon EM64T | 4 GB |
| dev18 | General usage | RHEL 4/2.6 Kernel/64 bit | 4 x 1.5 GHz IA-64 Itanium 2 | 4 GB |
| dev19 | General usage | RHEL 4/2.6 Kernel/64 bit | 4 x 1.5 GHz IA-64 Itanium 2 | 4 GB |
How should I run the testsuite in the QA Lab?
./build.sh tests -Dnode0=$MYTESTIP_1 -Dnode1=$MYTESTIP_2
I'm getting port conflicts, how do I fix this?
sudo /usr/sbin/lsof -i -P | grep 1099
This should display who has JBoss instances running. If they have not bound to their private IP address, it will conflict even if you are doing so.
How do I get DB admin access?
On dev01, check to see if you are in the oracle_admin group:
$ groups
If you don't see oracle_admin listed, open a JIRA issue in the JBIT project requesting access to this group.
How do I add disk space for Sybase?
Get into the isql prompt as above, and
disk resize name="master", size="200M" go