Más contenido relacionado La actualidad más candente (15) Similar a How to use the Social Business Development Environments (20) Más de IBM Connections Developers (16) How to use the Social Business Development Environments1. How to use the
Social Business Development Environments
Paul Bastide
Software Engineer
Application Development
IBM SBT Webinar
25 September 2013
2. © 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
3. © 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
4. © 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
Easy
Quick
Done Right
5. © 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.
6. © 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
7. © 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
8. © 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
9. © 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
10. © 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 at
http://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, you
Can add any software you want.
Metrics
Connections Content Manager
* be sure to provision with the right amount of resources
3.0
11. 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.
13. 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
14. There are key announcements on the right... pay attention.
Also... no confidential data.
15. 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
16. 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
17. 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
19. © 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
20. © 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
22. © 2013 IBM Corporation
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
23. © 2013 IBM Corporation
Click on 3.0
Image
Click Next
24. © 2013 IBM Corporation
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
25. © 2013 IBM Corporation
Review the Settings
Click Next
26. © 2013 IBM Corporation
Select I Agree
Click Submit
27. © 2013 IBM Corporation
Click Return to
Control Panel
Click on
The Instance
28. © 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.
29. © 2013 IBM Corporation
Instance
Specific
Details
Instance
Controls
30. © 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.
31. © 2013 IBM Corporation
Navigate to https://hostname
Click Add
Exception
Click Get
Certificate
Click Permanently Store
Click Confirm
Security Exception
32. © 2013 IBM Corporation
Navigation
For QSI
Click Homepage
33. © 2013 IBM Corporation
Notice the different Port
Click Add Exception Click Confirm Security Exception
34. © 2013 IBM Corporation
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
35. © 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
Demo
https://vhost0633.dc1.on.ca.compute.ihost.com/redirectQSI.html?=4
36. © 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.
37. © 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
38. © 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
39. © 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
40. © 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.
41. © 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/resour
ces/web/com.ibm.lconn.gadget/test/bootstrap.html?
render=test&oneui=3
42. © 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
43. © 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
44. © 2013 IBM Corporation44
Configuration : Record Key Ports and Hostnames and URLs
● URLs
● Key Ports
● Hostnames
● Make Bookmarks
● Serverindex.xml
45. © 2013 IBM Corporation45
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
46. © 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...
47. © 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
48. © 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.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.