-
Language:
English
-
Language:
English
Red Hat Training
A Red Hat training course is available for Red Hat AMQ
Chapter 2. Installation
This chapter guides you through the steps required to install AMQ JavaScript in your environment.
2.1. Prerequisites
To begin installation, use your subscription to access AMQ distribution archives and package repositories.
To use AMQ JavaScript, you must also install and configure Node.js for 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
AMQ JavaScript is distributed as a zip archive. Follow these steps to install it in your environment.
- 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 JBOSS INTEGRATION AND AUTOMATION category.
- Click Red Hat AMQ Clients. The Software Downloads page opens.
- Download the AMQ JavaScript Client zip file.
Use the
unzipcommand to extract the file contents into a directory of your choosing. This will create a new subdirectory callednodejs-rhea-VERSION.$ unzip nodejs-rhea-VERSION.zip Archive: nodejs-rhea-VERSION.zip creating: nodejs-rhea-VERSION/ creating: nodejs-rhea-VERSION/node_modules/ creating: nodejs-rhea-VERSION/node_modules/rhea/ [...]
Configure your environment to use the installed library. Add the
node_modulesdirectory to theNODE_PATHenvironment variable.$ cd nodejs-rhea-VERSION $ export NODE_PATH=$PWD/node_modules:$NODE_PATHTo make this configuration take effect for all new console sessions, set
NODE_PATHin your$HOME/.bashrcfile.Test your installation. The following command will return zero if it can successfully import the installed library.
$ node -e 'require("rhea")'; echo $? 0
2.3. Installing on Microsoft Windows
- 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 JBOSS INTEGRATION AND AUTOMATION category.
- Click Red Hat AMQ Clients. The Software Downloads page opens.
- Download the AMQ JavaScript Client zip file.
-
Extract the file contents into a directory of your choosing by right-clicking on the zip file and selecting Extract All. This will create a new subdirectory called
nodejs-rhea-VERSION. Configure your environment to use the installed library. Add the
node_modulesdirectory to theNODE_PATHenvironment variable.$ cd nodejs-rhea-VERSION $ 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.
$ cd nodejs-rhea-VERSION/node_modules/rhea
$ npm install
$ npm run browserify
This will produce a file called rhea.js that can be used in browser-based applications.