Skip to main content link. Accesskey S
  • Help
  • IBM Logo
  • IBM Notes and Domino Application Development wiki
  • All Wikis
  • All Forums
  • THIS WIKI IS READ-ONLY. Learn more...
  • Home
  • Product Documentation
  • Community Articles
  • Learning Center
  • IBM Redbooks
  • API Documentation
Search
Community Articles > Developing Applications > Developing Cloud Applications > IBM Lotus Domino on Amazon Web Services: A getting started guide
  • Share Show Menu▼
  • Subscribe Show Menu▼

About the Original Author

Click to view profileIBM contributorLeslie Gallo
Contribution Summary:
  • Articles authored: 4
  • Articles edited: 4
  • Comments Posted: 0

Recent articles by this author

IBM Lotus Enterprise Integrator: Best practices for upgrading

Learn how to plan, execute, and verify the IBM® Lotus® Enterprise Integrator (LEI) upgrade process and about the actions the LEI installer carries out during the upgrade procedure from LEI versions later than 3.x.

Integrating Ajax into traditional IBM Lotus Domino Web applications

This article demonstrates how to use Asynchronous JavaScriptTM and XML (Ajax) technology in traditional (non-XPages) IBM® Lotus® Domino® Web applications to add interactive content to their Web forms.

Creating plugins to extend the new LotusScript Editor in IBM Lotus Domino Designer 8.5.1

Learn how to create an Eclipse plug-in to extend the new LotusScript® Editor available in IBM® Lotus® Domino® Designer 8.5.1. This article discusses the list of extension points provided by the JFace Text Editor and uses an actual end-to-end example to illustrate the steps to create and deploy the ...

IBM Lotus Domino on Amazon Web Services: A getting started guide

This article explains how to get started with IBM® Lotus® Domino® 8.5.2FP2 development in the Amazon Cloud. Step-by-step instructions walk you through creating your first Domino instance on Amazon Web Services. The Domino Amazon Machine Image (AMI) is for development and test use by ISVs and SIs ...
Learning Center articleIBM Lotus Domino on Amazon Web Services: A getting started guide
Added by Leslie Gallo | Edited by IBM contributorIrina Khasin on April 16, 2012 | Version 38
expanded Abstract
collapsed Abstract
This article explains how to get started with IBM® Lotus® Domino® 8.5.1 development in the Amazon Cloud. Step-by-step instructions walk you through creating your first Domino instance on Amazon Web Services. The Domino Amazon Machine Image (AMI) is for development and test use by ISVs and SIs and is neither licensed nor supported for use in production or by customers at this point.
ShowTable of Contents
HideTable of Contents
  • 1 Introduction
  • 2 Subscribing to the AMI
  • 3 Launching the instance
    • 3.1 Configuring IP addresses
    • 3.2 Preparing a data volume for Lotus Domino
  • 4 Setting up Lotus Domino
    • 4.1 Connect to the instance via SSH tools
    • 4.2 Setting up Lotus Domino
  • 5 Administering Lotus Domino with simpleAdmin
  • 6 Configuring Lotus Notes or Administration Client
  • 7 Building your applications using Domino Designer
  • 8 Terminating the instance
  • 9 Conclusion
  • 10 Resources
  • 11 About the authors

Update 4-27-2010: Domino 8.5.2 FP2 image is

IBM Domino Enterprise Server Release 8.5.2 FP2 ami-0689736f ami-244c7c50

ami-72a1d920

and

IBM Domino Utility Server Release 8.5.2 FP2 ami-a7d017ce ami-b44c7cc0 ami-78e8902a

Introduction


The Lotus Domino 8.5.2 FP2 development-use Amazon Machine Image (AMI) provides a fully functional Domino server for development, test and production use in the Amazon Web ServicesTM Elastic Compute Cloud (EC2) environment. This image complements the Lotus Domino Designer Integrated Development Environment (IDE) that is now freely downloadable from the IBM developerWorks Lotus site.


Additional support resources are available on the Cloud Computing Central site on My developerWorks.

The image is built on SuSE Linux® Enterprise Server (SLES) 10 and Lotus Domino 8.5.2 FP2. The steps in this article complete the configuration of the server, including the attachment of an Elastic Block Storage (EBS) volume for the Domino data directory, creation of the Administration ID file and password, and setup of the IP address.

For more information on administering the server, refer to the Lotus Domino and Notes Information Center and the Lotus Domino wiki.

Subscribing to the AMI


Amazon AMIs that are preloaded with IBM software must be subscribed to before use. This establishes the hourly pricing, if applicable, and the terms of use that accompany the AMI.

Refer to the AWS IBM Web site for more details and to subscribe to the Domino AMI.


1. From the AWS IBM web page, select IBM Lotus Domino from the list of available

2. Click on the Purchase button to subscribe to the AMI. (Figure 1)

Figure 1. Domino AMI


There is no license charge from IBM, however you are responsible for the Amazon EC2 charges associated with the AMI once you launch and run it.

Launching the instance



1. Sign into the AWS Management Console.

2. Click the Launch Instance button on your home page, and then select the Community AMIs tab and type in 'domino851' (see figure 2).

Figure 2. Search for Lotus Domino in Community Cloud images


3. Click the Select button to launch the instance.

4. Fill in the appropriate data such as the Availability Zone field of your instance (see figure 3). Click Continue.

NOTE: The Availability Zone chose in this step must match the storage volume created later.

Figure 3. Fill in instance details



5. Specify the Key Pair for the instance. This pair of keys will be used to encrypt the communications between the instance and your local host. You can select an existing Key Pair if you already have one set up (see figure 4).

Figure 4. Specify Key Pair


6. If you don't already have a Key Pair, you can create a new one, which generates a key file (a .pem file) that is used by the Secure Shell (SSH) tool to connect to the instance. Input the name of Key Pair and then click “Create & Download your Key Pair” (see figure 5).

Figure 5. Create a new key pair


A download dialog box prompts you to save the .pem file (see figure 6).

Figure 6. .pem file download window


7. Next, configure the firewall. A previously created security group may also be used (see figure 8).

Figure 8. Use an existing security group


If you create a new Security Group, make sure to open the ports needed by your applications.

Here is a list of typical ports used by Lotus Domino:
  • HTTP: 80
  • HTTPS: 443
  • LDAP: 389
  • SSH:22
  • NRPC:1352 *custom ports must be added later through AWS Management Console

8. Then, if everything looks OK in the Review window, click the Launch button to complete launch of the instance (see figure 11). It will take a few minutes to finish.

Figure 9. Launch instance



9. It will take a few minutes for the machine instance to become available. Use the Refresh button on the console to check status.

Figure 10. My Instances


Configuring IP addresses



By default AWS will assign a dynamic DNS name to the instance. An Elastic IP can be added through the AWS console and is useful when mapping DNS hostnames to the DNS instance.
 
TIP: Setup Reverse DNSexternal link if you plan to use the server to Send/Receive email from the Internet.

Preparing a data volume for Lotus Domino


All data will be lost when a running instance is shut down, unless it is stored on external persistent storage, such as Amazon S3. Our AMI has been designed to store the Domino data directory on an external volume. To prepare a volume for Lotus Domino:

1. Click the Volumes link in the left-hand navigation pane, and select an existing volume in the EBS Volumes window.

2. Make sure that the Availability Zone of the volume is the same zone as where the instance is located; otherwise, the volume cannot be attached to the instance. You can also click the Create Volume button at the top, to create a new one (see figure 12).

Figure 12. Create a new volume



3. Next, click the Attach Volume button to attach the selected volume to our Lotus Domino instance (see figure 13):

  • The newly created volume will be partitioned and formatted once attached, so don't use an existing non-Domino volume that has valuable data stored.
  • If you use a volume that was previously attached to a Domino AMI, the existing data driectory will be preserved.

Figure 13. Attach volume


4. In the Device field, select “/dev/sdf”; the image is listening for this attach point.


Setting up Lotus Domino


After you successfully launch the instance of Lotus Domino in the Amazon Cloud, you can connect to the instance and start setting it up.

Connect to the instance via SSH tools


First you need to get the instance's public DNS, which will be used as the instance's host name. To do this, go to “My Instances” window from the Instances link in the navigation of the AWS Console (see figure 14).

TIP: An Elastic IP can be optionally configured that allows a custom hostname to be used in lieu of the generated name that Amazon provides. Refer to the Amazon Web Services page for instructions.

Figure 14. My Instances window



Various SSH tools can be used to connect to the instance; however, in this guide, we use PuTTY as the SSH tool.

The key file that Amazon provides is a .pem file, but PuTTY needs a .ppk file as its private key file, so the key file must be converted. To do this we use the PuttyGen.exe program that's packaged with PuTTY:

1. Launch PuttyGen.exe, and in the PuTTY Key Generator window, click the Load button to load a .pem file, and then click the Save private key button (see figure 15).

Figure 15. Convert .pem file to .ppk file


2. Next, launch PuTTY, specify the .ppk file as the private key file and the public DNS as the host name, and then click Open (see figure 16).

Figure 16. Configure PuTTY


Now you can connect to the instance.

Use “root” as username to log in. The use of a private key replaces a password prompt.

Setting up Lotus Domino



1. Upon the initial connection with SSH, select your language and keyboard layout (see figure 17). Click Accept.

Figure 17. Languages window



2. Next, read the Linux Distribution Statement (see figure 18). Click “I understand.”

Figure 18. Linux Distribution Statement window


3. Read the Novell SLES10 License Agreement and click “I understand” (see figure 19).

Figure 19. Novell License Agreement window



4. Read the Lotus Domino Program Unique Terms; click "I have read the agreement” (see figure 20).

Figure 20. Lotus Domino 8.5.1 Program Unique TermsAgreement window


5. Accept the Novell License Agreement for Lotus Domino 8.5.1 (see figure 21).

Figure 21. License Agreement window


6. Set the password for Lotus Domino (see figure 22). The server.id, cert.id, and admin.id files will use the same password you input here, and the last name of the Domino administrator user is set to “notes”.

Figure 22. Set Domino password


7. Confirm the Domino password (see figure 23).

Figure 23. Confirm Domino password



Administering Lotus Domino with simpleAdmin


SimpleAdmin is a sample Domino administration application built on XPages. It is intended to perform a few basic administration tasks for Developers, like configuring the server name or adding users to the directory, and does not provide full administration capabilities. Web Admin (webadmin.nsf) or the Admin Client should be used for other tasks.

1. Open the URL http:///simpleAdmin.nsf with your browser; the simpleAdmin UI will display (see figure 24).

TIP: If you cannot reach your server via HTTP, ensure you have the ports opened in the Security Group for that instance

2. Enter “notes” in the User Name field, and in the Initial password field, enter the password you just set up in Step 6 of Section 4 above.

Figure 24. simpleAdmin UI



3. Change the Server Name, Organization Name, and Host Name fields to what you want; click Submit. These changes require Lotus Domino to restart, which will take a few minutes.

    When registration completes, simpleAdmin will provide a link for downloading the user's ID file, along with a button for removing the user.

    In figure 25, the Certificate ID password is the same password you set up in in Step 6 of Section 4 above. The certifier password is required to unlock the certifier ID that is used to create your new user.

Figure 25. Register new user


4. To search for a user, enter what you want to search for in the User Name field, and click the Search user button (see figure 26). If the user is found, a link for downloading the user's ID and a button for removing the user will be provided.

Figure 26. Search user



Configuring Lotus Notes or Administration Client


You can connect to Lotus Domino in the Amazon Cloud with the regular Lotus Notes and/or Administration Client, but you must prepare the user's ID before setup. You can get that from simpleAdmin, using the steps in the previous section.

In the steps below we demonstrate how to set up the Lotus Notes Client, but note that the Lotus Administration Client can be set up with similar steps. Both are included in the Lotus Domino Designer download.

1. Launch the Lotus Notes Client; the window in figure 27 displays. Click Next.

Figure 27. Launch Lotus Notes


2. In the User Information window (see figure 28), input the user's name and Domino name, which is represented as “ServerName/OrganizationName”. (You can change these using SimpleAdmin.nsf.) Click Next.

Figure 28. Specify User Name and Domino Name


3. Select the “Set up a connection to a local area network (LAN)” option and click Next (see figure 29).

Figure 29. Connect to Lotus Domino via LAN


4. Select TCP/IP as the protocol, and input the public DNS in the Server address field, as shown in figure 30. Click Next.

Figure 30. Specify protocol and server address



5. Enter the path of user's ID file here in the File name field (see figure 31). The ID file is downloaded from the simpleAdmin page. If you use “notes” (which is the last name of the Domino administrator user) as the user name instead of “user”, you don't even need a local ID file.

The Notes/Admin client will prompt you to save a local copy of the ID file of the Domino administrator user.

Figure 31. Specify ID file name


6. Decide whether to copy the ID file to your data directory (see figure 32).

Figure 32. Prompt to copy ID file to data directory


7. Input the user ID's password (see figure 33).

Figure 33. Input password


8. Configure the appropriate additional services, and click Next or Finish to complete the setup (see figure 34).

Figure 34. Additional Services


You should now see the Home page of Lotus Notes. Your Notes Client has been set up successfully.




Building your applications using Domino Designer



1. Launch Domino Designer and log on as the administrator user (“notes”), or any other users you created who have sufficient permission.

2. Press Ctrl + N to create a new application, or Ctrl+ O to open an existing application. The New Application window displays (see figure 36).

3. Enter the public DNS name in the Server field, and fill out details in the Title and File name fields. Choose a Template from the list, then Click OK.

Figure 36. New Application window


Figure 37 shows an XPage being designed.

Figure 37. Domino Designer Xpage



Terminating the instance


When no longer using an AMI instance, you can terminate it to prevent ongoing hourly billing. To do this:

1. Go to the Instance page in Amazon AWS console (from the Instances link in the left-hand navigation).

2. Select the instance you want to terminate, click the Instance Actions button, and then select Terminate (see figure 38).

Any storage volumes attached to the running instance will still be available for attachment to an instance in the future.

Figure 38. Terminate instance of Lotus Domino in Cloud


You can also delete the volume that you created. To do this:

1. Go to the Volumes page (from the Volumes link in the left navigation).

2. Select the volume you want to detach/delete, and click the Detach Volume / Delete button button (see figure 39).

Figure 39. Detach a volume



Conclusion


You should now be able to create an instance of a Domino server, configure basic settings through the SimpleAdmin console, and remotely create a Domino application using the Domino Designer Client.


Resources


Lotus Notes and Domino Application Development wiki:
http://www.lotus.com/ldd/ddwiki.nsf

Lotus Notes/Domino 8.5 discussion forum:
http://www.lotus.com/ldd/nd85forum.nsf

Lotus Notes and Domino developerWorks product page:
http://www.ibm.com/developerworks/lotus/products/notesdomino/?S_TACT=105AGX13&S_CMP=LP

Lotus Domino Designer documentation:
http://www.ibm.com/developerworks/lotus/documentation/dominodesigner/?S_TACT=105AGX13&S_CMP=LP

About the authors


 

Michael Mastersonexternal link
Technical Product Manager
IBM Lotus – Austin, TX
Xi Pan Xiao
Software Engineer
IBM Lotus – Beijing, CN
Wei She
Software Engineer
IBM Lotus – Beijing, CN




expanded Attachments (0)
collapsed Attachments (0)
expanded Versions (74)
collapsed Versions (74)
Version Comparison     
VersionDateChanged by              Summary of changes
74Jul 19, 2012, 5:31:46 PMIrina Khasin  IBM contributor
73Jul 19, 2012, 5:27:03 PMIrina Khasin  IBM contributor
72Jul 18, 2012, 6:22:21 PMIrina Khasin  IBM contributor
71Jul 18, 2012, 6:15:45 PMIrina Khasin  IBM contributor
70Jul 18, 2012, 6:12:56 PMIrina Khasin  IBM contributor
69Jul 18, 2012, 6:07:38 PMIrina Khasin  IBM contributor
68Jul 18, 2012, 5:40:15 PMIrina Khasin  IBM contributor
67Jul 18, 2012, 5:18:55 PMIrina Khasin  IBM contributor
66Jul 18, 2012, 5:06:40 PMIrina Khasin  IBM contributor
65Jul 18, 2012, 4:59:17 PMIrina Khasin  IBM contributor
64Jul 18, 2012, 4:47:50 PMIrina Khasin  IBM contributor
63Jul 18, 2012, 4:30:55 PMIrina Khasin  IBM contributor
62Jul 18, 2012, 4:23:06 PMIrina Khasin  IBM contributor
61Jul 18, 2012, 2:22:53 PMIrina Khasin  IBM contributor
60Jul 18, 2012, 2:18:25 PMIrina Khasin  IBM contributor
59Jul 18, 2012, 2:13:07 PMIrina Khasin  IBM contributor
58Jul 18, 2012, 1:59:09 PMIrina Khasin  IBM contributor
57Jul 18, 2012, 1:53:42 PMIrina Khasin  IBM contributor
56Apr 16, 2012, 5:56:20 PMIrina Khasin  IBM contributor
55Apr 16, 2012, 5:54:47 PMIrina Khasin  IBM contributor
54Apr 16, 2012, 5:49:37 PMIrina Khasin  IBM contributor
53Apr 16, 2012, 5:39:57 PMIrina Khasin  IBM contributor
52Apr 16, 2012, 5:37:41 PMIrina Khasin  IBM contributor
51Apr 16, 2012, 5:35:25 PMIrina Khasin  IBM contributor
50Apr 16, 2012, 5:27:21 PMIrina Khasin  IBM contributor
49Apr 16, 2012, 5:23:34 PMIrina Khasin  IBM contributor
48Apr 16, 2012, 5:22:07 PMIrina Khasin  IBM contributor
47Apr 16, 2012, 5:20:47 PMIrina Khasin  IBM contributor
46Apr 16, 2012, 5:20:03 PMIrina Khasin  IBM contributor
45Apr 16, 2012, 5:19:25 PMIrina Khasin  IBM contributor
43Apr 16, 2012, 4:34:36 PMIrina Khasin  IBM contributor
43Apr 16, 2012, 4:34:36 PMIrina Khasin  IBM contributor
40Apr 16, 2012, 3:39:32 PMIrina Khasin  IBM contributor
40Apr 16, 2012, 3:39:32 PMIrina Khasin  IBM contributor
40Apr 16, 2012, 3:39:32 PMIrina Khasin  IBM contributor
39Apr 16, 2012, 3:20:40 PMIrina Khasin  IBM contributor
This version (38)Apr 16, 2012, 3:18:49 PMIrina Khasin  IBM contributor
37Apr 16, 2012, 3:17:16 PMIrina Khasin  IBM contributor
31Apr 16, 2012, 2:45:07 PMIrina Khasin  IBM contributor
31Apr 16, 2012, 2:45:07 PMIrina Khasin  IBM contributor
31Apr 16, 2012, 2:45:07 PMIrina Khasin  IBM contributor
31Apr 16, 2012, 2:45:07 PMIrina Khasin  IBM contributor
31Apr 16, 2012, 2:45:07 PMIrina Khasin  IBM contributor
31Apr 16, 2012, 2:45:07 PMIrina Khasin  IBM contributor
30Apr 16, 2012, 2:41:04 PMIrina Khasin  IBM contributor
29Apr 16, 2012, 1:10:55 PMIrina Khasin  IBM contributorupdated release and ami information
28Aug 10, 2011, 4:57:13 PMIrina N Khasin  IBM contributor
27May 11, 2010, 4:50:42 PMDeanna Drschiwiski  IBM contributor
26Apr 27, 2010, 7:33:50 PMMichael L Masterson  IBM contributor
25Apr 27, 2010, 7:33:12 PMMichael L Masterson  IBM contributor
24Apr 27, 2010, 7:29:48 PMMichael L Masterson  IBM contributor
23Apr 23, 2010, 6:39:21 PMMichael L Masterson  IBM contributor
22Apr 23, 2010, 6:38:22 PMMichael L Masterson  IBM contributor
21Apr 23, 2010, 6:37:23 PMMichael L Masterson  IBM contributor
20Apr 23, 2010, 6:34:34 PMMichael L Masterson  IBM contributor
19Apr 9, 2010, 7:19:40 PMMichael L Masterson  IBM contributor
18Apr 9, 2010, 7:13:33 PMMichael L Masterson  IBM contributor
17Apr 9, 2010, 6:44:25 PMMichael L Masterson  IBM contributor
16Apr 6, 2010, 5:07:54 PMAmanda J Bauman  IBM contributor
15Apr 6, 2010, 4:58:20 PMMichael Masterson  IBM contributor
14Apr 6, 2010, 4:55:24 PMMichael Masterson  IBM contributor
13Mar 31, 2010, 11:59:58 PMMichael Masterson  IBM contributor
12Mar 31, 2010, 11:57:15 PMMichael Masterson  IBM contributor
11Mar 31, 2010, 11:35:23 PMMichael Masterson  IBM contributor
10Mar 31, 2010, 11:31:24 PMMichael Masterson  IBM contributor
9Mar 31, 2010, 11:29:55 PMMichael Masterson  IBM contributor
8Mar 31, 2010, 11:28:30 PMMichael Masterson  IBM contributor
7Mar 31, 2010, 11:21:42 PMMichael Masterson  IBM contributor
5Mar 26, 2010, 3:18:28 PMLeslie Gallo  IBM contributor
5Mar 26, 2010, 3:18:28 PMLeslie Gallo  IBM contributor
3Mar 26, 2010, 1:37:02 PMLeslie Gallo  IBM contributor
3Mar 26, 2010, 1:37:02 PMLeslie Gallo  IBM contributor
2Mar 26, 2010, 12:56:07 PMLeslie Gallo  IBM contributor
1Mar 26, 2010, 12:40:18 PMLeslie Gallo  IBM contributor
Copy and paste this wiki markup to link to this article from another article in this wiki.
Go ElsewhereStay ConnectedHelpAbout
  • IBM Collaboration Solutions wikis
  • IBM developerWorks
  • IBM Software support
  • Twitter LinkIBMSocialBizUX on Twitter
  • FacebookIBMSocialBizUX on Facebook
  • ForumsLotus product forums
  • BlogsIBM Social Business UX blog
  • Community LinkThe Social Lounge
  • Wiki Help
  • Forgot user name/password
  • About the wiki
  • About IBM
  • Privacy
  • Accessibility
  • IBM Terms of use
  • Wiki terms of use