User manual REDHAT APPLICATION STACK 1.2 RELEASE NOTES

[. . . ] Red Hat Application Stack V. 1. 2 Release Notes 1. 2 ISBN: N/A Publication date: Red Hat Application Stack V. 1. . . Red Hat Application Stack V. 1. 2 Release Notes Copyright © 2006-2007 Red Hat, Inc. Red Hat Application Stack V. 1. . . 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of This Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [. . . ] Failure to do this will result in up2date producing warnings whenever you run up2date again without mounting the Red Hat Application Stack V. 1. 2 DVD. Refer also to Chapter 4, Using JBoss AS below. If you are upgrading from version 1. 1 of Red Hat Application Stack, please note that the "jbossas-ejb3" package has now been obsoleted and it's contents merged into the main jbossas package. An "up2date jbossas" command will upgrade everything correctly. 5 6 Chapter 3. Installing Red Hat Application Stack To install Red Hat Application Stack V. 1. 2: 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. For example, run: su rm -rf /tmp/pg. backup su - postgres /usr/bin/pg_dumpall > /tmp/pg. backup exit Note If you have large objects in the database, you need to use pg_dump instead of pg_dumpall. See http://www. postgresql. org/docs/8. 1/static/largeobjects. html and http://www. postgresql. org/docs/8. 1/static/app-pg-dumpall. html For more information, see http://www. postgresql. org/docs/8. 1/static/install-upgrading. html If you are using MySQL: · Backing-up your database is optional but recommended. Run as root: mysqldump --all-databases -p > /tmp/mysqldumpfile. sql 2. Stop the daemons: · /sbin/service httpd stop · To shut down MySQL: /sbin/service mysqld stop · To shut down PostgreSQL: 7 Chapter 3. Installing Red Hat. . . /sbin/service postgresql stop 3. Install the software: · Option 1. To install from RHN, which is the preferable option to avoid dependency issues, run as root: up2date --installall rhel-i386-as-4-appstk-1 --exclude jbossas-core --exclude jbossas-ejb3 where rhel-i386-as-4-appstk-1 is the channel name for Red Hat Application Stack The channel names are as follows: rhel-arch-variant-4-appstk-1 where: arch = i386 or x86_64 variant = as, or es · Option 2. To install from RPMs on Disk: Follow the instructions in Section 2. 2, " Using up2date / DVD " to mount the DVD and set up the local RHN channel (steps 1-3). Then as root run: up2date --installall RedHat-Application-Stack-V1 Note If you are upgrading from Stacks V. 1. 1, and have installed the jbossas-ejb3 package, before running the above command, you need to first remove jbossas-ejb3 manually by running as root: rpm -e jbossas-ejb3 Note You may need to install the following packages to satisfy dependencies before executing the above command, if they are not already installed: 8 · apr-devel · apr-util-devel · libc-client · mx · pcre-devel 4. 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 · For MySQL: · Start MySQL: /sbin/service mysqld start · Update MySQL: mysql_upgrade 9 Chapter 3. Installing Red Hat. . . · Restore your data: mysql -p < /tmp/mysqldumpfile. sql · Start the http daemon: /sbin/service httpd start The installation is now complete. 10 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. [. . . ] Create a new file /etc/init. d/service-name which is a symlink to /etc/init. d/jbossas, e. g: ln -s /etc/init. d/jbossas /etc/init. d/jbossas-ports-01 2. Create a new config file for service-name, /etc/sysconfig/service-name. The contents of this file should be similar to /etc/sysconfig/jbossas, except with instance specific values 16 Running multiple instances of JBoss AS uncommented and updated, e. g: cp /etc/sysconfig/jbossas /etc/sysconfig/jbossas-ports-01. Uncomment and update JBOSSCONF to ports-01 in /etc/sysconfig/jbossas-ports-01. [. . . ]