Upgrading Arcadia Enterprise Using Cloudera Manager

Before you begin upgrading Arcadia Enterprise using Cloudera Manager, familiarize yourself with some terminology, prerequisites, and complete all necessary pre-installation tasks.

Developer Note. We do not test or certify rolling upgrades of clusters or operating systems; they may or may not work.
Developer Note. Arcadia Enterprise uses separate binaries for CDH 5.5, CDH 5.6, and so on. Ensure that you select the correct option for your installation. See Certifications: Partner Integration.

Perform the following tasks for upgrade:

Stop All Arcadia Enterprise Services

  1. Log into Cloudera Manager.
  2. In Cloudera Manager, under Home, select the name of the Arcadia service.
  3. Stop Arcadia service.
  4. Stop Cloudera Manager.

Back-up Application Metadata

Back-up application metadata, which is located on the node that runs the Arcadia visualization server.

For SQLite metadata, make a backup copy of the following file:

/var/lib/arcadia/arcviz.sqlite3

To backup application metadata for all other connections (Oracle, MySQL, and Postgress), please contact your database administrator.

Install New Arcadia Enterprise Parcel Packages

Please work with Arcadia Data solutions team to obtain the latest Arcadia Enterprise parcel packages.

  1. Download the provided parcel package onto the Cloudera Manager host.
  2. Unzip/untar the parcel packages in a temporary directory. You will see the following files:
    • ARCADIAENTERPRISE-<version-number>.parcel
    • ARCADIAENTERPRISE-<version-number>.jar
    • manifest.json
  3. Change the directory location to the directory where you extracted the files. In our example, the directory is temp.

    $ cd temp
  4. Copy the ARCADIAENTERPRISE-<version-number>.jar file to the Cloudera CSD directory.

    $ sudo cp ARCADIAENTERPRISE-<version-number>.jar /opt/cloudera/csd

Start Simple HTTP Server

In the temp directory, which contains the parcel packages, run the simple python server to enable Cloudera Manager to pick up the parcels.

$ python -m SimpleHTTPServer 1985 &

Restart Cloudera Manager

On the Cloudera Manager host, enter the following command to restart Cloudera Manager.

$ sudo service cloudera-scm-server restart

Switch Arcadia Service Versions

After Cloudera Manager restarts, proceed to removing the old version of Arcadia Enterprise and replacing it with the new version.

  1. Click Hosts, then click Parcels.
  2. To download the new version, click Download.
    Downloading the new version
    Click Download
  3. Once the parcel is downloaded, the Download button changes to Distribute. Click on Distribute.
    Clicking the Distribute button on the right
    Click Distribute
  4. Once the parcel is distributed, the Distribute button changes to Activate. Click Activate. This automatically deactivates the existing version of Arcadia Enterprise.
  5. On the screen that appears, select Activate Only.
  6. Click OK.
    Clicking Activate Only, then clicking OK
    Click Activate Only
  7. To remove the old version, click the arrow on the right of Activate, then select Remove From Hosts.
    Removing old version
    Remove Old Version
  8. The Activate button changes to Distribute. Click the arrow on the right of Distribute, then select Delete.
    Clicking the drop-down menu, then clicking delete
    Delete Old Version
    Your old version of Arcadia Enterprise is now deleted and the new parcel is activated and ready for use. If you need to make any configuration changes, we recommend you to do it before starting Arcadia Enterprise.

Start Arcadia Enterprise

  1. Start Arcadia Enterprise service.
  2. Confirm that all Arcadia Enterprise roles have started successfully.
  3. Check for errors in the Cloudera Manager start logs.
  4. Log into ArcViz.
  5. Load several reports and create a visual to confirm full functionality of Arcadia Enterprise.

Congratulations on successfully upgrading Arcadia Enterprise on Cloudera Manager!