To use the McAfee Active Response (MAR) DXL Node-RED client package, the following prerequisites must be satisfied:
Node-RED must be installed.
For more information on other Node-RED installation approaches, see https://nodered.org/docs/getting-started/installation.
Note: In order to be able to import examples properly from the Node-RED UI, version 0.18.0 or newer of Node-RED should be installed.
The OpenDXL Node-RED core package must be installed in Node-RED.
Note: If you use the OpenDXL Node-RED Docker image, the OpenDXL Node-RED core package should be installed automatically on the first run of the Docker container.
McAfee Active Response Server installed and available on DXL fabric
DXL client has been configured in Node-RED.
Node-RED DXL client has permission to perform MAR searches.
Node.js 4.0 or higher installed.
The MAR DXL Node-RED client package can be installed via the following approaches:
With this approach, the MAR DXL Node-RED client package is installed from within Node-RED itself. See the Node-RED Based Installation section below for more information.
Command Line Installation
With this approach, the MAR DXL Node-RED client package is installed via npm from the command-line on the host where the Node-RED server is running. See the Command Line Installation section below for more information.
Node-RED Based Installation
Browse to your Node-RED server.
In the upper-right corner, press the side menu button.
Manage paletteoption in the menu drop-down list.
Paletteuser settings tab, click on the
search modulestext box, enter
Next to the entry for
@opendxl/node-red-contrib-dxl-mar-clientin the search results, press the
Installingconfirmation dialog, press the
A dialog containing text like the following should appear when the installation is complete:
Nodes added to palette: * dxl-mar...
Click on the
Closebutton to close the
Command Line Installation
Before installing the MAR DXL Node-RED client package, first navigate in a
command shell to the user directory which you have configured for Node-RED. The
.node-red directory under the user's
HOME directory is the default user
directory for Node-RED.
For Mac and Linux-based operating systems, run the following command:
For Windows, run the following command:
To install the library from a local tarball for a Mac or Linux-based operating system, run the following command:
npm install ./lib/opendxl-node-red-contrib-dxl-mar-client-0.1.0.tgz --save
To install the library from a local tarball for Windows, run:
npm install .\lib\opendxl-node-red-contrib-dxl-mar-client-0.1.0.tgz --save
To install the library via the npm package registry, run the following command:
npm install @opendxl/node-red-contrib-dxl-mar-client --save
After the installation is complete, restart Node-RED and browse to your Node-RED server.
Confirming the Installation Result
After the installation is complete, you should see a
mar search node in the
For more information, see the Node-RED Configuration documentation.