Installation & Upgrade Guide Document Release: September 2012 SnapLogic, Inc. 71 East Third Avenue San Mateo, California 94401 U.S.A. www.snaplogic.com
Copyright Information 2011-2012 SnapLogic, Inc. All Rights Reserved. Terms and conditions, pricing, and other information subject to change without notice. SnapLogic and SnapStore are among the trademarks of SnapLogic, Inc. All other product and company names and marks mentioned are the property of their respective owners and are mentioned for identification purposes only. Snap- Logic is registered in the U.S. and Trademark Office.
Table of Contents Installation & Upgrade Guide 1 Table of Contents 3 Overview 5 Platforms and Prerequisites 5 Other Considerations 6 Installation 7 Installing SnapLogic Server 7 Upgrades 9 Upgrading the SnapLogic Server 9-3 -
SnapLogic Installation & Upgrade Guide - 4 -
Overview 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: support@snaplogic.zendesk.com. Platforms and Prerequisites Supported Platforms Operating System SnapLogic Server Linux Ubuntu 12.04 LTS (64-bit) Version 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 Operating System Version Linux RedHat Enterprise Linux 5/CentOS 5 (64-bit) Ubuntu 12.04 LTS (64-bit) Windows Windows Server 2008 Beta Apple OS X Operating System SnapLogic Server 10.4 (or later) (64-bit) Version Any Operating System not specifically documented above is not supported. Note that SnapLogic bundles the following technologies: SSL connectivity protocol; Apache Tomcat web server (only for "internal" connectivity between the Snap- LogicServer and the Component Container); Oracle Java Virtual Machine 1.6 runtime environment Python 2.7 and associated libraries - 5 -
SnapLogic Installation & Upgrade Guide These technologies must be allowed within your environment for SnapLogic to operate successfully. Other Considerations Running Behind a Proxy SnapLogic supports running behind a proxy server. For information see: "Running SnapLogic Behind a Proxy" in the User Guide. - 6 -
Installation Installation This section describes how to install the SnapLogic software. Please note that if you are uninstalling 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: Download the specific rpm or deb file for your operating system version and CPU architecture (x86_64/amd64 or i386). 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) Redhat/CentOS: Install (as root) execute: rpm -ivh <package_name>.rpm (example: rpm -ivh snaplogic-3.5.0.20019_rhel5-0.x86_64.rpm) All supported Linux distributions: Once you have the software installed you will want to start up the SnapLogic Server by executing 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): 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. To start up the SnapLogic Server, execute as the user you installed the software as: - 7 -
SnapLogic Installation & Upgrade Guide /Applications/snaplogic/bin/snapctl.sh restart To stop the SnapLogic Server. execute as the user you installed the software as: Launch the Designer: /Applications/snaplogic/bin/snapctl.sh stop Once the server is up and running, you should be able to access the Designer in a browser via the following URL: https://<host_name>/designer Where <host_name> is the name of the machine that the software was installed on. Be sure that the machine running the browser can resolve this name either locally or via DNS. Use the following username and password combination to log into the Designer: username: admin password: For OS X, the default admin password is snaplogic_admin_pw. For Linux, the password is randomly generated and is saved to /opt/snaplogic/config/textpasswords. - 8 -
Upgrades 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. Shutdown all processes (Linux): snapctl.sh stop ; ps -ef grep snap Do a full /snaplogic directory backup (Linux): cd /opt ; tar -czvf snaplogic-before-<version>.tar.gz snaplogic Run the installer: RHEL/CentOS based platforms: rpm -Uvh snaplogic...rpm Ubuntu based platforms: dpkg -i snaplogic...deb OS X based platform: Double click the installer and follow the prompts. Reinstall all necessary Snaps. Each version maintains its own subdirectory so the resulting directory structure will look like: /snaplogic /snaplogic/3.2.0.pe /snaplogic/3.2.1.pe /snaplogic/3.3.0.pe /opt/snaplogic/repository /opt/snaplogic/python The new version of SnapLogic will mount and use the existing repository. - 9 -