User manual REDHAT APPLICATION STACK 1.1 RELEASE NOTES

[. . . ] Red Hat Application Stack V. 1. 1 Release Notes 1. 1 ISBN: N/A Publication date: Red Hat Application Stack V. 1. . . Red Hat Application Stack V. 1. 1 Release Notes Copyright © 2006-2007 Red Hat, Inc. Red Hat Application Stack V. 1. . . 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of This Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [. . . ] Mount the Red Hat Application Stack V. 1. 1 DVD. Add the following line to /etc/sysconfig/rhn/sources to use up2date directly on the RPMs on the disk: dir RedHat-Application-Stack-V1 path_to_mounted_DVD/RedHat/RPMS 4. Install JBoss AS: · For the Application Server (which includes an embedded Tomcat), run: up2date jbossas 5. After the installation is complete, remove the line you added to /etc/sysconfig/rhn/sources in Step 3. Failure to do this will result in up2date producing warnings whenever you run up2date again without mounting the Red Hat Application Stack V. 1. 1 DVD. Refer also to Chapter 4, Using JBoss AS below. Red Hat Application Stack V. 1. 1 includes two versions of JBossAS. The package 'jbossas' will function with both 1. 4 and 5 JVMs. The package 'jbossas-ejb3' includes a technology preview of EJB3 (1. 0. 0-RC9) and requires a working Java 5 installation. Only one version may be installed at a time. If you are upgrading from version 1 of Red Hat Application Stack and want to install the EJB3 package you must uninstall the 'jbossas' package first, and install a Java 5 JVM. Note Please note that in order to use EJB3 ('jbossas-ejb3') you will need a working Java 1. 5 installation. 'jbossas' can be used with 1. 4. 2 as before. 7 8 Chapter 3. Installing Red Hat Application Stack To install Red Hat Application Stack V. 1. 1: 1. If you have an existing database, back up your data and shut down the database: If you are using PostgreSQL: · Back-up your database. Restore your database: · For PostgreSQL: · Move (or remove) the database directory: mv /var/lib/pgsql/data /var/lib/pgsql/data. backup · Start the new PostgreSQL service: /sbin/service postgresql start · Restore your data from back-up psql -U username < /tmp/pg. backup · Start the http daemon: /sbin/service httpd start 11 Chapter 3. Installing Red Hat. . . · For MySQL: · Update MySQL: mysql_update · Start MySQL: /sbin/service mysqld start · Restore your data: mysql -p < /tmp/mysqldumpfile. sql · Start the http daemon: /sbin/service httpd start The installation is now complete. 12 Chapter 4. Using JBoss AS 1. Using the Linux service (production) JBoss AS can be started, stopped, and configured to start automatically at boot time either from the command line or using a graphical tool. You can start and stop the jbossas service using the service command as root on a console window (as is typical of a network service): service jbossas start . . . service jbossas stop The behavior at boot can be controlled with the chkconfig command, as any other Linux service (see chkconfig man page). Alternatively, you can issue the command system-config-services to activate the graphical Red Hat Service Configuration Tool, which can also be activated from the main menu. Select: System Settings > Server Settings > Services Note For security purposes, beginning with Red Hat Application Stack V. 1. 1, authentication for the jmx-console, web-console, jmx-invoker and http-invoker is turned on. Additionally, no user accounts are active by default, so as to prevent default user / password based attacks. · Accounts for the jmx-console and the invokers can be set up by modifying: $JBOSS_HOME/server/$CONFIG/conf/props/jmx-console-users. properties · Accounts for the web-console users can be set up by modifying: $JBOSS_HOME/server/$CONFIG/deploy/management/console-mgr. sar /web-console. war/WEB-INF/classes/web-console-users. properties Please note that the file name above has been split onto two lines for readability. It should be understood and entered as one continuous line. [. . . ] Create a new config file for service-name, /etc/sysconfig/service-name with instance specific values uncommented and updated , e. g: cp /etc/sysconfig/jbossas /etc/sysconfig/jbossas-instance2. Uncomment and update JBOSSCONF to instance2. Create a new variable JBOSS_IP and set it to another IP address in /etc/sysconfig/jbossas-instance2 3. Then add service-name for management by chkconfig, e. g: chkconfig --add jbossas-instance2 4. [. . . ]