How to use the Social Business Development Environments
Upcoming SlideShare
Loading in...5
×
 

How to use the Social Business Development Environments

on

  • 1,335 views

Speaker: ...

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.

Statistics

Views

Total Views
1,335
Views on SlideShare
1,333
Embed Views
2

Actions

Likes
0
Downloads
27
Comments
0

1 Embed 2

https://twitter.com 2

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

How to use the Social Business Development Environments How to use the Social Business Development Environments Presentation Transcript

  • 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
  • © 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
  • © 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 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
  • 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.
  • © 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 Center Closest to You and Your Customer Filter to find *uick* Click Filter Choose A data Center Close to your Customer and You
  • © 2013 IBM Corporation Click on 3.0 Image Click Next
  • © 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
  • © 2013 IBM Corporation Review the Settings Click Next
  • © 2013 IBM Corporation Select I Agree Click Submit
  • © 2013 IBM Corporation Click Return to Control 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 Instance Controls
  • © 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 Get Certificate Click Permanently Store Click Confirm Security Exception
  • © 2013 IBM Corporation Navigation For 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.com Use 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 Demo https://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/resour ces/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 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
  • © 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.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.