Slingshot Installation Guide - TIBCO Software€¦ · Note: A Java JDK (Java Development Kit) should already be installed on the Slingshot server. Setting the JAVA_HOME environment

Table of Contents Slingshot Installation Guide

TIBCO Slingshot Installation Guide

September 2 2011

Slingshot Installation Guide Important Information Page

Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE

USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT OR IF THERE IS NO SUCH SEPARATE AGREEMENT THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT THE LICENSE(S) LOCATED IN THE ldquoLICENSErdquo FILE(S) OF THE SOFTWARE USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME

This document contains confidential information that is subject to US and international copyright laws and treaties No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc

TIBCO The Power of Now TIBCO Managed File Transfer TIBCO Managed File Transfer Command Center TIBCO Managed File Transfer Internet Server TIBCO Managed File Transfer Platform Server TIBCO Managed File Transfer Platform Server Agent Edge Server RocketStream Accelerator and Slingshot are either registered trademarks or trademarks of TIBCO Software Inc or its subsidiaries in the United States andor other countries

EJB Java EE J2EE and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems Inc in the US and other countries

All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only

THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS HOWEVER NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME

THIS DOCUMENT IS PROVIDED ldquoAS ISrdquo WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT TIBCO SOFTWARE INC MAY MAKE IMPROVEMENTS ANDOR CHANGES IN THE PRODUCT(S) ANDOR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME

THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED ANDOR QUALIFIED DIRECTLY OR INDIRECTLY BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND READ ME FILES

TIBCOreg Managed File Transfer Internet Server with RocketStreamreg Accelerator is entitled TIBCOreg Managed File Transfer Internet Server in certain other product documentation and in user interfaces of the product Copyright copy2003-2011 TIBCO Software Inc ALL RIGHTS RESERVED TIBCO Software Inc Confidential Information TIBCO welcomes your comments on this publication Please address your comments to

TIBCO Software Inc 200 Garden City Plaza Garden City New York 11530 USA Web site httpwwwtibcocom Technical Support E-mail supporttibcocom Technical Support Call Centers

North and South America +16508465724 or +18777248227 (1877724TACS) EMEA (Europe Middle East Africa) +44 (0) 8709093893 Australia +61243799318 or 1800184226 Asia +61 2 4379 9318

When you send information to TIBCO you grant TIBCO a non-exclusive right to use or distribute the information in any way TIBCO believes appropriate without incurring any obligation to you

Table of Contents 1 Supported Systems amp Pre Requisites 4

11 Firewall Ports 42 Creating the Slingshot Database 63 Installing Slingshot 7

31 Java Memory Size 832 Installing Slingshot 1033 Automatically Restarting the Web Server 1834 URL Redirection 20

4 FIPS 140-2 Manual Configuration 2241 Enable FIPS Mode Manually 2342 Taking the Slingshot server out of FIPS mode 25

5 Slingshot Software License Keys 2651 Applying the Software License Keys 27

6 Customizing Slingshot 2961 Logos 2962 Email Templates 32

7 Slingshot Outlook Plug-in Install 3471 Desktop Install 3472 Silent Install 3773 Hiding the Slingshot Send button in Outlook 2003 37

8 Uninstall 38A Install Worksheet 39

Slingshot Installation Guide Pre-Requisites

1 Supported Systems amp Pre Requisites Please see the Slingshot 181 Release Notes

11 Firewall Ports

for the pre-requisite information on what you will need for a successful installation

When installing Slingshot in a network protected by a firewall a firewall rule change may be required to allow recipients of Slingshot files to communicate with and download files from the server in your network Below is a list of ports that the Slingshot server can use for communication REQUIRED INBOUND COMMUNICATION Service Default Port Recommended

Port Source Description

Web Server HTTPS 8443 443 Everyone Access Server Web Pages

REQUIRED OUTBOUND COMMUNICATION Service Default Port Recommended

Port Target Description

SMTP 25 25 Email Server Used to send Slingshot emails

OPTIONAL INBOUND COMMUNCATION Service Default Port Recommended

Web Server HTTP 8080 80 Everyone Redirect to HTTPS SSH 22 NA Valid IPs for remote

administration Remote server administration

SNMP TCP 199 NA Monitoring Servers Allows server monitoring using SNMP Polling

SNMP UDP 161 NA Monitoring Servers Allows server monitoring using SNMP Polling

OPTIONAL OUTBOUND COMMUNICATION Service Default Port Target Description DNS 53 DNS Server DNS Name Lookups

Pre-Requisutes Slingshot Installation Guide

LDAP 389 Active Directory Allows server to synchronize with AD

LDAPS 636 Active Directory Allows server to synchronize with AD

NTP 123 NTP Server Synchronize time with NTP server

SYSLOG UDP 514 Syslog Server Use centralized logging for server

Slingshot Installation Guide Creating the Slingshot Database

2 Creating the Slingshot Database Databases being used for Slingshot should be created with a UTF-8 character set and a case insensitive collation Slingshot provides a utility that will create and populate the database tables needed by Slingshot However before running the install program you must create a Slingshot database in whichever database application you have chosen to use (See supported databases in Section 1)

Have your Database Administrator create a database and a usernamepassword on the server that will host the Slingshot database tables It is recommended that the database and username be named ldquocfccrdquo but this is not required This username must have the ability to read write and create tables in the Slingshot database The exact steps to accomplish this may vary significantly depending on the database application you are using consult the documentation provided by your database vendor on how to perform this step Note MSSQL Server Properties MUST be configured under the Security tab to do authentication via SQL

Server and Windows The default is Windows only

Note If you are using an IBM DB2 database you must do the following Note that the Database Buffer Pool and Table Space names defined below are suggested values You can substitute names that follow your naming standards if necessary The changes should be made through the IBM DB2 Control Center or an equivalent tool 1 Create a DB2 database The only required value is the database name For example you can assign

a database name such as SSDB 2 Create a DB2 Buffer Pool with a page size of 32K Assign a name such as SSBP to the buffer pool

This buffer pool will be needed in later steps 3 Create a DB2 Table Space Give this table space a name like SSTS This table spaces should be

defined as Type ldquoRegularrdquo and use the Buffer Pool defined in step 2 Create a DB2 Container with a unique name such as ldquoCDB2ContainerSSCTSrdquo This directory will be automatically created by DB2 when the table space definition is completed

4 Create a second DB2 Table Space Give this table space a name like SSTTS This table space should be defined as Type ldquoSystem Temporaryrdquo and use the Buffer Pool defined in step 2 Create a DB2 Container with a unique name such as ldquoCDB2ContainerSSCTTSrdquo This directory will be automatically created by DB2 when the table space definition is completed

Note If you are using an Oracle 9i or later using Cost Based Optimization (CBO) it is strongly recommended that the optimization is tuned for first_rows for the Slingshot database To enable this the following command should be issued from sqlplus as SYSDBA after creating the database

alter system set optimizer_mode=first_rows_100

Installing Slingshot Slingshot Installation Guide

3 Installing Slingshot This chapter will assist you in installing TIBCO Software Incrsquos Slingshot product Some steps in the installation process will differ depending on the location of your files In this chapter variables are indicated by italics whether or not the word is in bold text Note Before beginning the Slingshot install please ensure that all requirements on Appendix A (Install Worksheet) have been met

Slingshot Installation Guide Installing Slingshot

Installation Procedure The following steps are required before starting the Slingshot install Note A Java JDK (Java Development Kit) should already be installed on the Slingshot server Setting

the JAVA_HOME environment variable allows Slingshot to use the Java Virtual Machine Slingshot installation and configuration also requires the bin directory of the J2SDK to be in your

PATH Instructions are shown below

Installing on Windows or UNIX

1 Set the JAVA_HOME environment variable The JDK directory name may be different in your system

Windows set JAVA_HOME=hellipJDK160_26 UNIX export JAVA_HOME=hellipJDK160_26

2 Set the PATH to point to the Javabin directory Windows set PATH=JAVA_HOMEbinPATH Or set PATH=hellipJDK160_26binPATH UNIX export PATH=$JAVA_HOMEbin$PATH Or export PATH=hellipJDK160_26bin$PATH

3 Verify that the path was correctly set by issuing the following command Windows and UNIX java ndashversion Sample output Java(TM) 2 Runtime Environment Standard Edition (build 150_07-b03)

If you are installing MFTCCIS on one of the supported UNIX platforms and have uploaded the files needed for installing on UNIX the default permissions should be set to the following

cfccjar -r-- r-- r-- 444 EULA -r-- r-- r-- 444 install-configxml -r-- r-- r-- 444 installsh -r-x r-x r-x 555 installerjar -r-- r-- r-- 444 serverjar -r-- r-- r-- 444 uninstallsh -r-x r-x r-x 555

31 Java Memory Size By default Slingshot will set the Web Serverrsquos Java Heap memory size to 512 MB minimum and 1024 MB maximum size Ensure that your server meets the required amount of physical memory before installing Slingshot

The memory heap size can be changed after installing Slingshot using the following methods

1 For the embedded Web Server In the Slingshot Install Directory a file is used to set the Java Heap Size

Windows File Name ltSlingshot Install Directorygtserverbinsetenvbat

Linux File Name ltSlingshot Install Directorygtserverbinsetenvsh

Open this file with a text editor to view amp edit the contents for example echo off SET CATALINA_OPTS=-Xms512m -Xmx1024m SET TITLE=Slingshot Server To change the minimum heap size value alter the ldquondashXmsrdquo parameter To change the maximum heap size value alter the ldquo-Xmxrdquo parameter

2 For a Windows Service

In the Slingshot Install Directory run the SlingshowServerwexe utility and navigate to the ldquoJavardquo tab From here you can set the Java heap size being used by the Windows Service The file can be located at ltSlingshot Install DirectorygtserverbinSlingshotServerwexe

32 Installing Slingshot To install Slingshot type the following on the command line

install

After running the install command the Slingshot installation begins You must accept the license agreement to continue with the installation

Hit enter to display and read the agreement

License Agreement Continueshellip

Read the license agreement and type lsquoyesrsquo to accept the terms The installation will continue after accepting the agreement

Step 1 The installer extracts the distribution file called cfccjar which contains all files necessary for the installation Hit Enter on this step to extract the distribution The installer then extracts the web server file called serverjar which contains the embedded Slingshot web server

If you are installing on a UNIX system with IBM java you will also be prompted to enable FIPS on the application server When put into FIPS mode Slingshot will only use FIPS certified cryptographic modules when using SSL (HTTPS and FTPS) SFTP (SSH) and AS2

Step 2 During step 2 we verify your database connection to the database you have chosen to use for Slingshot For this sample install we used a MySQL database server When using MSSQL Oracle and MySQL you will be prompted to provide a JDBC driver Supported versions and download locations for database drivers can be found in Section 1

(Note For installations using a MSSQL database that uses Windows Authentication you must add the domain parameter with the domain name to the end of the database URL To do this type ldquonrdquo when prompted with the default statement ldquoUse database URLrdquo You will be given the opportunity to enter a new database URL to use Copy and paste the URL that is contained in the brackets and then add a semicolon and the domain parameter at the end (ie

jdbcjtdssqlserver10121821433MFT701domain=DomainName) and then press the ltEntergt key)

Step 3 Once the database connection has been established in Step 2 Step 3 will generate the Slingshot database tables needed as seen in the figures below

If a Slingshot database already exists then Slingshot will either skip this step or update the tables with the necessary information needed so your database does not get overwritten Upgrading to a newer version of software using this installation method will not result in lost records or corruption of the existing table structure When performing a software upgrade TIBCO recommends that a backup of the database be taken prior to the upgrade

Step 4 This step configures the web server for SSL communications If you do not have a pre-existing java keystore the Slingshot installer will create a self-signed SSL certificate for the server You can either use a certificate issued by a Certificate Authority (CA) or use a self-signed certificate Self-signed certificates are only practical for testing purposes but do allow you to get up and running quickly while you wait for an external CA to sign a certificate for you

Warning We strongly suggest using a DNS Name when asked for to ldquoEnter the DNS name or IP Address of your serverrdquo This value is used in the Email URL field defined in the Slingshot System Configuration The URL will be referenced in emails sent out by Slingshot Although you can use an IP Address as indicated it is not recommended because if a change to the serverrsquos IP address is ever needed in the future the emails that had been sent out by Slingshot prior to the IP change will no longer be functional

Step 5 In Step 5 we configure the new HTTPS connector to be used for Slingshot and also set the ports being used by the web server for HTTP AJP and shutdown requests

Step 6 This step will configure the Slingshot context root that will be used in the Slingshot URL

Step 7 This step will install the Slingshot application

Step 8 Will verify your web server context configuration for Slingshot information

Step 9 This step will update the Slingshot webxml file with the necessary values to run the Administrator

service that controls the administrative web pages of Slingshot The Slingshot Administration service should only be installed on the internal network

Step 10 This step will be deploying the Slingshot web service

Step 11 This step will generate the SOAP stubs Slingshot will use

Step 12 This step will install the stubs generated for the Slingshot web service in Step 11

Step 13 This step will generate the files necessary to show the end-user web pages in various supported languages include English French Italian Portuguese and Spanish

Step 14 This step will digitally sign certain jar files

Step 15 This step is to verify you have installed to required AES encryption policy files needed for Slingshot

The Slingshot install has been completed

Once Slingshot is installed and configured it is time to access the Slingshot administrator web pages To login use the following URL substituting the areas of the URL with your install configurations https[DNS_HostName][context]controlview=viewadminstartjsp

Enter Username ldquoadminrdquo Password ldquochangeitrdquo (case-sensitive)

For installing product license keys see Chapter 5 Slingshot Software License Keys

33 Automatically Restarting the Web Server

By default the application server is not configured to automatically start on boot-up This section describes how to setup an automatic start for the embedded application server on a UNIXLinux or Windows systems

Windows Systems Before installing the Windows Service ensure that Slingshot is not running by navigating to the ltSlingshot Install Directorygtserverbin directory and running the following command

shutdown To install the service navigate to the ltSlingshot Install Directorygtserverbin directory and run the following command

service install You will be prompted to choose which processor you are currently running with as seen in the example screenshot below

Once the script has completed running you can now open your services window and see the Slingshot Server service listed as seen below

Should you want to remove the auto start feature simply stop the Slingshot Server service and navigate to the ltSlingshot Install Directorygtserverbin directory and run the following command

service remove

UNIXLinux Systems There are a number of methods that different UNIXLinux operating systems use to automatically start processes at boot time This example has been developed specifically for the Red Hat Linux Enterprise operating system but has been tested successfully on many other UNIX and Linux distributions The instructions for setting auto start on Red Hat Linux are

In order to have Slingshot automatically start on boot-up you will add two lines to the etcrclocal file You will need to know two pieces of information prior to modifying the file 1) The location of the Java JDK installation 2) The location where Slingshot Server is installed

For example 1) If the Java JDK installation is in optjdk160_21 2) If the Slingshot Server installation is in optSlingshot In this example add the following two lines to the etcrclocal file export JAVA_HOME=optjdk160_21 optSlingshotserverbinstartupsh When manually starting Slingshot on UNIX make sure to run the startupsh script from within the bin directory of the server This will ensure that the Java heap size is appropriately set [rootSlingshot ] cd opttibcoslingshotb152serverbin [rootSlingshot bin] startupsh Using CATALINA_BASE opttibcoslingshotb152server Using CATALINA_HOME opttibcoslingshotb152server Using CATALINA_TMPDIR opttibcoslingshotb152servertemp Using JRE_HOME opttibcojdk160_26 Using CLASSPATH opttibcoslingshotb152serverbinbootstrapjar

34 URL Redirection

By default the Slingshot server will use URL redirection to give access to the site via short URLs After installing Slingshot you can use the following redirectors to easily navigate the Slingshot Web Pages

1 Slingshot Send Files Page httpslthostgtltport

Redirects to httpslthostgtltportgtcfcccontrolview=amstartjsp

2 Slingshot Administrator Page httpslthostgtltportgtadmin

Redirects to httpslthostgtltportgtcfcccontrolview=viewadminstartjsp

If the default context was not used during installation the redirector files on the web server will need to be updated to redirect to the non standard context The 3 redirection files can be found in the Slingshot Install Directory in the following location ltSlingshot Install DirectorygtserverwebappsROOT The names of the files are as follows 1 Admin 2 Indexhtml Use a text editor to change the lsquocfccrsquo context in these files to the new context chosen during install for example if the context ldquoslingshotrdquo was chosen Old Value ltmeta http-equiv=refresh content=0url=cfcccontrolview=downloadslingshotjspgt New Value ltmeta http-equiv=refresh content=0url=slingshotcontrolview=downloadslingshotjspgt

Slingshot Installation Guide FIPS 140-2 Manual Configuration

4 FIPS 140-2 Manual Configuration This Chapter will explain the manual configuration of FIPS 140-2 on the Slingshot server if you chose not to enable FIPS mode during the installation process or want to disable FIPS mode If you selected to enable FIPS mode during installation the installer will automatically configure FIPS compliancy on the Slingshot application server and no further action is necessary

FIPS 140-2 Manual Configuration Slingshot Installation Guide

41 Enable FIPS Mode Manually There are four steps necessary to put Slingshot into FIPS mode Note Your environment must support FIPS mode in order to enable it See the pre-requisites section for FIPS mode requirements Each step is detailed in the sections that follow

1 Add FIPS certified cryptographic provider to the list of providers in the javasecurity file 2 Set the Slingshot environment variable FIPS_MODE to true in the setenvsh file 3 Set the SSHSecurityProvider parameter in the webxml file to the FIPS certified cryptographic provider

name 4 Restart the server

Step 1 Add FIPS certified cryptographic provider to the list of providers in the javasecurity file The javasecurity file is located in the ltJAVA_HOMEgtjrelibsecurity directory Find the list of cryptographic providers in the file You should see a section like the following in the file List of providers and their preference orders (see above) securityprovider1=comibmcryptofipsproviderIBMJCEFIPS securityprovider1=comibmjsse2IBMJSSEProvider2 securityprovider2=orgbouncycastlejceproviderBouncyCastleProvider securityprovider3=comibmcryptoproviderIBMJCE securityprovider4=comibmsecurityjgssIBMJGSSProvider securityprovider5=comibmsecuritycertIBMCertPath securityprovider6=comibmsecuritysaslIBMSASL securityprovider7=comibmxmlcryptoIBMXMLCryptoProvider securityprovider8=comibmxmlencIBMXMLEncProvider securityprovider9=orgapacheharmonysecurityproviderPolicyProvider securityprovider10=comibmsecurityjgssmechspnegoIBMSPNEGO Add the highlighted provider to the table as the first entry some IBM Java implementations include the FIPS provider as a comment If the FIPS provider is commented out remove the sign from the entry if it is not insert the highlighted line This will make the IBMJCEFIPS provider the first provider The order of the providers is significant They are listed in their order of preference The IBMJCEFIPS provider must be listed first You will need to fix the provider number since you now have two number one providers Change the numbers accordingly for each provider You should now have something similar to the following Note that different IBM Java implementations may have different provider names You must change the provider number of all providers however no other changes are needed to any other provider List of providers and their preference orders (see above) securityprovider1=comibmcryptofipsproviderIBMJCEFIPS securityprovider2=comibmjsse2IBMJSSEProvider2 securityprovider3=orgbouncycastlejceproviderBouncyCastleProvider securityprovider4=comibmcryptoproviderIBMJCE securityprovider5=comibmsecurityjgssIBMJGSSProvider securityprovider6=comibmsecuritycertIBMCertPath

securityprovider7=comibmsecuritysaslIBMSASL securityprovider8=comibmxmlcryptoIBMXMLCryptoProvider securityprovider9=comibmxmlencIBMXMLEncProvider securityprovider10=orgapacheharmonysecurityproviderPolicyProvider securityprovider11=comibmsecurityjgssmechspnegoIBMSPNEGO When you are done editing this file save your changes Step 2 Set the Slingshot environment variable FIPS_MODE to true in the setenvsh file The setenvsh file is located in the ltSlingshot Install Directorygtserverbin directory This script sets environment variables need by the Slingshot server The file should look like the following binsh CATALINA_OPTS=-Xms512m -Xmx1024m FIPS_MODE=false Change the value of FIPS_MODE from true to false You should now have the following binsh CATALINA_OPTS=-Xms512m -Xmx1024m FIPS_MODE=true When you are done editing this file save your changes Step 3 Set the SSHSecurityProvider parameter in the webxml file to the FIPS certified cryptographic provider name The webxml file is located in the ltSlingshot Install DirectorygtserverwebappscfccWEB-INF directory This file sets some parameters used by the Slingshot server You should see a section like the following in the file ltcontext-paramgt ltparam-namegtSSHSecurityProviderltparam-namegt ltparam-valuegt ltcontext-paramgt Change the param-value to comibmcryptofipsproviderIBMJCEFIPS You should now have the following ltcontext-paramgt ltparam-namegtSSHSecurityProviderltparam-namegt ltparam-valuegt comibmcryptofipsproviderIBMJCEFIPSltparam-valuegt ltcontext-paramgt When you are done editing this file save your changes Step 4 Restart the server Run the shutdownsh script in the ltSlingshot Install Directorygtserverbin directory Run the startupsh script in the ltSlingshot Install Directorygtserverbin directory

42 Taking the Slingshot server out of FIPS mode The following describes how to manually take the Slingshot server out of FIPS mode if you have enabled it There are four steps necessary to take Slingshot out of FIPS mode

1 Remove FIPS certified cryptographic provider from the list of providers in the javasecurity file 2 Set the Slingshot environment variable FIPS_MODE to false in the setenvsh file 3 Remove the provider name from SSHSecurityProvider parameter in the webxml file 4 Restart the server

If you manually enabled FIPS mode you will have to undo the changes you made when putting Slingshot into FIPS mode If FIPS was automatically configured during installation see the section ldquoConfigure FIPS mode Manuallyrdquo for more details on which files to edit Note When removing the cryptographic provider from the javasecurity file you can either comment out the line with the sign or delete the line You must fix the order of the providers after that

Slingshot Installation Guide Slingshot Software License Keys

5 Slingshot Software License Keys Slingshot requires a set of software license keys to operate The product comes with 1 set of 60 day temporary keys that will allow 50 users (2 are assigned to predefined users admin and ssadmin for demonstration purposes only) The two license keys used by the Slingshot application are

bull The Slingshot Database Key - This key controls the number of users that can be defined to the

Slingshot database with the assigned right of TransferRight This license key is also tied to the JDBC Connection URL used to connect to your Slingshot Database

bull The Slingshot Server Key - This key is installed on each J2EE Server that will be running the Slingshot application This key is tied to the host name of the server hosting the Slingshot application If there are multiple machines that will be hosting instances of Slingshot each one of these machines must have a license key

Slingshot Software License Keys Slingshot Installation Guide

51 Applying the Software License Keys When you need new keys for Slingshot follow the instructions below to view your present license keys and to apply new keys to your system

In order to get the information required for TIBCO to create new Slingshot keys the Slingshot application must be installed Once that is done go to the Slingshot Administrator web site using the following URL from your browser filling in your DNS host name and https port you are using

https[DNS_HostName][httpsPort][context]controlview=viewadminstartjsp By default the https port for the web server is

bull Default SSL Port ndash 8443

Navigate to the Host Information screen and you will see something similar to the following license information

Take a screen shot of the Host Information or copy and paste the information into an email and send it to proginetsupporttibcocom To apply the new keys you receive from TIBCO you would navigate to Management gt License gt Add License Key and enter the appropriate information in the following fields for each database and server key

bull Server Name

Cut and paste either the Server Host Name or the Database Connection URL you emailed to TIBCO Server Type

bull Select the type of license Key you are inserting (either DB or SERVER)

License Key

Cut and paste in the license key that is affiliated with the Server Name field above

Once the fields are filled in click the Apply button Do this for each license key you receive

Customizing Slingshot Slingshot Installation Guide

6 Customizing Slingshot

61 Logos Admin Pages

bull Slingshot Administrator logo (upper left corner)

o Path and File Name cfccviewimageslogogif o Height 50 px o Width 136 px

bull TIBCO logo (bottom left)

o Path and File Name cfccviewimagestibco-logo-117-24jpg o Height 24 px o Width 117 px

Slingshot End User Web Browser Interface Used for the following pages

Reset Password Forgot Username Self Registration Login Help

bull Browser Interface web pages (upper left corner)

Slingshot Installation Guide Customizing Slingshot

o Path and File Name cfccamloginimageslogogif o Height 64 px o Width 194 px

Slingshot Send Files Page Header

bull Background image of the header

o Path and File Name cfccviewimagesambg_headerjpg o Height 65 px o Width 623 px

bull Header logo image fixed to left side of the header

o Path and File Name cfccviewimagesamlogogif o Height 64 px o Width 194 px

Footer bull Company logo fixed in lower left area of the footer

o Path and File Name cfccviewimagesamtibco-logogif o Height 24 px o Width 74 px

Slingshot Login Page bull Product logo centered above sign in area

o Path and File Name cfccamloginimagesproduct-logogif o Height 77 px o Width 236 px

bull Image for sign on button

o Path and File Name cfccamloginimagessign-in-buttongif o Height 30 px o Width 91 px

bull Background image

o Path and File Name cfccamloginimageslogin-backgroundgif o Height 491 px o Width 469 px

bull Icon positioned to the left of the centered product logo

o Path and File Name cfccamloginimagesproduct-icongif o Height 114 px o Width 72 px

bull TIBCO image on lower right

o Path and File Name cfccamloginimagescompany-logogif o Height 27 px o Width 86 px

Please follow these steps for customizing your Slingshot logos

1 Locate the directory where the logos are stored 2 Rename the logo that is being replaced by adding OLD after GIF (eg logogifold) 3 Copy your new logos into the directory and make sure the file names match the original file names

in the directory 4 Refresh your browser

Note Your new logos should be the same size as the Slingshot logos being replaced

62 Email Templates Slingshot uses a standard set of templates for outgoing emails These files are in XML format and can be edited using an XML editor The files can be found in the following directory

cfccemail-template

List of the templates that can be edited with their file names

1 Alert Notifications email-alert-notification-templatexml

2 Default template sent on every Slingshot email Slingshot-file-available-templatexml

3 Download Notification Template Slingshot-file-downloaded-templatexml

4 Forgot User Name Request Slingshot-forgot-username-templatexml

5 Disabled Email Notification Slingshot-recall-message-templatexml

6 Self Registration Success Slingshot-register-success-templatexml

7 Self Registration Request Slingshot-register-user-templatexml

8 Reset Password Request Slingshot-reset-password-templatexml

9 Reset User Name and Self Registration Unsuccessful Slingshot-reset-username-register-failure-templatexml

Please follow these steps for customizing your Slingshot email templates

1 Locate the cfccemail-template directory where the templates are stored Rename the template that is being replaced by adding OLD after XML (eg email-alert-notification-templatexmlold)

2 Copy your new template into the directory and make sure the file name matches the original file name in the directory

3 Any new emails sent from the server will use the new email template

Outlook Plug-in Install Slingshot Installation Guide

7 Slingshot Outlook Plug-in Install 71 Desktop Install

As mentioned in Step 5 Slingshot comes with 2 interfaces We will now discuss Slingshotrsquos second interface the Outlook Plug-in This plug-in allows the end user to utilize all Slingshotrsquos functions from the popular Microsoft Outlook Application The pre-requisites required for installing the Slingshot plug-in can be found in section 22 The end user or administrator would download the plug-in by using the following URL filling in your DNS host name and https port you are using

https[DNS_HostName][httpsPort][centext]controlview=amstartjspampaction=configam

You will see a page similar to the one below

Figure 14 As you can see from Figure 14 the end user can download the installation as an executable or in zip file format The executable file can be used if you have the pre-requisites installed already or if you are upgrading from a prior Slingshot plug-in Otherwise you will want to download the product contained in the zip file Simply click on the link of the one you would like to start the download Note For our example we will be using the setupexe which is contained in the Slingshot Outlook Plug-in Zip File to install the plug-in product on a system for the first time Running the install using the setupexe is recommended because it will install everything the product needs except for the Microsoft NET Framework (Please go to Microsoftcom to download v 20 or higher and follow Microsoftrsquos instruction to install it) The first component it will look for is the Microsoft Visual

Slingshot Installation Guide Outlook Plug-in Install

Studio 2005 Tools for Office runtime If this is not found you will be prompted to install it as seen in Figures 15 and 16 below

Figure 15

Figure 16 A reboot of the system may be required at this point Once you have installed the Microsoft runtime library and rebooted your system if required you may have to double click on setupexe again Slingshot will then detect if you have the 2007 Primary Interop Assemblies programs installed or not and if not it will install the programs for you These components are needed for the Slingshot Outlook plug-in interoperability between its NET managed code and Microsoft Office COM libraries Once this install is complete you may have double click on setupexe again in order to install the Slingshot Outlook Plug-in as seen in Figures 19 ndash 24

Figure 19

Figure 20

Figure 21

Figure 22

Figure 23

Figure 24

Slingshot Installation Guide Outlook Plug-in

The plug-in is now installed For more information on how to use the Outlook Plug-in please see the Slingshotv181 User Guide

72 Silent Install The Slingshot Outlook Plug-in can be deployed throughout your environment through a silent install Below are general instructions to follow when using Microsoft System Management Server (SMS) Note Every computer receiving the Slingshot Outlook Plug-in must meet the pre-requisites described in the Slingshot Release Notes

If using collections that were previously defined make sure to update the collection before deployment

1 Define your distribution points for the package 2 Create a new collection or use a predefined collection to specify clients which will receive the

Slingshot install 3 Gather all source files setup routines scripts and so on needed for the package 4 Create the Configuration Manager package 5 Define the Slingshot program for the package

6 On the General program configuration page define the ldquoCommand linerdquo parameter AMURL for the SlingshotOutlookPlugInmsi (See example below)

7 Distribute the package to the distribution points 8 Advertise the programs to one or more collections 9 Execute the advertised program on the client

Example of SMS Command Line with options for Slingshot Outlook Plug-in program deployment SlingshotOutlookPlugInmsi q AMURL=https[host][port][context] For more details on using SMS for silent installations please refer to Microsoftrsquos online SMS Guides httptechnetmicrosoftcomen-uslibrarybb735860aspx

73 Hiding the Slingshot Send button in Outlook 2003 For Outlook 2003 Clients the Slingshot Send button can be hidden from the Outlook 2003 Slingshot toolbar by adding the following registry key value HKEY_LOCAL_MACHINESOFTWARETIBCOSlingshotHideSendButton Set to DWORD 1

Slingshot Installation Guide Uninstall

8 Uninstall In order to uninstall Slingshot use the uninstall batch job located in the Slingshot_install directory From the command line run the following command on either Windows or UNIX

uninstall

You will see the following

uninstall java -cp installerjar comTIBCOsiftinstallinstallerSIFT Installer uninstall Removing SSL Configuration Removing Security Configuration Uninstalling CFCC Application Deleted distribution directory Uninstall complete

Your Slingshot uninstall is complete

Worksheet Slingshot Installation Guide

A Install Worksheet This worksheet is provided to gather information prior to the install of Slingshot Web Server Information 1 Which version of Java JDK is installed on the server ______________________

2 Do you have variables ldquoJAVA_HOMErdquo and ldquoPATHrdquo set ________________

3 Have you downloaded and installed the Java AES encryption policy files _________________________

Database Information 4 What is the IP NameAddress and port number for the Slingshot database _________________________

5 What is the name of the database to be used for Slingshot _____________________________________ 6 What is the id and password for the database _____________________________________ Java Keystore Information (This information is optional Slingshot will create a keystore if one is not provided) 7 What is the path and file name of your java keystore ___________________________________________

8 What is your keystore password _______________________ 9 What is the alias for the private key ________________________ Slingshot Application Information 10 What is the IP NameAddress of the server where Slingshot will be installed ___________

11 What context root do you want to use (default is cfcc) ______________________________ 12 In what directory should log files be kept (defaults to install directory) ______________________________ LDAP Information (This information is optional because you may not be using LDAP for authentication) 13 LDAP server type ___________________________

14 DNS or IP Address of the LDAP server ______________________________ 15 What is the LDAP port number _________________________

16 What is the LDAP Administrator DN ________________________________________________________ 17 What is the password for the User DN ___________________________

Data Store information 18 Where will attachments for the Slingshot Server be stored Local Hard Disk ____

TIBCO MFT Platform Server ____ Other Storage Device ____ 19 Name the folder where active Slingshot attachments will be stored _______________________

Email Server Information 20 What is the IP NameAddress and port of the email server being used by Slingshot ___________________

21 Has the right to relay SMTP emails been granted to the Slingshot server __________

1 Supported Systems amp Pre Requisites

11 Firewall Ports

2 Creating the Slingshot Database

3 Installing Slingshot

31 Java Memory Size



34 URL Redirection

4 FIPS 140-2 Manual Configuration

41 Enable FIPS Mode Manually

42 Taking the Slingshot server out of FIPS mode

5 Slingshot Software License Keys

51 Applying the Software License Keys


61 Logos

62 Email Templates

7 Slingshot Outlook Plug-in Install

71 Desktop Install

72 Silent Install

73 Hiding the Slingshot Send button in Outlook 2003

8 Uninstall

A Install Worksheet