How to use the Social Business Development Environments

How to use the
Social Business Development Environments
Paul Bastide
Software 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

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
Easy
Quick
Done Right

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.

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

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

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

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

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 Social Business Toolkit / Playground / TroubleTickets
2.0
2.5
Ongoing trial has details at
http://bit.ly/1asoXsZ
IBM Connections 4.5 CR1
IBM Domino® 9.0 IF1 + Social Edition
IBM Social Business Toolkit / Playground / TroubleTickets
+ Latest Build
3.0Note, once you have an instance, you
Can 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
Boulder
Raleigh
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 Auth
Limited 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, Oauth
No 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.

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

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

Add
Instance

Select Preferred Data Center
Closest to You and Your Customer
Filter to find
*uick*
Click Filter
Choose
A data
Center Close to your
Customer and You

Click on 3.0
Image
Click Next

Enter the Name of Your
Instance It can be changed
No Key Listed?
The Next Chart shows
how to create one
Click
Minimize
Local Disk
Speeds Up
Deployment
Click Next

Review the Settings
Click Next

Select I Agree
Click Submit

Click Return to
Control Panel
Click on
The Instance

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.

Instance
Specific
Details
Instance
Controls

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.

Navigate to https://hostname
Click Add
Exception
Click Get
Certificate
Click Permanently Store
Click Confirm
Security Exception

Navigation
For QSI
Click Homepage

Notice the different Port
Click Add Exception Click Confirm Security Exception

Login as Frank Adams fadams@renovations.com
Use your User Password Use IBM Connection Mail
It supports Embedded Experiences
Use Sametime Web Client
Use the
Activity
Streams

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
Demo
https://vhost0633.dc1.on.ca.compute.ihost.com/redirectQSI.html?=4

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.

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

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

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

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.

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/resour
ces/web/com.ibm.lconn.gadget/test/bootstrap.html?
render=test&oneui=3

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

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

Configuration : Record Key Ports and Hostnames and URLs
● URLs
● Key Ports
● Hostnames
● Make Bookmarks
● Serverindex.xml

Quick Developer Tests and Environment Validation
OneUI Link to Test Gadgets
Link to OneUI Test
Login 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

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...

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

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.shtml
Other 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.

How to use the Social Business Development Environments

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Was ist angesagt?

Was ist angesagt? (15)

Ähnlich wie How to use the Social Business Development Environments

Ähnlich wie How to use the Social Business Development Environments (20)

Mehr von IBM Connections Developers

Mehr von IBM Connections Developers (16)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

How to use the Social Business Development Environments