Installation Installatio n & Upgrade Guide Document Release: September Septembe r 2012
SnapLogic, Inc. 71 East Third Avenue San Mateo, California California 94401 944 01 U.S.A. www.snaplogic.com
Copyright Information © 2011-2012 SnapLogic, Inc. All Rights Reserved. Terms and conditions, pricing, and other information subject to ch ange without notice. ”SnapLogic” and “SnapStore” are among th e trademarks of SnapLogic, Inc. All other product and company names and marks ment ioned are the property of their respective owners and are mentioned for identification purposes only. “SnapLogic” 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 Installing SnapLogic Server Upgrades Upgrading the Sna pLogic Server
7 7 9 9
SnapLogic ® Installation & Upgrade Guide
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:
[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 Operating System
Version
Linux
Windows
l
RedHat Enterprise Linux 5/CentOS 5 (64-bit)
l
Ubuntu 12.04 LTS (64-bit)
Windows Server 2008
Beta SnapLogic Server Operating System Apple OS X
Version 10.4 (or later) (64-bit)
Any Operating System not specifically documented above is not supported. Note that SnapLogic bundles the following technologies: l
l
SSL connectivity protocol; Apache Tomcat web server (only for "internal" connectivity between the SnapLogicServer and the Component Container);
l
Oracle Java Virtual Machine 1.6 runtime environment
l
Python 2.7 and associated libraries
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.
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: l
Download the specific rpm or deb file for your operating system version and CPU architecture (x86_64/amd64 or i386). l
Ubuntu/Debian: Install (as root) execute: sudo dpkg -i
.deb
(example: dpkg -i snaplogic_3.5.0.20019-Ubuntu-10.10_amd64.deb ) l
Redhat/CentOS: Install (as root) execute: rpm -ivh .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 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): 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:
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: Once the server is up and running, you should be able to access the Designer in a browser via the following URL: https:///designer
Where 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 .
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. l
l
l
l
Shutdown all processes (Linux): snapctl.sh stop ; ps -ef | grep snap Do a full /snaplogic directory backup (Linux): cd /opt ; tar -czvf snaplogic-before-.tar.gz snaplogic Run the installer: l
RHEL/CentOS based platforms: rpm -Uvh snaplogic.....rpm
l
Ubuntu based platforms: dpkg -i snaplogic....deb
l
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.
