XPages Extension Toolkit Installation Lance Spellman   |   President, WorkFlow Studios
Find Extlib Project on OpenNTF <ul><li>Go to  http://openntf.org
Find the Xpages Extension Library project </li><ul><li>Look in Featured Projects scroller
Or, go to Projects tab – numerous ways to locate it there </li></ul></ul>
Download from Releases Page <ul><li>Go to Releases, download latest to Desktop </li><ul><li>ALREADY DONE FOR LAB </li></ul...
Open Download from Desktop <ul><li>Go to the Windows desktop
Locate the file “XpagesExtensionLibrary.zip” (top-left corner)
Double-click and extract to c:extlib-extract </li></ul>
Extracting to new folder c:extlib-extract
Verify file extraction <ul><li>Should have files like the picture below </li></ul>
Install Eclipse Plugin to Domino Designer <ul><li>For Domino Designer, the Extension Library is deployed as an Eclipse Plu...
The updateSite.zip file in the extract contains the plugin
Turn on ability to install plugins in Domino Designer </li><ul><li>In Domino Designer, go to File Preferences
Select “Domino Designer”
Checkmark option for “Enable Eclipse plug-in install” </li></ul></ul>
File | Application | Install menu available <ul><li>Now, a new menu option under File | Application should be available </...
Search for New Features <ul><li>A dialog box for Install/Update appears with choice for “Search for Updates” or “Search fo...
Choose radio button for “Search for New Features...” </li></ul>
Add Zip File Location <ul><li>For Application Locations dialog, choose “Add Zip/Jar Location” </li></ul>
Choose UpdateSite.zip file <ul><li>Go to the  c:extlib-extract  directory and locate the UpdateSite.zip file </li></ul>
Verify the updateSite location <ul><li>The dialog should now have the updatesite.zip file in the Location list and be chec...
Click the Finish button on the dialog </li></ul>
Select features to install <ul><li>A new dialog appears with a prompt to select the features to install
Check the box for the updateSite.zip
Click the Next button </li></ul>
Accept the License terms <ul><li>Click the radio button for “I accept the terms in the license agreements
IMPORTANT! Features won't install if not selected and it is NOT by default
Click Next
Click Finish on the last screen </li></ul>
Verify install from Help Menu <ul><li>To make sure the install was successful, go to Help | About IBM Lotus Domino Designe...
About IBM Lotus Domino Designer <ul><li>Choose the Plug-In Details button </li></ul>
Verify Plugins are Installed <ul><li>Scroll down the 2 nd  column (plug-in name) and look for entries starting with “Exten...
Create New Domino Application <ul><li>From the Designer Home Page </li><ul><li>Click button for “Create a New Application”...
Extension Library Test <ul><li>Choose local server
Title:  Extension Library Test
Filename: extlib.nsf </li></ul>
Open Application Properties <ul><li>In the application navigator, open Application Properties </li></ul>
On Advanced Tab, Check Ext Library <ul><li>In the Xpage Libraries Section, there should now be an entry for com.ibm.xsp.ex...
Check it
Save </li></ul>
Create Sample XPage <ul><li>Go to Xpages in the application navigator and double-click Xpages
Click “New Xpage” button </li></ul>
Controls View <ul><li>Far right column of Designer should have a view called “Controls”
If not, use menu Window | Show Eclipse Views | Controls to display it </li></ul>
Go to Extension Library section <ul><li>In the Controls view, there are several sections
Upcoming SlideShare
Loading in...5
×

XPages Extension Toolkit Library Installation Steps

22,326

Published on

This presentation takes you step-by-step through the process of installing the Extension Library on a Domino server and Designer. It includes the mobile components as well. This presentation was given at the Austin Advanced XPages Development seminar in Dec 2010.

Published in: Technology
1 Comment
2 Likes
Statistics
Notes
  • I am currently using Domino version 8.5.2 will this extension library also work with my Domino Designer? Thank you.
       Reply 
    Are you sure you want to  Yes  No
    Your message goes here
No Downloads
Views
Total Views
22,326
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
320
Comments
1
Likes
2
Embeds 0
No embeds

No notes for slide

Transcript of "XPages Extension Toolkit Library Installation Steps"

  1. 1. XPages Extension Toolkit Installation Lance Spellman | President, WorkFlow Studios
  2. 2. Find Extlib Project on OpenNTF <ul><li>Go to http://openntf.org
  3. 3. Find the Xpages Extension Library project </li><ul><li>Look in Featured Projects scroller
  4. 4. Or, go to Projects tab – numerous ways to locate it there </li></ul></ul>
  5. 5. Download from Releases Page <ul><li>Go to Releases, download latest to Desktop </li><ul><li>ALREADY DONE FOR LAB </li></ul></ul>
  6. 6. Open Download from Desktop <ul><li>Go to the Windows desktop
  7. 7. Locate the file “XpagesExtensionLibrary.zip” (top-left corner)
  8. 8. Double-click and extract to c:extlib-extract </li></ul>
  9. 9. Extracting to new folder c:extlib-extract
  10. 10. Verify file extraction <ul><li>Should have files like the picture below </li></ul>
  11. 11. Install Eclipse Plugin to Domino Designer <ul><li>For Domino Designer, the Extension Library is deployed as an Eclipse Plugin
  12. 12. The updateSite.zip file in the extract contains the plugin
  13. 13. Turn on ability to install plugins in Domino Designer </li><ul><li>In Domino Designer, go to File Preferences
  14. 14. Select “Domino Designer”
  15. 15. Checkmark option for “Enable Eclipse plug-in install” </li></ul></ul>
  16. 16. File | Application | Install menu available <ul><li>Now, a new menu option under File | Application should be available </li><ul><li>“Install” </li></ul></ul>
  17. 17. Search for New Features <ul><li>A dialog box for Install/Update appears with choice for “Search for Updates” or “Search for New Features”
  18. 18. Choose radio button for “Search for New Features...” </li></ul>
  19. 19. Add Zip File Location <ul><li>For Application Locations dialog, choose “Add Zip/Jar Location” </li></ul>
  20. 20. Choose UpdateSite.zip file <ul><li>Go to the c:extlib-extract directory and locate the UpdateSite.zip file </li></ul>
  21. 21. Verify the updateSite location <ul><li>The dialog should now have the updatesite.zip file in the Location list and be checkmarked
  22. 22. Click the Finish button on the dialog </li></ul>
  23. 23. Select features to install <ul><li>A new dialog appears with a prompt to select the features to install
  24. 24. Check the box for the updateSite.zip
  25. 25. Click the Next button </li></ul>
  26. 26. Accept the License terms <ul><li>Click the radio button for “I accept the terms in the license agreements
  27. 27. IMPORTANT! Features won't install if not selected and it is NOT by default
  28. 28. Click Next
  29. 29. Click Finish on the last screen </li></ul>
  30. 30. Verify install from Help Menu <ul><li>To make sure the install was successful, go to Help | About IBM Lotus Domino Designer </li></ul>
  31. 31. About IBM Lotus Domino Designer <ul><li>Choose the Plug-In Details button </li></ul>
  32. 32. Verify Plugins are Installed <ul><li>Scroll down the 2 nd column (plug-in name) and look for entries starting with “Extended Components Library” </li></ul>
  33. 33. Create New Domino Application <ul><li>From the Designer Home Page </li><ul><li>Click button for “Create a New Application” </li></ul></ul>
  34. 34. Extension Library Test <ul><li>Choose local server
  35. 35. Title: Extension Library Test
  36. 36. Filename: extlib.nsf </li></ul>
  37. 37. Open Application Properties <ul><li>In the application navigator, open Application Properties </li></ul>
  38. 38. On Advanced Tab, Check Ext Library <ul><li>In the Xpage Libraries Section, there should now be an entry for com.ibm.xsp.extlib.library
  39. 39. Check it
  40. 40. Save </li></ul>
  41. 41. Create Sample XPage <ul><li>Go to Xpages in the application navigator and double-click Xpages
  42. 42. Click “New Xpage” button </li></ul>
  43. 43. Controls View <ul><li>Far right column of Designer should have a view called “Controls”
  44. 44. If not, use menu Window | Show Eclipse Views | Controls to display it </li></ul>
  45. 45. Go to Extension Library section <ul><li>In the Controls view, there are several sections
  46. 46. Near the bottom of the view, there should be a section for Extension Library
  47. 47. If there, congratulations, you've installed the Extension Library into Domino Designer </li></ul>
  48. 48. Server Installation <ul><li>Installing to Domino Designer just makes the controls available to the Designer client
  49. 49. It doesn't make the controls available at runtime for the Domino server
  50. 50. The same plugins have to be installed on the Domino server
  51. 51. Unfortunately, the server isn't based on Eclipse so we can't use a plugin installer and updateSite.zip to automatically install them </li></ul>
  52. 52. Unzip updateSite.zip <ul><li>updateSite.zip is in the c:extlib-extract folder created earlier
  53. 53. Double-click it </li></ul>
  54. 54. Extract to update-site-extract subdir <ul><li>Extract the files to a new subdirectory under c:extlib-extract update-site-extract </li><ul><li>These exact paths aren't necessary. We are doing this just to have a reference for this guide </li></ul></ul>
  55. 55. Move Files to Domino Server Directory <ul><li>Locate your Domino data directory </li><ul><li>e.g. c:IBMLotusDominoData </li></ul><li>Navigate to dominoworkspaceapplicationseclipes
  56. 56. Full path example: </li><ul><li>C:IBMLotusDominoDataDominoWorkspaceApplicationsEclipse </li></ul><li>From the update-site-extractfeatures folder, copy the contents into the ...EclipseFeatures directory
  57. 57. See next slide for screenshot </li></ul>
  58. 59. Repeat for plugins directory
  59. 60. Verify Installation <ul><li>There should be 1 file that was copied into features directory
  60. 61. There should be 8 files that were copied into plugins directory
  61. 62. At the Domino server console </li><ul><li>Type tell http quit
  62. 63. Load http </li></ul></ul>
  63. 64. Verify ext lib loaded <ul><li>At server command prompt, type: </li><ul><li>tell http osgi ss com.ibm.xsp.extlib </li></ul><li>Results should look like this: </li></ul>
  64. 65. Install Mobile Controls <ul><li>For the mobile components of the Extension Library to work, it requires the dojox/mobile library from Dojo 1.5
  65. 66. Domino 8.5.2 ships with Dojo 1.4.3
  66. 67. Dojo 1.5 has to be downloaded and then a subset of it moved into the Domino subdirectories </li></ul>
  67. 68. Download Dojo 1.5 <ul><li>Go to http://dojotoolkit.org/download </li><ul><li>(not necessary for lab, file has been put on desktop) </li></ul><li>Download the “Dojo Toolkit Release” zipfile not “Dojo Base” </li></ul>
  68. 69. Extract Dojo Files <ul><li>Double-click the dojo-release-1.5.0-zip file to c:dojo-extract </li></ul>
  69. 70. Copy mobile.js file <ul><li>Copy C:dojo-extractdojo-release-1.5.0dojoxmobile.js to
  70. 71. C:IBMLotusDominodatadominojsdojo-1.4.3dojoxmobile.js </li></ul>
  71. 72. Copy dojoxmobile <ul><li>Copy the entire Mobile subdirectory into the dojox folder on the Domino server
  72. 73. Mobile is a new module in dojo 1.5 that did not exist in 1.4, therefore the entire dojoxmobile subdirectory is new, and we copy it into the 1.4.3 dojox folder
  73. 74. Copy c:dojo-extractdojo-release-1.5.0dojoxmobile to
  74. 75. C:IBMLotusDominodatajsdojo-1.4.3dojox </li></ul>
  75. 77. Install Mobile Themes <ul><li>Xpage theme files for iPhone, Android, and Blackberry are included in the extension library download
  76. 78. Theme files must be put into the Domino subdirectories
  77. 79. In c:extlib-extract , open the src.zip file and extract it to c:extlib-extractsrc-extract </li></ul>
  78. 80. Locate and copy .theme files <ul><li>In the src-extract folder, navigate to </li><ul><li>eclipsepluginscom.ibm.xsp.extlib.mobileresourcesmobilethemes </li></ul><li>There are 3 .theme files located there
  79. 81. Copy them to </li><ul><li>c:IBMLotusDominoxspnsfthemes </li></ul><li>Tell http restart at server console </li></ul>
  80. 82. Congratulations! <ul><li>The Extension Library is now installed on both the Domino server and client
  81. 83. The next step is to get the Demo database on the server and try it out to see the new controls at work </li></ul>
  82. 84. Copy Demo Database <ul><li>In the c:extlib-extract there is a Notes database called XpagesExt.nsf
  83. 85. Copy it to the data directory on the Domino server
  84. 86. Open the database with the Designer client
  85. 87. Sign the database </li></ul>
  86. 88. Open Demo Database in Browser <ul><li>http://127.0.0.1/XPagesExt.nsf
  87. 89. Login as Domino Admin, passw0rd </li></ul>
  88. 90. Go to the Mobile Tab <ul><li>Click the Tab for Mobile and then choose iPhone from the Navigator
  89. 91. If the Mobile components are installed correctly, an iPhone frame will appear on the screen </li></ul>
  90. 92. Legal Disclaimers <ul><li>© WorkFlow Studios 2010. All Rights Reserved.
  91. 93. The information contained in this publication is provided for informational purposes only. While efforts were made to verify the completeness and accuracy of the information contained in this publication, it is provided AS IS without warranty of any kind, express or implied. WorkFlow Studios shall not be responsible for any damages arising out of the use of, or otherwise related to, this publication or any other materials. Nothing contained in this publication is intended to, nor shall have the effect of, creating any warranties or representations from WorkFlow Studios or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software.
  92. 94. 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. Product release dates and/or capabilities referenced in this presentation may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. 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.
  93. 95. IBM, the IBM logo, Lotus, Lotus Notes, Notes, Domino and Lotusphere are trademarks of International Business Machines Corporation in the United States, other countries, or both.
  94. 96. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
  95. 97. Dissemination or reuse of this presentation is allowed provided full attribution to WorkFlow Studios is made by retaining the title slide and this legal disclaimer slide in their original form. </li></ul>
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×