Download - 2. extension toolkit installation
![Page 1: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/1.jpg)
XPages Extension Toolkit InstallationLance Spellman | President, WorkFlow Studios
![Page 2: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/2.jpg)
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
![Page 3: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/3.jpg)
Download from Releases Page● Go to Releases, download latest to Desktop
▬ ALREADY DONE FOR LAB
![Page 4: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/4.jpg)
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
![Page 5: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/5.jpg)
Extracting to new folder c:\extlib-extract
![Page 6: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/6.jpg)
Verify file extraction● Should have files like the picture below
![Page 7: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/7.jpg)
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”
![Page 8: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/8.jpg)
File | Application | Install menu available● Now, a new menu option under File | Application should be available
▬ “Install”
![Page 9: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/9.jpg)
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...”
![Page 10: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/10.jpg)
Add Zip File Location● For Application Locations dialog, choose “Add Zip/Jar Location”
![Page 11: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/11.jpg)
Choose UpdateSite.zip file● Go to the c:\extlib-extract directory and locate the UpdateSite.zip file
![Page 12: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/12.jpg)
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
![Page 13: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/13.jpg)
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
![Page 14: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/14.jpg)
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
![Page 15: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/15.jpg)
Verify install from Help Menu● To make sure the install was successful, go to Help | About IBM Lotus
Domino Designer
![Page 16: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/16.jpg)
About IBM Lotus Domino Designer● Choose the Plug-In Details button
![Page 17: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/17.jpg)
Verify Plugins are Installed● Scroll down the 2nd column (plug-in name) and look for entries starting
with “Extended Components Library”
![Page 18: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/18.jpg)
Create New Domino Application● From the Designer Home Page
▬ Click button for “Create a New Application”
![Page 19: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/19.jpg)
Extension Library Test● Choose local server● Title: Extension Library Test● Filename: extlib.nsf
![Page 20: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/20.jpg)
Open Application Properties● In the application navigator, open Application Properties
![Page 21: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/21.jpg)
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
![Page 22: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/22.jpg)
Create Sample XPage● Go to Xpages in the application navigator and double-click Xpages● Click “New Xpage” button
![Page 23: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/23.jpg)
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
![Page 24: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/24.jpg)
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
![Page 25: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/25.jpg)
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
![Page 26: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/26.jpg)
Unzip updateSite.zip● updateSite.zip is in the c:\extlib-extract folder created earlier● Double-click it
![Page 27: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/27.jpg)
Extract to update-site-extract subdir● Extract the files to a new subdirectory under c:\extlib-extract\update-site-
extract▬ These exact paths aren't necessary. We are doing this just to have a reference for
this guide
![Page 28: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/28.jpg)
Move Files to Domino Server Directory● Locate your Domino data directory
▬ e.g. c:\IBM\Lotus\Domino\Data
● Navigate to domino\workspace\applications\eclipes● Full path example:
▬ C:\IBM\Lotus\Domino\Data\Domino\Workspace\Applications\Eclipse
● From the update-site-extract\features folder, copy the contents into the ...\Eclipse\Features directory
● See next slide for screenshot
![Page 29: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/29.jpg)
![Page 30: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/30.jpg)
Repeat for plugins directory
![Page 31: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/31.jpg)
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
![Page 32: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/32.jpg)
Verify ext lib loaded● At server command prompt, type:
▬ tell http osgi ss com.ibm.xsp.extlib
● Results should look like this:
![Page 33: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/33.jpg)
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
![Page 34: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/34.jpg)
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”
![Page 35: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/35.jpg)
Extract Dojo Files● Double-click the dojo-release-1.5.0-zip file to c:\dojo-extract
![Page 36: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/36.jpg)
Copy mobile.js file● Copy C:\dojo-extract\dojo-release-1.5.0\dojox\mobile.js to● C:\IBM\Lotus\Domino\data\domino\js\dojo-1.4.3\dojox\mobile.js
![Page 37: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/37.jpg)
Copy dojox\mobile● 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 dojox\mobile subdirectory is new, and we copy it into the 1.4.3 dojox folder
● Copy c:\dojo-extract\dojo-release-1.5.0\dojox\mobile to● C:\IBM\Lotus\Domino\data\js\dojo-1.4.3\dojox
![Page 38: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/38.jpg)
![Page 39: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/39.jpg)
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-
extract\src-extract
![Page 40: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/40.jpg)
Locate and copy .theme files● In the src-extract folder, navigate to
▬ \eclipse\plugins\com.ibm.xsp.extlib.mobile\resources\mobile\themes
● There are 3 .theme files located there● Copy them to
▬ c:\IBM\Lotus\Domino\xsp\nsf\themes
● Tell http restart at server console
![Page 41: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/41.jpg)
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
![Page 42: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/42.jpg)
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
![Page 43: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/43.jpg)
Open Demo Database in Browser● http://127.0.0.1/XPagesExt.nsf● Login as Domino Admin, passw0rd
![Page 44: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/44.jpg)
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
![Page 45: 2. extension toolkit installation](https://reader034.vdocuments.site/reader034/viewer/2022052323/5594c9461a28abd63c8b45ec/html5/thumbnails/45.jpg)
Legal Disclaimers© WorkFlow Studios 2010. All Rights Reserved.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.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.
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.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
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.