Chapter 2. Installation
Chapter 2. Installation This chapter guides you through the steps to install AMQ JavaScript in your environment. 2.1. Prerequisites You must have a subscription to access AMQ release files and repositories. To use AMQ JavaScript, you must install Node.js in your environment. See the Node.js website for more information. AMQ JavaScript depends on the Node.js debug module. See the npm page for installation instructions. 2.2. Installing on Red Hat Enterprise Linux Procedure Open a browser and log in to the Red Hat Customer Portal Product Downloads page at access.redhat.com/downloads . Locate the Red Hat AMQ Clients entry in the INTEGRATION AND AUTOMATION category. Click Red Hat AMQ Clients . The Software Downloads page opens. Download the AMQ Clients 2.9.0 JavaScript .zip file. Use the unzip command to extract the file contents into a directory of your choosing. USD unzip amq-clients-2.9.0-javascript.zip When you extract the contents of the .zip file, a directory named amq-clients-2.9.0-javascript is created. This is the top-level directory of the installation and is referred to as <install-dir> throughout this document. To configure your environment to use the installed library, add the node_modules directory to the NODE_PATH environment variable. USD cd amq-clients-2.9.0-javascript USD export NODE_PATH=USDPWD/node_modules:USDNODE_PATH To make this configuration take effect for all new console sessions, set NODE_PATH in your USDHOME/.bashrc file. To test your installation, use the following command. It prints OK to the console if it successfully imports the installed library. USD node -e 'require("rhea")' && echo OK OK 2.3. Installing on Microsoft Windows Procedure Open a browser and log in to the Red Hat Customer Portal Product Downloads page at access.redhat.com/downloads . Locate the Red Hat AMQ Clients entry in the INTEGRATION AND AUTOMATION category. Click Red Hat AMQ Clients . The Software Downloads page opens. Download the AMQ Clients 2.9.0 JavaScript .zip file. Extract the file contents into a directory of your choosing by right-clicking on the zip file and selecting Extract All . When you extract the contents of the .zip file, a directory named amq-clients-2.9.0-javascript is created. This is the top-level directory of the installation and is referred to as <install-dir> throughout this document. To configure your environment to use the installed library, add the node_modules directory to the NODE_PATH environment variable. USD cd amq-clients-2.9.0-javascript USD set NODE_PATH=%cd%\node_modules;%NODE_PATH% 2.4. Preparing the library for use in browsers AMQ JavaScript can run inside a web browser. To create a browser-compatible version of the library, use the npm run browserify command. USD cd amq-clients-2.9.0-javascript/node_modules/rhea USD npm install USD npm run browserify This produces a file named rhea.js that can be used in browser-based applications.
unzip amq-clients-2.9.0-javascript.zip cd amq-clients-2.9.0-javascript export NODE_PATH=USDPWD/node_modules:USDNODE_PATH node -e 'require("rhea")' && echo OK OK cd amq-clients-2.9.0-javascript set NODE_PATH=%cd%\node_modules;%NODE_PATH% cd amq-clients-2.9.0-javascript/node_modules/rhea npm install npm run browserify