Installation & Upgrade Guide

(1)

Installation & Upgrade Guide

Document Release: September 2012 SnapLogic, Inc. 71 East Third Avenue San Mateo, California 94401 U.S.A.

(2)

Copyright Information

(3)

Overview

The Installation & Upgrade Guide provides you with the details installing or upgrading to the latest SnapLogic release.

Please visit our website, www.snaplogic.com, to find the most current documentation. For technical questions and support inquiries, please email: [email protected].

Platforms and Prerequisites

Supported Platforms

SnapLogic Server

Operating System Version

Linux l Ubuntu 12.04 LTS (64-bit)

l Red Hat Enterprise Linux 5/CentOS 5 (64-bit)

SnapLogic Browser Clients (Designer, Console) Version

Chrome 11 (or later), Firefox 4 (or later), Internet Explorer 9 (or later), Safari 4 (or later)

SnapLogic Sidekick

Linux l RedHat Enterprise Linux 5/CentOS 5 (64-bit)

l Ubuntu 12.04 LTS (64-bit)

Windows Windows Server 2008

Beta

SnapLogic Server

(6)

-SnapLogic®Installation & Upgrade Guide

These technologies must be allowed within your environment for SnapLogic to operate suc-cessfully.

Other Considerations

Running Behind a Proxy

(7)

Installation

This section describes how to install the SnapLogic software. Please note that if you are unin-stalling a previous version of SnapLogic to do a clean re-install, you must first move or rename the existing SnapLogic folder (for example, /opt/snaplogic) before running the installer to avoid validation errors. Note: Removing or moving the SnapLogic folder will erase all existing Pipelines, Snaps, and resources.

Installing SnapLogic Server

Download the installer image for your platform, then:

For Linux:

l Download the specific rpm or deb file for your operating system version and CPU archi-tecture (x86_64/amd64 or i386). l Ubuntu/Debian: Install (as root) execute: sudo dpkg -i <package_name>.deb (example: dpkg -i snaplogic_3.5.0.20019-Ubuntu-10.10_amd64.deb) l Redhat/CentOS: Install (as root) execute: rpm -ivh <package_name>.rpm

(example: rpm -ivh snaplogic-3.5.0.20019_rhel5-0.x86_64.rpm) l All supported Linux distributions: Once you have the software installed you will want to start up the SnapLogic Server by execut-ing the following as root: /opt/snaplogic/bin/snapctl.sh restart If you want to stop the services, execute as root: /opt/snaplogic/bin/snapctl.sh stop

For OS X (Beta Only):

l Open up the DMG file and double click on the APP file. This will install the application for you as the user you're logged in as.

l To start up the SnapLogic Server, execute as the user you installed the software as:

(8)

-SnapLogic®Installation & Upgrade Guide

/Applications/snaplogic/bin/snapctl.sh restart

l To stop the SnapLogic Server. execute as the user you installed the software as: /Applications/snaplogic/bin/snapctl.sh stop

Launch the Designer:

(9)

Upgrades

Upgrading the SnapLogic Server

If you are upgrading from a prior version of SnapLogic, be sure to first stop all SnapLogic

services and then do a full backup of the existing installation.

l Shutdown all processes (Linux):

snapctl.sh stop ; ps -ef | grep snap l Do a full /snaplogic directory backup (Linux):

cd /opt ; tar -czvf snaplogic-before-<version>.tar.gz snaplogic l Run the installer:

Installation & Upgrade Guide