The System → Installation Guide
Software Installation References Testing
Installing Apache ActiveMQ
Installing Apache Tomcat
Installing Apache Web Server
Installing PHP
Installing MySQL
Hardware and Software Prerequisites
| Hardware | Windows | Linux |
|---|---|---|
| Operating System | Windows 7 Professional Windows Server 2008 Windows Server 2012 |
Linux Centos 6.5 or above |
| CPU | 4*2 Cores / Speed | 4*2 Cores / Speed |
| Memory | 16 GB | 16 GB |
| Hard Drive | 150 GB or More Space | 150 GB or More Space |
| Server | Windows | Linux |
| Active MQ | 5.8 or above | 5.8 or above |
| Apache Tomcat | 7.0 or above | 7.0 or above |
| Apache | 2.2 or above | 2.2 or above |
| Software | Windows | Linux |
| PHP | 5.4 or above | 5.4 or above |
| JDK / JRE | 1.7 or above | 1.7 or above |
| Database | Windows | Linux |
| MySQL | 5.5 or above | 5.5 or above |
| Browser | Windows | Linux |
| Mozilla | 45.0 or above | |
| Internet Explorer | 11.0 or above | |
| Chrome | 49.0 or above |
RoboDX™ Installation Steps
Apache Active MQ
Step 1: Check the Apache Active MQ availability and ensure that it is installed.
| Windows | Go to D:/apache-activemq-5.8.0/bin |
| Linux | Go to /opt/apache-activemq-5.8.0/bin |
Step 2: To start the Apache Active MQ server, use the following path(s):
- Windows: D:/apache-activemq-5.8.0/bin
- For windows, double click on the activemq.bat file available at: D:/apache-activemq-5.8.0/bin Once loaded, the comment prompt will display.
- Check to see if the activemq is running or not, using the Queue URL.
- Linux: /opt/apache-activemq-5.8.0/bin
- For Linux, type in the command: ./activemq start
- Click Enter.
- Check the ActiveMq in the browser by entering the URL.
Step 3: Check the Apache Tomcat availability. Ensure that it is installed.
| Windows | Go to D:/ apache-tomcat-7.0.54/bin |
| Linux | Go to /opt/apache-tomcat-7.0.54/bin |
Step 4: Place the compiled source code into the apache-tomcat.
| Windows | Go to D:/ apache-tomcat-7.0.54/webapps |
| Linux | Go to /opt/apache-tomcat-7.0.54/webapps |
Step 5: Change the properties, such as database, and Queue URL in: * CIP_DX_ENGINE_API, and * CIP_DX_FILE_WATCHER
| Windows | Go to D:/ apache-tomcat-7.0.54/webapps/CIP_DX_ENGINE_API/WEB-INF/Config/Configuration.properties |
| Linux | Go to /opt/apache-tomcat-7.0.54/webapps/CIP_DX_ENGINE_API/WEB-INF/Config/Configuration.properties |
Open the Configuration.properties file and change the server details in the fields mentioned in the color red.
- DBEnable=false
- DBHost=DATABASE_IP
- DBPort=DATABASE_PORT
- DBName=DATABASE_NAME
- DBUsername=USERNAME
- DBPassword=PASSWORD
- MangoDBEnable=false
- MangoDBHost=localhost
- MangoDBName=cipdx
- MangoDBUsername=
- MangoDBPassword=
- MangoDBPort=27017
- MangoDBPort=27017s
- MangoDBPort=27017
- MangoDBCollectionName=mydb
- QueueURL=tcp://localhost:51515?closeAsync=false
- QueueName=DATAFETCH_DX
- QueueUsername=admin
- QueuePassword=admin
- QueueComponentID=1
RoboDX™ File Watcher
| Windows | Go to D:/ apache-tomcat-7.0.54/webapps/CIP_DX_FILE_WATCHER /WEB-INF/Config/Configuration.properties |
| Linux | Go to /opt/apache-tomcat-7.0.54/webapps/CIP_DX_FILE_WATCHER/WEB-INF/Config/Configuration.properties |
Again, open the Configuration.properties file and change the server details in the fields mentioned in the color red.
- DBEnable=false
- DBHost=DATABASE_IP
- DBPort=DATABASE_PORT
- DBName=DATABASE_NAME
- DBUsername=USERNAME
- DBPassword=PASSWORD
- QueueURL=tcp://localhost:51515?closeAsync=false
- QueueName=DATAFETCH_DX
- QueueUsername=admin
- QueuePassword=admin
- QueueComponentID=1
Step 6: Restart the Apache-Tomcat Server.
| Windows | Stop Start |
Go to D:/apache-tomcat-7.0.54/bin/shutdown.bat Go to D:/ apache-tomcat-7.0.54/bin/startup.bat |
| Linux | Stop Start |
Go to /opt/apache-tomcat-7.0.54/bin/./shutdown.sh Go to /opt/apache-tomcat-7.0.54/bin/./startup.sh |
Step 7: To verify if the engine has started, check the applicable log file folder below:
RoboDX™ Engine API
| Windows | D:/ apache-tomcat-7.0.54/webapps/CIP_DX_ENGINE_API/log |
| Linux | /opt/apache-tomcat-7.0.54/webapps/CIP_DX_ENGINE_API/log |
- Timestamp [localhost-startStop-1] INFO CipDxLogger - Engine Started...
- Timestamp [localhost-startStop-1] INFO CipDxLogger - DB Initialized...
- Timestamp [localhost-startStop-1] INFO CipDxLogger - Mail Initialized...
- Timestamp [localhost-startStop-1] INFO CipDxLogger - Batch and DB Scheduler Initialized
- Timestamp [Thread-1521] INFO CipDxLogger - Batch and DB Scheduler Started.
RoboDX™ File Watcher
| Windows | Go to D:/ apache-tomcat-7.0.54/webapps/CIP_DX_FILE_WATCHER /log |
| Linux | Go to /opt/apache-tomcat-7.0.54/webapps/CIP_DX_FILE_WATCHER/log |
- Timestamp [localhost-startStop-1] INFO CipDxLogger - Engine Started...
- Timestamp [localhost-startStop-1] INFO CipDxLogger - DB Initialized...
- Timestamp [localhost-startStop-1] INFO CipDxLogger - Mail Initialized...
- Timestamp [Thread-6] INFO CipDxLogger - UniqueRouteSendQueue Single Instance Created
- Timestamp [Thread-6] INFO CipDxLogger - Data Monitor Listening...
Application Configuration
After installing all the necessary software, please follow the below steps to complete the PHP source installation.
1) Copy the source file to the document root.
| Windows (xampp) | Go to C:/xampp/htdocs/ |
| Linux | Go to /var/www/html/ |
2) Change the configuration file for accessing the database, application URL etc.
| Windows (xampp) | Go to C:/xampp/htdocs/CIPDX/protected/config/main.php |
| Linux | Go to /var/www/html/ CIPDX/protected/config/main.php |
3) Open either of the main.php files above and modify the contents in red below.
- defined('DB_IP') || define('DB_IP',’DATABASE_IP’);
- defined('DB_IP') || define('DB_IP',’DATABASE_IP’);
- defined('DB_PASSWORD') || define('DB_PASSWORD','PASSWORD’);
- defined('DB_NAME') || define('DB_NAME',’DATABASE_NAME’);
- defined('SERVER_IP') || define('SERVER_IP',’SERVER_IP’);
- defined('SERVER_URL') || define('SERVER_URL',’SERVER_URL’);
- defined('ENGINE_IP') || define('ENGINE_IP',’ENGINE_IP’);
Step 8: Start the Apache Server.
| Windows (xampp) | C:/xampp/xampp_start.exe |
| Linux | # /etc/init.d/apache2 start |