Upload
ibm-connections-developers
View
1.804
Download
0
Tags:
Embed Size (px)
DESCRIPTION
Speaker: Paul Bastide, @prb112 IBM Software Engineer, Social Business Toolkit 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.
Citation preview
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 [email protected] 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.