Installing and Upgrading Arcadia Enterprise on MapR

Before you begin your installation or upgrade, familiarize yourself with some terminology, prerequisites, and complete all necessary pre-installation tasks.

Get and Distribute Arcadia Enterprise Install Files

Please work with Arcadia Data solutions team to obtain the latest install files. Contact us at support@arcadiadata.com

Distribute the Arcadia files to all nodes that run an Arcadia Enterprise service.

  1. Copy Arcadia Data installer *.rpm file into a temporary directory.
  2. Install the rpm from the previous step:
    rpm -Uvh ARCADIA-ENTERPRISE-release_no.version.x86_64.rpm

    Where release_no is the number of the release; such as 4.1.1 for Arcadia Enterprise Release 4.1.1.0.

Configure the Service Node

Follow these steps to configure the Arcadia Services on a service node, such as the node that runs the hive metastore process, or hiveserver2. For interest of simplicity, we can call it the master node, and its address master_node_ip.

  1. Install files for the Warden process manager that lets you to start, stop, and restart a service, and manages memory allocation:

    sudo /opt/arcadia/build/install-arcadia.sh /opt/mapr /opt/arcadia master_node_ip
  2. Install the ArcStateStore service:

     sudo /opt/arcadia/build/install-arcadiastatestore.sh
  3. Install the ArcCatalog service:

    sudo /opt/arcadia/build/install-arcadiacatalog.sh
  4. Install the ArcEngine service:

    sudo /opt/arcadia/build/install-arcengine.sh
  5. Install the ArcViz service on the master node.

    To install the default and sample connections, use the -h option to connect to a node that hosts the ArcEngine; this could be the service node, or another node in the cluster.

    sudo /opt/arcadia/build/install-arcviz.sh -h arcengine_node_ip
    Developer Note. When upgrading, this step may generate a false error, noting that "Data connection with name 'default' already exists". You can ignore it, because the upgrade still succeeds.

    To install without default connections and samples, use the following command:

    sudo /opt/arcadia/build/install-arcviz.sh

Configure the Other Nodes

Follow these steps to configure the other cluster nodes:

  1. Install files for the Warden process manager that lets you to start, stop, and restart a service, and manages memory allocation:

    sudo /opt/arcadia/build/install-arcadia.sh /opt/mapr /opt/arcadia master_node_ip
  2. Install the ArcEngine service:

    sudo /opt/arcadia/build/install-arcengine.sh

Start Arcadia Services

Follow these steps to start Arcadia Services on all nodes.

  1. Start the ArcStateStore service on the master node:

    maprcli node services -name arcadiastatestore -action restart -nodes master_node_ip 
  2. Start the ArcCatalog service on the master node:

    maprcli node services -name arcadiacatalog -action restart -nodes master_node_ip
  3. Start the ArcEngine service on all nodes of the cluster, including the master node. Include all nodes, separated by a space character:

    maprcli node services -name arcengine -action restart -nodes master_node_ip node_1_ip node_2_ipnode_n-ip
  4. Start or restart the ArcViz service on the master node:

    maprcli node services -name arcviz -action restart -nodes master_node_ip
  5. [Upgrades] When migrating from an earlier installation of Arcadia Enterprise, ensure that metadata and analytical views are migrated correctly. See Metadata Upgrade and Migrating Analytical Views.