Red Hat Jboss Web Server 3.1 Installation Guide
Total Page:16
File Type:pdf, Size:1020Kb
Red Hat JBoss Web Server 3.1 Installation Guide Install and Configure Red Hat JBoss Web Server 3.1 Last Updated: 2021-04-14 Red Hat JBoss Web Server 3.1 Installation Guide Install and Configure Red Hat JBoss Web Server 3.1 Legal Notice Copyright © 2021 Red Hat, Inc. The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/ . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates. XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners. Abstract This book contains information related to installation and basic configuration of Red Hat JBoss Web Server. Table of Contents Table of Contents .C . H. .A . P. .T .E . R. 1.. .I .N . T. .R .O . .D . U. .C . T. .I O. N. .4 . 1.1. ABOUT RED HAT JBOSS WEB SERVER 4 1.2. COMPONENTS 4 1.3. SUPPORTED OPERATING SYSTEMS AND CONFIGURATIONS 4 1.4. INSTALLATION METHODS 5 1.5. UPGRADING JBOSS WEB SERVER 5 1.6. COMPONENT DOCUMENTATION BUNDLE 5 .C . H. .A . P. .T .E . R. 2. I.N . .S .T . A. .L . L. .I N. .G . .J . B. .O . S. .S . .W . .E . B. S . E. .R . V. .E .R . .O . .N . .R . E. .D . .H . A. .T . .E .N . .T .E . R. .P . R. .I S. E. L. .I N. .U . X. 6. 2.1. PREREQUISITES 6 2.1.1. Installing a Java Development Kit (JDK) 6 2.1.2. Red Hat Enterprise Linux Package Prerequisites 7 2.2. ZIP INSTALLATION 7 2.2.1. Downloading and Extracting JBoss Web Server 7 2.2.2. Configuring the JBoss Web Server Installation 8 2.2.3. Starting JBoss Web Server 9 2.2.4. Stopping JBoss Web Server 10 2.3. RPM INSTALLATION 10 2.3.1. Installing JBoss Web Server from RPM packages 11 2.3.2. Installing the JBoss Web Server Plus Group 12 2.3.3. Starting JBoss Web Server 12 2.3.4. Stopping JBoss Web Server 13 2.3.5. Configuring JBoss Web Server Services to Start at Boot 13 2.4. SELINUX POLICIES 14 2.4.1. SELinux Policy Information 14 2.4.2. SELinux Policies for an RPM Installation 14 2.4.3. SELinux Policies for a ZIP Installation 14 .C . H. .A . P. .T .E . R. 3. I. N. .S . T. A. .L . L. .I N. .G . J . B. .O . .S .S . .W . .E . B. S. E. .R . V. .E . R. O . .N . .M . .I C. .R . O. .S . O. F. T. W. I.N . D. O. .W . .S . 1.6 . 3.1. INSTALLING A JAVA DEVELOPMENT KIT (JDK) 16 3.2. DOWNLOADING AND EXTRACTING JBOSS WEB SERVER 16 3.3. CONFIGURING THE JBOSS WEB SERVER INSTALLATION 16 3.4. STARTING JBOSS WEB SERVER 18 3.5. STOPPING JBOSS WEB SERVER 19 .C . H. .A . P. .T .E . R. 4. .I N. .S . T. .A .L . L. .I N. .G . J. B. .O . .S .S . .W . .E . B. S. .E .R . V. .E . R. O. .N . .S . O. .L . A. .R . I.S . .2 . 0. 4.1. INSTALLING A JAVA DEVELOPMENT KIT (JDK) 20 4.2. DOWNLOADING AND EXTRACTING JBOSS WEB SERVER 20 4.3. CONFIGURING THE JBOSS WEB SERVER INSTALLATION 21 4.4. STARTING JBOSS WEB SERVER 22 4.5. STOPPING JBOSS WEB SERVER 22 .C . H. .A . P. .T .E . R. 5. U. .S . I.N . .G . .J . S. V. .C . T . O. .S .T . A. .R . T. T. O. M. C. .A . T. .2 . 3. 5.1. STARTING TOMCAT USING JSVC 23 5.2. STOPPING TOMCAT USING JSVC 23 5.3. JSVC PARAMETERS 24 .C . H. .A . P. .T .E . R. 6. .H . I.B . E. .R .N . .A . T. E. O. N. J. .B .O . .S . S. .W . .E . B. S. .E .R . V. .E . R. .2 . 5. .C . H. .A . P. .T .E . R. 7. M. O. N. .I T. .O . R. .I N. G. J. .B . O. .S . S. .W . .E . B. S. .E . R. V. .E . R. W. I.T . H. J. .B . O. .S . S. O . .P . E. .R .A . T. .I O. N. .S . .N . E. .T .W . .O . .R . K. ( .O . .N . ). .2 . 7. 7.1. DOWNLOADING THE WEB SERVER PLUGIN PACK FOR JBOSS ON 27 7.2. CONFIGURING TOMCAT FOR JBOSS ON MONITORING 27 7.2.1. Configuring JBoss ON Monitoring for Tomcat Installed from RPMs 29 1 Red Hat JBoss Web Server 3.1 Installation Guide 7.2.2. Configuring JBoss ON Monitoring for Tomcat Installed as a Windows Service 30 .C . H. .A . P. .T .E . R. 8. .U . S. I. N. .G . .A . .P . A. .S . S. W. O. R. .D . .V . A. .U . L. .T . W. I.T . H. R. .E . D. H. .A . T. J. .B .O . .S . S. .W . .E . B. S. .E .R . V. .E . R. 3. .3 . 2. 8.1. USING A PASSWORD VAULT WITH RED HAT JBOSS WEB SERVER 3 32 8.1.1. Installing the JBoss Web Server password vault 32 8.1.1.1. Installing the JBoss Web Server password vault on Red Hat Enterprise Linux from an RPM 32 8.1.1.2. Downloading and Extracting the Vault Files from a .zip archive 32 8.1.2. Creating a Java Keystore 33 8.1.3. Storing the tomcat-vault vault.properties file outside of the JWS_HOME directory 33 8.1.4. Initializing the Password Vault 33 8.1.4.1. Initializing the Vault for Apache Tomcat interactively 34 Configuring Tomcat to Use the Password Vault 35 8.1.4.2. Initializing the Vault for Apache Tomcat non-interactively (silent setup) 35 8.1.5. Storing a Sensitive String in the Password Vault 35 8.1.6. Using a Stored Sensitive String in Your Tomcat Configuration 36 .C . H. .A . P. .T .E . R. 9. .C . O. .N . F. .I G. U. .R . I.N . G. J. .W . .S . .C . L. .I E. N. T. -. S. .E . R. .V . E. R. C. .O . .M . .M . U. .N . .I C. .A . T. .I O. .N . W. .I .T .H . W. E. B. .S . O. .C . .K .E . T. .3 . 7. 9.1. ABOUT WEBSOCKET 37 9.2. IMPLEMENTING WEBSOCKET ON TOMCAT 37 9.2.1. Configuring Write Timeout 37 9.2.2. Configuring Incoming Binary Messages 37 9.2.3. Configuring Incoming Text Messages 38 9.2.4. Configuring Additional Programmatic Deployment 38 9.2.5. Configuring Callbacks for Asynchronous Writes 38 9.2.6. Configuring Timeout for IO Operations While Establishing the Connections 38 .A .P . P. .E . N. .D . I. X. A . .J .A . V. .A . .I P. .V . 4. ./ .I P. .V . 6. P. .R .O . .P . E. .R .T . I.E . S. .4 .0 . ..