Follow the steps below to get started with meshIQ Platform Simple Edition.
Please verify the prerequisites before beginning installation.
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 that will be used to start all meshIQ services.
The recommended user and group are meshiq:meshiq. This can be changed to any product owner user account.
The UID and group must own all files and directories under $APIN_HOME.
- SWAP:
We highly recommend that you 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 the lines 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 that 'curl' is installed. Curl is required to run the sbin/config.sh script.
Ensure that 'python' version >= 2.7 is installed, if you are planning to run Apache Storm or Machine Learning.
Ensure that native 'PostgreSQL' is not running as an installation using its own PostgreSQL database implementation.
As of version 1.3, the platform requires a Structured Query database server to run the job scheduler. This meshIQ Deployment pack is preconfigured to use PostgreSQL database by default; it is required to run Track.
- NETWORK PORTS:
The following list contains all processes network ports that are involved in meshIQ Track 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)
MQ AGENT (nsqmq): ....................5010 (TCP & UDP)
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)
RabbitMQ URL PORT: ------- 15672 (TCP)
The machine on which the install will be done must meet all prerequisites for installation described above.
Setup steps
These steps assume local installation for all related components.
You only need the 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 the $APIN_HOME/sbin/ folder and modify the 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 the command below from the APIN_HOME/sbin/ directory and follow the onscreen instructions.
SHELL COMMAND: cd APIN_HOME/sbin
SHELL COMMAND: ./start.sh all
Press the enter key to set the install path automatically.
The first time you run these commands, you may be asked to specify the untarred/unzipped directory location, after which you will need to re-run the command ./start.sh all.
YOU HAVE COMPLETED THE INSTALLATION. Please check $APIN_HOME/logs for any errors.
If you are new to the meshIQ Platform, we recommend that you check out the following web pages to get started:
| Management | https://customers.meshiq.com/hc/en-us/categories/360002068774 |
| Tracking | https://customers.meshiq.com/hc/en-us/categories/360002083773 |
Setting the installation path (Optional)
Setting the installation path using environment variables
To run startup scripts from anywhere, we recommend that you set the environment variables APIN_HOME and PATH to the sbin directory in the 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 the meshiq installation.
Set the installation path manually
To set the installation path manually, edit APIN_HOME/sbin/apin_env.sh
Change the line:
export APIN_HOME=ExistingPath
Replace ExistingPath with NewPath.
Access meshIQ Manage
To access the meshIQ manage user interface 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)
Access meshIQ Track
To access the meshIQ track user interface 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
Stream 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 the meshIQ Platform, we recommend that you check out the following web pages to get started:
| Management | https://customers.meshiq.com/hc/en-us/categories/360002068774 |
| Tracking | https://customers.meshiq.com/hc/en-us/categories/360002083773 |