Pre-requisites

Install any of the supported databases.

Procedure

To install ConnectALL in your Linux server, follow the below procedure. 

  1. Download the ConnectALL installation file to the required directory in your Linux system.
  2. Initiate the installation using the downloaded ConnectALL installer file. The file would prompt you to confirm.
  3. Press 'O' or the Enter button. This will start the ConnectALL installation, and the license agreement will be displayed.  If you want to cancel the installation, press 'C'.
  4. Read the license agreement. The system will prompt you to press 'Enter' to proceed after it displays each point in the terms and conditions. 
  5. Press '1' (yes) to accept the terms and conditions, when you arrive at the final page of Terms and Conditions; press '2' (No) if you want to disagree and review. 
  6. The system displays the question, 'Where should ConnectALL be installed' and displays a path. Press the Enter key to proceed with installing in the displayed path. Otherwise, enter a location to install and press Enter.
  7. Press '1' to confirm the installation. Press 2 If this is an upgrade. In the below-displayed image, option '1' is selected to proceed with this installation.
  8. The installer offers to install the components and lists them.  Select the components that you want to install and proceed. You will be able to provide the database details for ConnectALL Insights Analytics, which will appear as the default data source. Also, ConnectALL's hierarchy plugin will be automatically installed when you select the ConnectALL Insights Analytics option. 

    Note: Enter the number of the component that you want to install. For example, if you have Mule and Tomcat already installed, and If you want to install Java, press ‘3’. If you want to install all three components, along with ConnectALL, enter 1,2,3.  By default, whichever option you choose, ConnectALL also gets installed. If you are installing Tomcat on your own, read this before installing.

    Important: ConnectALL comes bundled with Oracle Java.  Oracle announced its new Java license model that became effective in 2018. Oracle has ended the public updates to Java 8.  If you wish, you can switch to AdoptOpenJDK from Oracle JDK. To do that, you need to, 

    1. Install AdoptOpenJDK.
    2. Change the $JAVA_HOME environment variable and $JRE_HOME to point the installation to AdoptOpenJDK.
    3. Restart the ConnectALL core and Tomcat services for the changes to take effect.

    During installation, Do not select the JAVA option, but ensure that the JAVA path is pointing to the right location of OpenJDK.

  9. If you have selected all three options, the system prompts you to choose a location for Java and Tomcat.  Enter the location as shown below and press Enter.
  10. You will be prompted to choose a database.  Enter your choice and press Enter. In the below example, MySQL is chosen. ConnectALL allows you use the Azure SQL database also. If you are using Azure SQL, select the SQLServer option (this option works for both on-prem and Azure SQL). Select JTDS if you are using SQL Server (on-prem). 
    Note: If you are using MySQL version 8, you have to configure the timezone in the MySQL my.cnf file as provided below and restart the MySQL service.

    # Set default time zone

    default-time-zone = '+00:00'


    Note: If you are selecting Oracle and PostgreSQL, Ensure that you have created a database schema in advance before you start the installation process. Further progression without creating the DB schema will lead to failure in the DB Connectivity test.

  11. Enter the following information when prompted and press Enter after each input.
    1. DB server information (with the port information)
    2. Username and Password of the DB server
    3. Name for your database - You can enter a name of your choice.  (or) If you press enter, the default name (muledb) will be retained as the name for your database. The connection is tested, validated and a confirmation - ‘Connected Successfully’ is displayed.

      Note:

      1. If you have an Oracle or PostgreSQL database, you need to upload the JAR file, to ensure that connectivity gets established; In addition to this, for the oracle DB, ensure that you provide the database along with URL and port. For example: 192.168.21.79:1521/cadb1.

      2. Note that ConnectALL allows you to have two separate users—a ConnectALL database user to set up the ConnectALL DB and a read-only user for Insights Analytics. The read-only user can be created using the scripts here. In the above screen, enter the ConnectALL credentials and ConnectALL Insights Analytics credentials in their respective places. 

  12. The following information is displayed, confirming a successful installation.
  13. The ports are validated, and the following information is displayed.

    Note: The default ports will be made available. You can choose to continue with the same ports or, you can provide custom ports that will be validated before assignment to the respective services.
  14. The following list of information is displayed, providing you all the details about the installation.

    You have successfully installed ConnectALL in your Linux environment. Note that in the above image, the GUI URL, Username, and Password are listed. Use the details when you launch ConnectALL. You can access ConnectALL via http://server_ip:8080/ConnectAll. The default username/password is “admin/welcome”.
  15. This is a good point to install the "natel-plotly-panel" plugin into ConnectALL Insights Analytics. This plugin is used by ConnectALL's recommended starter-set of metrics. Installing plugins requires restarting the Insights service.

    If a 404 error occurs when accessing the ConnectALL website, and the logs report MULE_HOME & CONNECTALL_HOME not found, you can add the MULE_HOME & CONNECTALL_HOME environment variables to <TOMCAT_HOME>/bin/setclasspath.sh . Then restart the ConnectALL core and Tomcat services.

    Ensure that the installer does not display the "scripts not executed successfully" message. Contact support if you see this error. The error indicates that the installation was not successful.