2. Find Extlib Project on OpenNTF
● Go to http://openntf.org
● Find the Xpages Extension Library project
▬ Look in Featured Projects scroller
▬ Or, go to Projects tab – numerous ways to locate it there
3. Download from Releases Page
● Go to Releases, download latest to Desktop
▬ ALREADY DONE FOR LAB
4. Open Download from Desktop
● Go to the Windows desktop
● Locate the file “XpagesExtensionLibrary.zip” (top-left corner)
● Double-click and extract to c:extlib-extract
7. Install Eclipse Plugin to Domino Designer
● For Domino Designer, the Extension Library is deployed as an Eclipse
Plugin
● The updateSite.zip file in the extract contains the plugin
● Turn on ability to install plugins in Domino Designer
▬ In Domino Designer, go to File Preferences
▬ Select “Domino Designer”
▬ Checkmark option for “Enable Eclipse plug-in install”
8. File | Application | Install menu available
● Now, a new menu option under File | Application should be available
▬ “Install”
9. Search for New Features
● A dialog box for Install/Update appears with choice for “Search for
Updates” or “Search for New Features”
● Choose radio button for “Search for New Features...”
10. Add Zip File Location
● For Application Locations dialog, choose “Add Zip/Jar Location”
12. Verify the updateSite location
● The dialog should now have the updatesite.zip file in the Location list
and be checkmarked
● Click the Finish button on the dialog
13. Select features to install
● A new dialog appears with a prompt to select the features to install
● Check the box for the updateSite.zip
● Click the Next button
14. Accept the License terms
● 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
15. Verify install from Help Menu
● To make sure the install was successful, go to Help | About IBM Lotus
Domino Designer
16. About IBM Lotus Domino Designer
● Choose the Plug-In Details button
17. Verify Plugins are Installed
●
Scroll down the 2nd
column (plug-in name) and look for entries starting
with “Extended Components Library”
18. Create New Domino Application
● From the Designer Home Page
▬ Click button for “Create a New Application”
19. Extension Library Test
● Choose local server
● Title: Extension Library Test
● Filename: extlib.nsf
21. On Advanced Tab, Check Ext Library
● In the Xpage Libraries Section, there should now be an entry for
com.ibm.xsp.extlib.library
● Check it
● Save
22. Create Sample XPage
● Go to Xpages in the application navigator and double-click Xpages
● Click “New Xpage” button
23. Controls View
● Far right column of Designer
should have a view called
“Controls”
● If not, use menu Window | Show
Eclipse Views | Controls to
display it
24. Go to Extension Library section
● In the Controls view, there are
several sections
● Near the bottom of the view,
there should be a section for
Extension Library
● If there, congratulations, you've
installed the Extension Library
into Domino Designer
25. Server Installation
● Installing to Domino Designer just makes the controls available to the
Designer client
● It doesn't make the controls available at runtime for the Domino server
● The same plugins have to be installed on the Domino server
● Unfortunately, the server isn't based on Eclipse so we can't use a plugin
installer and updateSite.zip to automatically install them
27. Extract to update-site-extract subdir
● Extract the files to a new subdirectory under c:extlib-extractupdate-site-
extract
▬ These exact paths aren't necessary. We are doing this just to have a reference for
this guide
28. Move Files to Domino Server Directory
● Locate your Domino data directory
▬ e.g. c:IBMLotusDominoData
● Navigate to dominoworkspaceapplicationseclipes
● Full path example:
▬ C:IBMLotusDominoDataDominoWorkspaceApplicationsEclipse
● From the update-site-extractfeatures folder, copy the contents into
the ...EclipseFeatures directory
● See next slide for screenshot
31. Verify Installation
● There should be 1 file that was copied into features directory
● There should be 8 files that were copied into plugins directory
● At the Domino server console
▬ Type tell http quit
▬ Load http
32. Verify ext lib loaded
● At server command prompt, type:
▬ tell http osgi ss com.ibm.xsp.extlib
● Results should look like this:
33. Install Mobile Controls
● For the mobile components of the Extension Library to work, it requires
the dojox/mobile library from Dojo 1.5
● Domino 8.5.2 ships with Dojo 1.4.3
● Dojo 1.5 has to be downloaded and then a subset of it moved into the
Domino subdirectories
34. Download Dojo 1.5
● Go to http://dojotoolkit.org/download
▬ (not necessary for lab, file has been put on desktop)
● Download the “Dojo Toolkit Release” zipfile not “Dojo Base”
35. Extract Dojo Files
● Double-click the dojo-release-1.5.0-zip file to c:dojo-extract
36. Copy mobile.js file
● Copy C:dojo-extractdojo-release-1.5.0dojoxmobile.js to
● C:IBMLotusDominodatadominojsdojo-1.4.3dojoxmobile.js
37. Copy dojoxmobile
● Copy the entire Mobile subdirectory into the dojox folder on the Domino
server
● 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
● Copy c:dojo-extractdojo-release-1.5.0dojoxmobile to
● C:IBMLotusDominodatajsdojo-1.4.3dojox
38.
39. Install Mobile Themes
● Xpage theme files for iPhone, Android, and Blackberry are included in
the extension library download
● Theme files must be put into the Domino subdirectories
● In c:extlib-extract, open the src.zip file and extract it to c:extlib-
extractsrc-extract
40. Locate and copy .theme files
● In the src-extract folder, navigate to
▬ eclipsepluginscom.ibm.xsp.extlib.mobileresourcesmobilethemes
● There are 3 .theme files located there
● Copy them to
▬ c:IBMLotusDominoxspnsfthemes
● Tell http restart at server console
41. Congratulations!
● The Extension Library is now installed on both the Domino server and
client
● The next step is to get the Demo database on the server and try it out to
see the new controls at work
42. Copy Demo Database
● In the c:extlib-extract there is a Notes database called XpagesExt.nsf
● Copy it to the data directory on the Domino server
● Open the database with the Designer client
● Sign the database
43. Open Demo Database in Browser
● http://127.0.0.1/XPagesExt.nsf
● Login as Domino Admin, passw0rd
44. Go to the Mobile Tab
● Click the Tab for Mobile and then choose iPhone from the Navigator
● If the Mobile components are installed correctly, an iPhone frame will
appear on the screen