How to use the Social Business Development Environments

Paul BastideSoftware Engineer

Application Development

IBM SBT Webinar 25 September 2013

© 2013 IBM Corporation2

Social Business Toolkit Webinars

● Previous webinars – recordings on YouTube.com/ibmsbt● How to add your own OpenSocial Gadgets to IBM Connections● How to access the Activity Stream in IBM Connections● How to extend IBM Connections Communities and Profiles● How to enhance Email with Embedded Experiences● How to use the IBM Social Business Toolkit in XPages● How to use the IBM Social Business Toolkit in Java Applications● How to use the IBM Social Business Toolkit in HTML/JavaScript

Applications

● Future webinars – listed on ibmdw.net/social/events● 10/23: IBM iNotes and SmartCloud Notes Web Customization● 10/08 (?): Widgets and live text in IBM Notes and iNotes● November: IBM SmartCloud for Social Business Extensibility

© 2013 IBM Corporation

IBM Connections App Dev Contest

● http://connectionscontest.openntf.org

● Chance to win 5 x $1000

● Submit your open source project until November 3rd

● All types of OpenNTF projects can be nominated that utilize IBM Connections

● Developers can use a free shared development environment in the cloud

© 2013 IBM Corporation4

Abstract

Developers spend time extending, adding and leveraging IBM Social Business features – profiles, blogs, wikis, embedded experiences, and much more. IBM has invested in ways to improve your development experience, and focus you on developing, not administrating.

This session introduces the IBM Collaboration Quickstart for Social Business, describes the various versions available in the preconfigured development and test environment, talks about using the IBM SmartCloud Enterprise, and talks about lessons learned in developing with the SmartCloud Enterprise. The session also talks about and compares the use of partner images, IBM Greenhouse, the Quickstart and the SmartCloud for Social Business.

develops

EasyQuick

Done Right

© 2013 IBM Corporation5

Disclaimers

IBM’s statements regarding its plans, directions, and intent are subject to change or withdrawal without notice at IBM’s sole discretion.

Information regarding potential future products is intended to outline our general product direction and it should not be relied on in making a purchasing decision.

The information mentioned regarding potential future products is not a commitment, promise, or legal obligation to deliver any material, code or functionality. Information about potential future products may not be incorporated into any contract. The development, release, and timing of any future features or functionality described for our products remains at our sole discretion.

Performance is based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput or performance that any user will experience will vary depending upon many factors, including considerations such as the amount of multiprogramming in the user’s job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve results similar to those stated here.

© 2013 IBM Corporation6

Agenda

● Prerequisites ● Social Business Development Environments

● IBM Collaboration Quickstart for Social Business● IBM SmartCloud for Social Business● IBM Greenhouse● On Premises

● Lessons Learned● Where and How to Create an Instance● Development and Test with Certificates [SSL]● Quick Developer Tests ● Environment Validation● Updating Plugins and Databases● Using | Updating | Connecting IBM Social Business Toolkit

© 2013 IBM Corporation7

Prerequisites

Prerequisites is a loose term to describe the things you should consider when and how you prepare to integrate with Social Capabilties.

● Understand the Social Capabilities● Determine the Capabilites Needed● Review the Architectual Stack in a Fully

Integrated Environment● Understand the Integration Flow

● Networking is Critical● Identify Developer Mode vs Out-of-Box

© 2013 IBM Corporation8

Choosing the Right Social Business Development Environment

● The sesion started talking about capabilities and prerequisites, mixing in some terms which indicate preconfigured development and test environments you should consider.

● The various environments are :

● IBM Collaboration Quickstart for Social Business

● IBM Greenhouse● IBM SmartCloud for Social

Business. ● On Premises / Partner

Demonstration Images

Capabilities

Products

Integration Flow

Environment

© 2013 IBM Corporation9

IBM Collaboration QuickStart for Social Business

IBM Collaboration Quickstart for Social Business is an IBM SmartCloud™ Enterprise image. ● Preinstalled with 85 user profiles,

including names, email addresses, user photos, and more.

● Designed for ease of use and minimal administration

● Quickly get an instance without any installation, hardware, or maintenance.

● All you need is Internet Access.

Navigate to Cloud Development Page- and -

It's pay-as-you-go

4 versions... to aid developers...

1.0 2.0 2.5 and 3.0

© 2013 IBM Corporation10

Versions

IBM Connections 4.0

IBM Domino® 8.5.3 FP3

IBM Sametime® community server 8.5.2 IFR1

IBM Sametime Proxy Server 8.5.2 IFR1

IBM Connections 4.0 CR3

IBM Domino® 9.0 IF1

IBM Sametime® community server 8.5.2 IFR1

IBM Sametime Proxy Server 8.5.2 IFR1

IBM Social Business Toolkit / Playground / TroubleTickets

2.0

2.5

Ongoing trial has details athttp://bit.ly/1asoXsZ

IBM Connections 4.5 CR1

IBM Domino® 9.0 IF1 + Social Edition

IBM Sametime® community server 8.5.2 IFR1

IBM Sametime Proxy Server 8.5.2 IFR1

IBM Social Business Toolkit / Playground / TroubleTickets

+ Latest Build

3.0Note, once you have an instance, youCan add any software you want.

Metrics Connections Content Manager

* be sure to provision with the right amount of resources

3.0

IBM SmartCloud Enterprise

IBM SmartCloud Enterprise provides infrastructure as a service for developers and application providers who wish to scale out for an opportunity or in order to integrate with a solution.

The SmartCloud Enterprise provides a catalog of images which you can use to rapidly develop solutions. http://ibm.co/P1063C

Global and Direct Access to Internet

Select from a Catalog

Rapidly Create as many machines as necessary.

Datacenters

12

Markham

BoulderRaleigh

Singapore

Japan

Germany

IBM Greenhouse

IBM Greenhouse is a demonstration environment where you will be able to collaborate with the people in different ways. Schedule online meetings or instant message them through our Sametime infrastructure; and engage in social networking through sharing bookmarks, blogs, communities, and activities by leveraging IBM Connections.

● There is no Service Level Agreement.

● Thursday is deployment day, expect limited availability in the morning.

● Explore a vareity of upcoming ICS projects and products.

● You can access greenhouse here

No Callbacks. No iWidgets

Some OpenSocial Gadgets with Social Edtion

Most Access is via Basic AuthLimited Demo Accounts

There are key announcements on the right... pay attention. Also... no confidential data.

IBM Social Business Toolkit Playground on IBM Greenhouse

The SBT Playground is a web-based live demonstration of the JavaScript APIs and Java APIs that are exposed by the SDK, and the API Explorer. The Playground contains a large set of code snippets and examples that you can customize and use in your own applications.

You can navigate to the https://greenhouse.lotus.com/sbt/SBTPlayground.nsf

Learn and Experiment

IBM SmartCloud for Social Business

● The IBM SmartCloud for Social Business offers collaboration, Web conferencing, and email. These solutions enable users to meet online, share files, chat, manage projects, and network with others in the social business community, anywhere and anytime.

● You can sign up for a trial at link

● You can generate an organization specific OAuth Key.

Add Menu Extensions Connect via BasicAuth, SAML, OauthNo iWidgets or OpenSocial Gadgets

On Premises and Partner Images

● You can do anything. ● Sametime● Connections● Domino

● IBM Partners can contact your IBM Representative for a Demo image in order to understand and demonstrate IBM Connections and IBM Sametime.

● Ping Paul for your region's contacts

Lessons Learned are going to help you.

But focus on getting the networking right.

Real Hostname. Real IPs.

Less Problems.

You HAVE 100% control. Like SCE

Comparisions

SmartCloud for Social Business has a trial for ISVs.Check with your IBM Sales Rep for latest costs.

© 2013 IBM Corporation19

Lessons Learned

● Development environments have many lesssons, these are just a few of the interesting ones :● Where and How to Create an Instance● Development and Test with Certificates [SSL]● Commands Use and Configurations● Quick Developer Tests and Environment

Validation

© 2013 IBM Corporation20

How to create a new instance

● The preconfigured image launches you into each capability, and you can connect from your development environment. More details at link

© 2013 IBM Corporation

Add Instance

© 2013 IBM Corporation

Select Preferred Data CenterClosest to You and Your Customer

Filter to find*uick*

Click FilterChooseA data

Center Close to your Customer and You

© 2013 IBM Corporation

Click on 3.0Image

Click Next

© 2013 IBM Corporation

Enter the Name of YourInstance It can be changed

No Key Listed? The Next Chart shows

how to create oneClick

MinimizeLocal Disk

Speeds Up Deployment

Click Next

© 2013 IBM Corporation

Review the Settings

Click Next

© 2013 IBM Corporation

Select I Agree

Click Submit

© 2013 IBM Corporation

Click Return toControl Panel

Click on The Instance

© 2013 IBM Corporation

You won't get a hostname / IP until the instance is copied in place from the master image. Once you get the IP/Hostname, the service takes approximately 15 to 30 minutes to provision.

You'll get Connection Refused warning from SSH / Putty until it's ready.

© 2013 IBM Corporation

Instance Specific Details

InstanceControls

© 2013 IBM Corporation

Development and Test with Certificates [SSL]

● There are three keys to certificates. ● Your Development Client

Browser● Social Capabilities

● WebSphere as a Consumer● Domino as a Consumer

● Your Development Server

● Certificates enable Trust, specifically by default communication for OAuth requires the Trust.

● Also real certs cost money, and are expensive.

© 2013 IBM Corporation

Navigate to https://hostname

Click Add Exception

Click GetCertificate

Click Permanently Store

Click Confirm Security Exception

© 2013 IBM Corporation

NavigationFor QSI

Click Homepage

© 2013 IBM Corporation

Notice the different Port

Click Add Exception Click Confirm Security Exception

© 2013 IBM Corporation

Login as Frank Adams fadams@renovations.comUse your User Password Use IBM Connection Mail

It supports Embedded Experiences

Use Sametime Web Client

Use the Activity Streams

© 2013 IBM Corporation

Establishing Trust / Secure Communications

● There is a need to establish a callback, or integrate the services from a third party with Social Capabilities.

● There are two articles which the team has assembled.● Adding Secure Communications

to your Development● Adding Trust to your

Development Environment

Demohttps://vhost0633.dc1.on.ca.compute.ihost.com/redirectQSI.html?=4

© 2013 IBM Corporation36

Commands Use and Configurations

● The quickstart has many commands wrapped for your use. ● pxStatus – controls sametime● checkLargestFiles.sh – checks

for the largest files on the system so you can manage space

● qsiKill.sh – force the stop of a service

● qsiStatus – manage all services● Manage Domino Services

● dominoRestart.sh ● dominoStart.sh● dominoStop.sh

● sbtStatus – manage the sbt services

● lcStatus – manage connections

Demo of Commands

Also of interest /etc/init.d/DB.init

They provide a wrapper for the Init services

Note, if the INSTANCE is restarted, the Services aren't automatically restarted.

You have to start them via terminal.

© 2013 IBM Corporation37

Matching your Environment

● The QuickStart is managed from scripts and properties in /local/qsi

● You can change the hostname via setting the name and IP in /local/qsi/props/qsi.properties

● You can then run /local/qsi/user/changeHostname.sh

● This setup is handy when I want to share a SSO domain with a custom site, or match my personal domain.

● Instead of vhost0999.dc1.on.ca.compute.ihost.com, I can use connections.bastide.org

● You can also add users to domino, and then automatically populate them in Connections using /local/qsi/user/populateUsers.sh

© 2013 IBM Corporation38

Further Tips on Using an Image

● Further there are articles posted on the Quickstart documentation which details how to Change Admin Passwords for Sametime and for Connections.

● You can change ports for connections, you can change ports for sametime you can change anything in these setups. ● All Through the Consoles. ● I Recommend leaving them at

defaults. ● If you can't find the right port, or

expected look for serverindex.html

● You can generate an oauth key ● ./generateOAuthKey.sh test test

https://mycallback/url● You get a response back with a

url. ● You can also list all the keys on

the system ● ./listOAuthKeys.sh

Demo

© 2013 IBM Corporation39

Networking is Critical... for the integration flow...

● Simplistic yes, but it's the #1 reason why things aren't working at first setup of a development environment.

● SmartCloud Enterprise and Greenhouse and SmartCloud for Social Business have real hostnames with real server names.

● When in doubt, check the following : ● Name Resolution ● Network Flow● Service Connectivity

● You should do all the checks From Development Services and From Server and from the Developer Workstation

ping

nslookup

Hosts file

DNS

IP

Hostname

web browser

hostname / port

check all services

© 2013 IBM Corporation40

Networking – Why you should care...

● The services are setup with hostnames. ● Server Configuration in Domino ● Internet Sites in Domino● LotusConnections-config.xml controls the

URLs to Capabilities, Custom JavaScript and CSS Design paths for IBM Connections.

● … if you don't, it won't work as you expect.

● When you have dynamic ips, it can lead to confusion.

● Sametime is very forgiving about IP vs Hostname, but preference is hostname.

© 2013 IBM Corporation41

Understand how to enable developer friendly modes

● The SmartCloud for Social Business enables a User/Organization to register and access capabilities using Basic Authentication and via OAuth, that's all you have for developer modes.

● IBM Greenhouse enables you to register as a partner/developer and use Basic Auth to develop an integration without callbacks or gadgets.

● IBM Collaboration Quickstart is setup with all the right tweaks for UI/Whitelists/Developer Modes.

● On Premises requires you enable UI Debugging and Disable Whitelists and setup Social Edition

https://sbtdev.swg.usma.ibm.com:444/connections/resources/web/com.ibm.lconn.gadget/test/bootstrap.html?render=test&oneui=3

© 2013 IBM Corporation42

Understand how to enable developer friendly modes

● IBM Connections 4.5 Install● Developing OpenSocial Gadgets + You need to add whitelists = false. ● Enable Customization Debugging● IBM Domino Social Edition Cokbook● Enable Domino Data Services

● The Speed and Resource optimization is best when installing the capabilities in a SINGLE Application Server for each major product.

● In the many of these development environments, you are given the settings by default.

● The IBM Collaboration Quickstart contains all these settings enabled, and settings enabled for the most rapid development, and wrapped with helper scripts.

Active links

© 2013 IBM Corporation43

Use : Known Issues using the Various Environments

● The QuickStart has the latest support for Security Stanards and setup which are scanned before we put the image out. ● We check fix pack levels. ● We check SSL practices. ● We setup internet sites, and

security which matches as much as possible production environments.

● Note the SDK is an older build in the quickstart - 07 09 2013

● It's difficult to include every capability on a single VM.

● Not included are : ● Metrics● Connections Content

Management● Sametime AV

● Link to Article of Known Issues

© 2013 IBM Corporation44

Configuration : Record Key Ports and Hostnames and URLs

● URLs● Key Ports● Hostnames● Make Bookmarks● Serverindex.xml

© 2013 IBM Corporation45

Quick Developer Tests and Environment Validation

OneUI Link to Test GadgetsLink to OneUI TestLogin to the Homepage (*if not this is a sign the oauth filter needs to trust the SSL Certificate for the HTTP Server)Can you Post ? Do you see Firebug Traffic ? Can you navigate to the other services ? Can you connect with others ?Is Frank Alone ? Or can you see him via search ?

User Ids are all listed on the welcome page.

Demo

© 2013 IBM Corporation46

Summary

● You now know the different development environments. ● You know which ones enable you to do what, and how to select which

one meets your needs. ● You also know the tips and tricks which commonly aid developers, and

speed development. ● You also know how to provision a Quickstart

● Go Forth.... Develop... Ask questions... Develop some more...

© 2013 IBM Corporation47

Resources and Questions

● Home page: http://ibmdw.net/social● SDK: http://ibmsbt.openntf.org● GitHub: https://github.com/OpenNTF/SocialSDK● StackOverflow: #ibmsbt● Twitter: @ibmsbt● YouTube: http://youtube.com/ibmsbt● Playground: http://bit.ly/sbtplayground● Appathon Contest 

© 2013 IBM Corporation48

Acknowledgements and Disclaimers

© Copyright IBM Corporation 2013. All rights reserved.– U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with

IBM Corp.

IBM, the IBM logo, ibm.com, Rational, the Rational logo, Telelogic, the Telelogic logo, Green Hat, the Green Hat logo, and other IBM products and services are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” at www.ibm.com/legal/copytrade.shtmlOther company, product, or service names may be trademarks or service marks of others.

Availability: References in this presentation to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates.

The workshops, sessions and materials have been prepared by IBM or the session speakers and reflect their own views. They are provided for informational purposes only, and are neither intended to, nor shall have the effect of being, legal or other guidance or advice to any participant. While efforts were made to verify the completeness and accuracy of the information contained in this presentation, it is provided AS-IS without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, this presentation or any other materials. Nothing contained in this presentation is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software.

All customer examples described are presented as illustrations of how those customers have used IBM products and the results they may have achieved. Actual environmental costs and performance characteristics may vary by customer. Nothing contained in these materials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specific sales, revenue growth or other results.