Follow below steps to get started with the meshIQ setup.
Before running this procedure, please verify the prerequisites below.
Prerequisites
Linux System:
- Operating System: Linux 64 bit OS
- CPU: Minimum 8 virtual CPUs
- Memory: Minimum 32GB RAM
- File System: Minimum 100 GB free space, SSD preferred
- Recommended Install folder: /opt/meshiq
- Required: Dedicated Server Instance
Some steps below require root access.
- USERID:
Create the Linux user ID (UID) and group which will be used to start all meshIQ services.
The Recommended user and group are meshiq:meshiq, this can be changed to any preferred user product owner.
The UID and group must own all files and directories under $APIN_HOME
- SWAP:
It is highly recommended to turn Swap off within the operating system on all virtual machine servers running meshIQ Track.
To disable swap, perform the following:
a) Identify configured swap devices and files with the following command:
cat /proc/swaps
b) Turn off all swap devices and files with the following command:
/swapoff -a
c) Comment out any swap matching references found in /etc/fstab.
- LIMITS:
Modify /etc/security/limits.conf and add below for your user:
Replace meshiq with the user that will start Track processes.
meshiq soft nofile 65536 meshiq hard nofile 65536
meshiq soft nproc 65536
meshiq hard nproc 65536
- SOFTWARE REQUIREMENTS:
Ensure 'curl' is installed, curl is required to run sbin/config.shscript
Ensure 'python' version >= 2.7 is installed, If planning to run STORM or Machine Learning.
Ensure native 'PostgreSQL' is not running, Installation using its own PostgreSQL database implementation.
As of version 1.3, platform requires Structured Query database server to run job scheduler.
This meshIQ Deployment pack is pre-configured to use PostgreSQL database as default and requires to run Track.
- NETWORK PORTS:
The following list contains all processes network ports that are involved in meshIQ deployment.
DOMAIN SERVER (ATPNAMES): .............2323, 3000 (TCP)
CEP SERVER (ATPNODE): ................ 3005 (TCP)
STREAMING: ........................... 6585 OR HTTPS(443) (TCP)
WEB SERVER (apache-tomcat): .......... 443, 8080 (TCP)
ZOOKEEPER: ........................... 2181 (TCP)
ACTIVEMQ SERVER: ..................... 61616 (TCP)
ACTIVEMQ WEB CONSOLE: ................ 8161 (TCP)
KAFKA SERVER: ........................ 9092 (TCP)
SOLR: ................................ 8983 (TCP)
POSTGRESQL (postgres): ............... 5432 (TCP)
WORKGROUP SERVER: .................... 4010 (TCP & UDP)
REST API: ............................ 8019 (TCP)
STREAMING: ........................... 6585 OR HTTPS(443) (TCP)
STREAMING: ........................... 6585 OR HTTPS(443) (TCP)
MQ AGENT JAVA (nsqcmmq.jar): ......... 5015 (TCP & UDP)
MQ CONNECTION MANAGER (nsqcmmq.jar): ............ 5025 (TCP)
IBM Listeners: --------- 1414 (TCP)
IIB/ACE CONNECTION MANAGER (nsqcmace.jar): ...... 5577 (TCP)
IIB/Ace node: ---------- 4414 (TCP)
EMS CONNECTION MANAGER (nsqcmems.jar) ........... 5556 (TCP)
Tibco EMS URL: --------- 7222 (TCP)
KAFKA CONNECTION MANAGER (nsqcmkafka.jar) ....... 5566 (TCP)
Kafka Server: ---------- 9092 (TCP)
SOLACE CONNECTION MANAGER (nsqcmsolace.jar) ..... 5588 (TCP)
Solace URL PORT: ------- 8980 (TCP)
RABITMQ CONNECTION MANAGER (nsqcmrabbitmq.jar) .. 5599 (TCP)
RabitMQ URL PORT: ------- 15672 (TCP)
The machine on which the install will be done respects all prerequisites for installation described above.
For more information and to get started, please refer to the URL link:
https://customers.meshiq.com/hc/en-us/categories/360002068774
https://customers.meshiq.com/hc/en-us/categories/360002083773
Setup Steps:
These steps assume local installation for all related components.
You only need first 3 steps below to get everything configured and up and running.
1. Untar/unzip the meshIQ_x.x.x_Full_DPackVx.x.tar.Z package to the installation path of your choice.
This package contains the directory "meshiq" as a root directory
SHELL COMMAND: tar -zxvf meshIQ_x.x.x_Full_DPackVx.x.tar.Z
2. REVIEW, VERIFY AND ENABLE/DISABLE LOCAL RUNNING SERVICES:
Change to $APIN_HOME/sbin/ folder and modify file "installed_services.conf"
"yes" for enabled and "no" for disabled.
syntax: Service_Name=yes (with no spaces)
3. TO START THE MANAGE SERVICES, AND FOR INITIAL SETUP:
Run below command from APIN_HOME/sbin/ directory and follow on screen instructions.
SHELL COMMAND: cd APIN_HOME/sbin
SHELL COMMAND: ./start.sh all
Press enter key to set the install path automatically.
First time command run will ask you to specify untared/unzipped directory location, after which you will need to re-run command ./start.sh all.
YOU HAVE COMPLETED THE INSTALLATION, please check $APIN_HOME/logs for any errors.
Setting the installation path (Optional)
To run startup scripts from anywhere, it is recommended to set APIN_HOME and PATH to sbin directory in user profile.
Copy and paste these two lines towards the end of the user profile file.
export APIN_HOME=/opt/meshiq
export PATH=$PATH:$APIN_HOME/sbin
Change /opt/meshiq to the path of root directory of meshiq installation
Set the installation path manually ( OPTIONAL)
To set working path manually, Edit APIN_HOME/sbin/apin_env.sh
Change line: export APIN_HOME=ExistingPath and replace it with NewPath.
To access the meshIQ manage UI from a web browser, use the following address:
http://<serverip>:8080/manage/
Use the following default log in credentials:
- User Name: Admin (case sensitive)
- Password: admin (case sensitive)
To access the meshIQ track UI from a web browser, use the following address:
http://<serverip>:8080/track/login.jsp
Use the following default log in credentials:
- User Name: Admin (case sensitive)
- Password: password that was set during the deployment
Streaming Data to TRACK:
In order to stream data to Track, a token id is needed.
DEFAULT TOKEN ID: DefaultToken
DEFAULT STREAM URL: http://<serverip>:6580
If you are new to meshIQ Platform, to get started it is recommended to check out this web page:
https://customers.meshiq.com/hc/en-us/categories/360002068774
https://customers.meshiq.com/hc/en-us/categories/360002083773