BitNami JBoss Stack 7.1.1-3 ============================ 1. OVERVIEW The BitNami Project was created to help spread the adoption of freely available, high quality open source web applications. BitNami aims to make it easier than ever to discover, download and install Open Source software such as document and content management systems, wikis and blogging software. You can learn more about BitNami at http://bitnami.com The BitNami JBoss Infrastructure Stack is an installer that greatly simplifies the installation of Roller and runtime dependencies. It includes ready-to-run versions of Apache, JBoss, MySQL and Java. It is distributed for free under the Apache 2.0 license. Please see the appendix for the specific licenses of all Open Source components included. You can learn more about BitNami Stacks at http://bitnami.com/stacks/ 2. FEATURES - Easy to Install BitNami Stacks are built with one goal in mind: to make it as easy as possible to install open source software. Our installers completely automate the process of installing and configuring all of the software included in each Stack, so you can have everything up and running in just a few clicks. - Independent BitNami Stacks are completely self-contained, and therefore do not interfere with any software already installed on your system. For example, you can upgrade your system's MySQL or JBoss without fear of 'breaking' your BitNami Stack. - Integrated By the time you click the 'finish' button on the installer, the whole stack will be integrated, configured and ready to go. - Relocatable BitNami Stacks can be installed in any directory. This allows you to have multiple instances of the same stack, without them interfering with each other. 3. COMPONENTS BitNami JBoss Stack ships with the following software versions: - Apache 2.4.3 - JBoss 7.1.1 - MySQL 5.5.29 On Linux and Windows there are two versions of the stack, with and without a bundled JDK 1.7.0_15. On OS X, it is required that you have Java 1.5 or later installed in your system. It can be downloaded from http://www.apple.com/macosx/features/java/ 4. REQUIREMENTS To install BitNami JBoss Stack you will need: - Intel x86 or compatible processor - Minimum of 512 MB RAM - Minimum of 400 MB hard drive space - TCP/IP protocol support - Compatible operanting systems: - An x86 or x64 Linux operating system. - A 32-bit Windows operating system such as Windows 2000, XP, Vista, 7, 2008 or Windows Server 2003. - An OS X operating system with J2SE 5.0 or later. 5. INSTALLATION The BitNami JBoss Stack is distributed as a binary executable installer. It can be downloaded from: http://bitnami.com/stacks/ The downloaded file will be named something similar to: bitnami-jboss-7.1.1-3-linux-installer.run on Linux or bitnami-jboss-7.1.1-3-linux-x64-installer.run on Linux x64 or bitnami-jboss-7.1.1-3-windows-installer.exe on Windows or bitnami-jboss-7.1.1-3-osx-x86-installer.dmg on OS X x86. On Linux, you will need to give it executable permissions: chmod 755 bitnami-jboss-7.1.1-3-linux-installer.run on Linux To begin the installation process, invoke from a shell or double-click on the file you have downloaded, and you will be greeted by the 'Welcome' screen. Next you will be asked to choose the installation folder. If the destination directory does not exist, it will be created as part of the installation. The default listening port for Apache is 8080 and for MySQL is 3006. If those ports are already in use by other applications, you will be prompted for alternate ports to use. The next screen will ask you for a password. This password will be used to protect the MySQL root account. The default listening port for JBoss are 8009 for the AJP Connector, 9990 for the JBoss Management Web Console and 9999 for the JBoss Management command line Console. If those ports are already in use by other applications, you will be prompted for alternate ports to use. A new screen will ask you for the username and password for accessing the JBoss Administration Console. If the installer has not been able to find a suitable JDK installation in your system, you will have to provide the location of a jdk1.5 or jdk1.6 installation in the next page. Once the installation process has been completed, you will see the 'Installation Finished' page. You can choose to launch BitNami JBoss Stack at this point. If you do so, your default web browser will point you to the BitNami local site. If you receive an error message during installation, please refer to the Troubleshooting section. The Apache server is connected to the JBoss server using the AJP connector. The rest of this guide assumes that you installed BitNami JBoss Stack in /home/user/jboss-7.1.1-3 on Linux or C:\JBoss-7.1.1-3 on Windows or /Applications/jboss-7.1.1-3 on OS X and you use port 8080 for Apache and 3306 for MySQL. 6. STARTING AND STOPPING BITNAMI JBOSS STACK The BitNami Application Manager is a simple graphical interface included in the stacks that can start and stop the BitNami servers. It is are located in the same installation directory. To start the utility, double click the file named ‘manager-linux’, 'manager-windows' or 'manager-osx' from your file browser. Alternatively, you can also start and stop the services manually, as explained below. To start/stop/restart application on Linux or OS X you can use the included ctlscript.sh utility, as shown below: ./ctlscript.sh (start|stop|restart) ./ctlscript.sh (start|stop|restart) apache ./ctlscript.sh (start|stop|restart) mysql ./ctlscript.sh (start|stop|restart) jboss start - start the service(s) stop - stop the service(s) restart - restart or start the service(s) You can start and stop BitNami JBoss Stack on Windows using the shortcuts created in the Start Menu, under Programs -> BitNami -> BitNami Service That will start Apache, JBoss and MySQL services. Once started, you can open your browser and access the following URL: http://127.0.0.1:8080 To access the JBoss Admin Console you can open your browser and access the following URL: http://:9990/console In Virtual Appliances you will need to configure the firewall to allow access to port 9990 if you want to allow access to the JBoss Management Web Console. http://wiki.bitnami.com/Virtual_Appliances_Quick_Start_Guide#How_to_configure_the_Firewall.3f For Amazon Images you will need to add this port to the Security Group. 7. DIRECTORY STRUCTURE The installation process will create several subfolders under the main installation directory: apache2/: Apache server. jboss/: JBoss Web server. java/: Java SE Development Kit. mysql/: MySQL Database. 8. DEFAULT USERNAMES AND PASSWORDS MySQL admin user is called 'root', and its password is also one you set at installation time. The JBoss Administration Console tool, the default username is "manager" and the password is the same that you set during the installation. 9. TROUBLESHOOTING You can find more information about this product at: http://wiki.bitnami.com We also encourage you to post your questions and suggestions at: http://answers.bitnami.com We also encourage you to sign up for our newsletter, which we'll use to announce new releases and new stacks. To do so, just register at: http://bitnami.com/newsletter. 9.1 Installer # Installer Payload Error If you get the following error while trying to run the installer from the command line: "Installer payload initialization failed. This is likely due to an incomplete or corrupt downloaded file" The installer binary is not complete, likely because the file was not downloaded correctly. You will need to download the file and repeat the installation process. # Installer execution error on Linux If you get the following error while trying to run the installer: "Cannot open bitnami-jboss-7.1.1-3-linux.run: No application suitable for automatic installation is available for handling this kind of file." In some operatings systems you can change permissions with right click -> properties -> permissions -> execution enable. Or from the command line: $ chmod 755 bitnami-jboss-7.1.1-3-linux.run # Customize application on Linux or on OS X If you want to reduce application delay, you can change jboss/bin/setenv.sh by replacing this line: JAVA_OPTS="$JAVA_OPTS -XX:MaxPermSize=768m -Xmx768m" with export JAVA_OPTS="-XX:MaxPermSize=1024m -Xmx1024m" 9.2 JBoss BitNami JBoss Stack configures JBoss to run in standalone mode. If you find any problem starting JBoss, the first place you should look at is the error log file that will be created at jboss-7.1.1-3/jboss/standalone/log/jboss.out. There you will likely find useful information to determine what the problem is. For issues not covered in this Quick Start guide, please refer to the BitNami forums and to the JBoss documentation, which is located at http://www.jboss.org/jbossas/docs/7-x The JBoss Management Web Console doesn't work properly in Microsoft Explorer. 9.3 MySQL If you encounter any problems starting MySQL, the first place to look in is the "Problems and Common Errors" section of the MySQL manual, which you will find at http://dev.mysql.com/doc/ The following are some common problems: # Access denied when trying to connect to MySQL. If you get an Access Denied message while trying to connect to MySQL, make sure you are using the correct username and password. # "Can't connect to server" message. Make sure that the MySQL daemon is up and running. Remember also that if during installation you selected a different listening port for MySQL, you may need to pass that as an extra command line option. 10. LICENSES JBoss is distributed under the GNU Lesser General Public License (LGPL), which is located at http://docs.jboss.org/jbossas/admindevel326/html/apa.html MySQL is distributed under the GNU General Public License v2, which is located at http://www.gnu.org/licenses/old-licenses/gpl-2.0.html Java and related libraries are distributed under the Common Development and Distribution License (CDDL), Version 1.0 and the Sun Microsystems, Inc. ("Sun") Software License Agreement, wich are located at http://java.sun.com/j2se/1.5.0/docs/relnotes/license.html