Install a stand-alone deployment

Home

Install a stand-alone deployment

+
Search Tips | Advanced Search

Overview

Before installing configure prerequisite software and complete preinstallation tasks.
Check the online release notes for late-breaking issues.
The Lotus Connections installation wizard supports the creation of new server instances.
If you are using SQL server, you can use the SQL Server JDBC driver in both...
app_server_root/lib

..and the driver downloaded from Microsoft. The wizard checks the connection for the Microsoft JDBC driver only. If you are using the bundled driver, you need to manually test the connection after installation.
(AIX only). If you are downloading the wizard, the TAR program available by default with AIX does not handle path lengths longer than 100 characters. To overcome this restriction, use the GNU file archiving program instead. This program is an open source package that IBM distributes through the AIX Toolbox for Linux Applications. Download and install the GNU-compatible TAR package. You do not need to install the RPM Package Manager because it is provided with AIX.
After you have installed the GNU-compatible TAR program, change to the where you downloaded the Lotus Connections TAR file, and enter the following command to extract the files from it:
gtar -xvf <Lotus_Connections_wizard>_aix.tar

This command creates a named after the wizard.
A stand-alone deployment uses a single WebSphere Application Server profile and single server instance where you can install a set of Lotus Connections features. You can choose the Advanced stand-alone deployment option to install the features on multiple server instances.

Install Lotus Connections in a stand-alone deployment

Stop all WebSphere Application Server processes on the system where you plan to install Lotus Connections.
From the Lotus_Connections set-up or installation media, launch the installation wizard:
./install.sh|bat

Select an installation language and click OK.
The wizard skips this step when it detects the default language on your system.
On the Welcome page, click Launch Information Center to open the Lotus Connections Information Center in a browser window. Click Next to continue.
Review and accept the license agreement by clicking the I accept both the IBM and non-IBM terms. Click Next.
On the Response file page, select one of the options to save a response file if you want to run the wizard in silent mode for future installations.

Option Description
Install Lotus Connections only Install the product without saving a response file.
Create response file only Create a response file that you can use in a silent installation on another system. This option does not install any software on your system. You can select this option to modify an existing response file.
Use the installation wizard to modify response files that you have already created. Manual modifications to a response file might cause a silent installation to fail.
Install Lotus Connections and create a response file Install the product and save a response file.

Enter a location for the response file or accept the default location. Click Next.
On the Deployment options page, select one of the following options and click Next.

Option Description
Stand-alone deployment All features are deployed on one server instance within a single WebSphere Application Server profile. Select this option to support a workgroup or small organization.
Advanced stand-alone deployment All features are deployed on two or more server instances within a single WebSphere Application Server profile. Select this option to support a medium-size organization.

Select the where you want to install Lotus Connections: you can accept the default directory, enter a new name, or click Browse to select an existing
Select the features that you want to install and click Next. The wizard checks for any conflicts between the WebSphere Application Server profile and installation directories. Select from the following options:

Option Description
Activities Collaborate with colleagues
Blogs Write personal perspectives for colleagues
Communities Discussion forums
Dogear Bookmark important Web sites
In Lotus Connections 2.5, the Dogear feature in the user interface is renamed as Bookmarks.
Files Share files among users
Profiles Find people in the organization
Wikis Create content for your Web site

Select the extended features that you want to install and click Next. You can select from the following options:

Option Description
Home page Access features and widgets from a central point
Mobile Access Lotus Connections from mobile devices
Search Search data across all Lotus Connections features
News repository Stay informed about updates

The Home page and Mobile features rely on the features that you selected in the previous step. The Search and News features provide services to the features that you selected in the previous step.
Select the WebSphere Application Server installation that will host Lotus Connections and click Next. For example:

AIX:
/usr/IBM/WebSphere/AppServer
Linux:
/opt/IBM/WebSphere/AppServer
Windows:
C:\IBM\WebSphere\AppServer

After you identify the location of the WebSphere Application Server instance, the installer checks to make sure that security is enabled on that server.
If the location of the server to use is not displayed, click Cancel to exit the installation wizard and complete the following steps:

Open a command prompt on the system where you installed WebSphere Application Server.
Change to the Lotus_Connections_Install on the same system and enter...
./install.sh -W inputWasLocation.propertyValue=true

Re-start the installation wizard. You are directed to a page where you can manually specify the location of the WebSphere Application Server. Enter the location, based on the following format, and click Next:

AIX:
/usr/IBM/WebSphere/AppServer
Linux:
/opt/IBM/WebSphere/AppServer
Windows:
C:\IBM\WebSphere\AppServer

Enter values for the WebSphere Application Server profile and server instance:

Select a WebSphere Application Server profile.
Select an existing server instance from the Server instance list or create a server instance by selecting Create new server (a new page appears where you can enter the name of the new server instance).
Click Next.

Enter the User ID and Password of the default administrative user for Lotus Connections.
You must have already created this user ID in your LDAP or in WebSphere Identity Manager. The ID is mapped to an authentication alias called connectionsAdmin. The installed features use this authentication alias for internal administrative roles, including the search-admin, dsx-admin, and widget-admin roles.

If you plan to use a third-party Single Sign-On solution such as Tivoli Access Manager or SiteMinder, this user ID must exist in your LDAP
To change the connectionsAdmin alias to use a different user ID, follow the relevant procedures in Managing stored credentials
You also need to update the SIBus references to the user ID.

Enter the host name of the WebSphere Application Server installation and click Next. The wizard retrieves HTTP port values for WebSphere Application Server.
Use the fully-qualified DNS name or short DNS name for the host server. Do not use the IP address of the host.
Select a database type from one of the following options:

DB2 Universal Database
Oracle Enterprise Edition
SQL Server 2005Enterprise Edition

Specify whether the databases for the features are located on the same server: Select Yes or No and then click Next. The sub-steps that follow provide detailed information about each of these options.
The installation wizard tests your database connection with the database values that you supplied. You can change the database configuration later in the WAS admin console.

Option Description
Yes, the database same server. Enter the following database information:

Enter the fully-qualified domain name of the database server. For example: appserver.enterprise.example.com.
Enter the port number of the database service. The default values are: 50000 for DB2®, 1521 for Oracle, and 1433 for SQL Server.
Enter the location of the JDBC driver library. For example:

AIX:
/usr/ibm/WebSphere/AppServer/lib
Linux:
/opt/ibm/WebSphere /AppServer/lib
Windows:
C:\IBM\WebSphere\Appserver\lib

Ensure that the following JDBC driver libraries are present in the JDBC directory:

DB2

db2jcc.jar and db2jcc_license_cu.jar

Oracle

ojdbc14.jar

SQL Server

Download the SQL Server 2005 JDBC 1.2 driver from the Microsoft Web site to the WebSphere Application Server lib and enter that name in the JDBC driver library field.
The wizard can use this JDBC driver to test your database connection. You can leave the field unchanged and skip this page. After you complete this installation, Lotus Connections uses the Websphere Application Server internal SQL Server JDBC driver.

Click Next.
For each Lotus Connections feature, enter the Application user password. You specified this password when you created a database for each feature.

No, different database servers Enter the following database information:

Type the path to the JDBC driver library.
For each feature, enter the following information:

Type the Host name of the database server. For example: appserver.enterprise.example.com.
Type the Port number of the database server. The default values are: 50000 for DB2, 1521 for Oracle, and 1433 for SQL Server.
Type the database name.
Type the Application user ID of the account to use to connect to the database.
Type the Application user password. You specified this password when you created a database for each feature.

If your database type is Oracle, connect to the database with the user ID that you used when you created the feature databases.
Set up data directories for the features, using either one of the following methods:

Specify a data for Lotus Connections. The wizard creates a parent with sub-directories for each feature.
Specify a data for each feature.

Optional: This step is required only if you selected the option to specify a data for each feature. For each feature that you are installing, enter the required information.

Data directories for features

Feature Directory (samples only) Description
Activities statistics files

AIX or Linux:

/usr/IBM/LotusConnections/Data/activities/statistic

Windows:

C:\LotusConnections\Data\ activities\statistic

Statistics files that store statistics generated by Activities. The file format is CSV
Activities content files

AIX or Linux:

/usr/IBM/LotusConnections/Data/activities/content

Windows:

C:\LotusConnections\Data\ activities\content

Content to store files uploaded to Activities by users. This is additional storage space outside the database and stores files such as images.
Blogs upload files

AIX or Linux:

/usr/IBM/LotusConnections/Data/blogs/upload

Windows:

C:\LotusConnections\Data\blogs\upload

File upload for adding files such as images to Blogs.
Ensure that the has enough disk space because these files can become very large.
Communities statistics files (See Note) Statistics files for Communities:
The Communities statistics directories are not used in release 2.5. Accept the default location provided by the installation wizard and click Next.
Communities discussion forum content

AIX or Linux:

/usr/IBM/LotusConnections/Data/communties/content

Windows:

C:\LotusConnections\Data\communties\content

Content store for the discussion forums, storing additional content such as images and presentations
Dogear favicon files

AIX or Linux:

/usr/IBM/LotusConnections/Data/dogear/favorite

Windows:

C:\LotusConnections\Data\dogear\favorite

Favicon files directory, used for the favicons (favorite icons) that are generated by Dogear users
Files

AIX or Linux:

/usr/IBM/LotusConnections/Data/files/contentstore

Windows:

C:\LotusConnections\Data\files\contentstore

Files content
Profiles statistics files

AIX or Linux:

/usr/IBM/LotusConnections/Data/profiles/statistic

Windows:

C:\LotusConnections\Data\profiles\statistic

Statistics files, used for storing statistics generated by Profiles. The file format is CSV
Profiles cache

AIX or Linux:

/usr/IBM/LotusConnections/Data/profiles/cache

Windows:

C:\LotusConnections\Data\profiles\cache

Cached files
Search dictionary

AIX or Linux:

/usr/IBM/LotusConnections/Data/search/dictionary

Windows:

C:\LotusConnections\Data\search\dictionary

Search dictionary files
Search index

AIX or Linux:

/usr/IBM/LotusConnections/Data/search/index

Windows:

C:\LotusConnections\Data\search\index

Search index files
Wikis

AIX or Linux:

/usr/IBM/LotusConnections/Data/wikis/contentstore

Windows:

C:\LotusConnections\Data\wikis\contentstore

Wikis content

Decide whether you want to enable e-mail notification. If you click No, the installer skips the next step, and you can configure notification later.
Optional: If you decided to enable e-mail notification, you can select one of the following notification options:

Option Description
WebSphere Java mail session Use a single mail server for all notifications. Choose this option if you can access an SMTP server directly using the host name.
DNS MX records Use a DNS server to find an available SMTP messaging server. Choose this option if you need to use a DNS server to access the SMTP server.

The choice you make in this step determines which of the following two steps you need to complete.
Optional: If you selected the Java notification option, specify the properties of the SMTP server and then click Next:
Fill out the following fields to identify the mail server to use for sending e-mail:

Host name of the SMTP messaging server. Type the host name or IP address of the preferred SMTP mail server if you have a specific SMTP messaging server.
Fill out the following fields, if required, to identify the mail server to use for sending e-mail:

User ID and Password – Enter these values if the SMTP server requires authentication.
Enable SSL – Enable SSL if you want to encrypt outgoing mail to the SMTP server."
Port – Accept the default port of 25, or enter port 465 if you are using SSL.

Optional: If you selected DNS MX records as the notification solution, enter the following information and then click Next:

Messaging domain name. Type the name or IP address of a messaging domain.
DNS server for the messaging servers. Type the host name or IP address of the DNS server.
DNS port that is used for sending queries over the messaging server.
User ID. If SMTP authentication is required, type the administrator user ID for the SMTP server.
Password. If SMTP authentication is required, type the password for the administrator user of the SMTP server.
Encrypt outgoing mail traffic to the SMTP messaging server using SSL. Select the check box to use the Secure Sockets Layer (SSL) when connecting to the SMTP server.
Port. Specify the port number to use for the SMTP server connection. The default port number for the SMTP protocol is 25. The default port number for SMTP over SSL is 465.

(Only required if you installed the Profiles feature.) Select a to use when searching for users. You can choose the Profiles database or your LDAP

If you select the Profiles database, the features retrieve user data from the Profile database. Ensure that you have followed the steps in the Populating the Profiles database topic. By selecting this option, you are also enabling the Profiles service extension. This service extension allows other Lotus Connections features to access Profiles data. For more information, see the Common services topic.
If you select LDAP, all the features except Profiles retrieve user data from the LDAP through the WebSphere Application Server Virtual Member Manager. The Profiles feature uses its own database.

Review the information that you have entered. To revise your selections, click Back. To finalize the installation, click Next.
Review the result of the installation. Click Finish to exit the installation wizard

Results
The installation wizard has installed Lotus Connections in a stand-alone deployment.The lcinstalllog.txt log file is stored in a temporary and is overwritten by subsequent installations. If you plan to install additional features on the same system and want to be able to refer to the log file generated by the installer, change the file name or copy the lcinstalllog.txt file from the following directory:

AIX or Linux:
/tmp/lcinstalllog.txt
Windows:
C:\Documents and Settings\<user_name>\ Local Settings\temp\1\lcinstalllog.txt

into this directory:
These examples assume that you installed Lotus Connections in the default directories. If you selected different installation directories, change the file paths accordingly.

AIX:
/usr/IBM/WebSphere/LotusConnections/lcinstalllog.txt
Linux:
/opt/IBM/WebSphere/LotusConnections/lcinstalllog.txt
Windows:
C:\IBM\WebSphere\LotusConnections\lcinstalllog.txt

Open a Web browser and navigate to the URL of each feature to ensure that the installation was successful. Complete this test before performing any customizations or any post-installation tasks.
If you selected the Advanced stand-alone option to install Lotus Connections on multiple server instances, you need to manually link the buses that forward messages between the News repository and other features. For more information, see the Linking buses manually for non-federated servers topic.

Install Lotus Connections

Install a network deployment
Stand-alone deployment

Related tasks

Running the installation wizard from a console
Install in silent mode
Install the first node of a cluster
Migrating a pilot deployment

Related reference

Lotus Connections detailed system requirements

Option	Description
Install Lotus Connections only	Install the product without saving a response file.
Create response file only	Create a response file that you can use in a silent installation on another system. This option does not install any software on your system. You can select this option to modify an existing response file. Use the installation wizard to modify response files that you have already created. Manual modifications to a response file might cause a silent installation to fail.
Install Lotus Connections and create a response file	Install the product and save a response file.

Option	Description
Stand-alone deployment	All features are deployed on one server instance within a single WebSphere Application Server profile. Select this option to support a workgroup or small organization.
Advanced stand-alone deployment	All features are deployed on two or more server instances within a single WebSphere Application Server profile. Select this option to support a medium-size organization.

Option	Description
Activities	Collaborate with colleagues
Blogs	Write personal perspectives for colleagues
Communities	Discussion forums
Dogear	Bookmark important Web sites In Lotus Connections 2.5, the Dogear feature in the user interface is renamed as Bookmarks.
Files	Share files among users
Profiles	Find people in the organization
Wikis	Create content for your Web site

Option	Description
Home page	Access features and widgets from a central point
Mobile	Access Lotus Connections from mobile devices
Search	Search data across all Lotus Connections features
News repository	Stay informed about updates

Feature	Directory (samples only)	Description
Activities statistics files	AIX or Linux: /usr/IBM/LotusConnections/Data/activities/statistic Windows: C:\LotusConnections\Data\ activities\statistic	Statistics files that store statistics generated by Activities. The file format is CSV
Activities content files	AIX or Linux: /usr/IBM/LotusConnections/Data/activities/content Windows: C:\LotusConnections\Data\ activities\content	Content to store files uploaded to Activities by users. This is additional storage space outside the database and stores files such as images.
Blogs upload files	AIX or Linux: /usr/IBM/LotusConnections/Data/blogs/upload Windows: C:\LotusConnections\Data\blogs\upload	File upload for adding files such as images to Blogs. Ensure that the has enough disk space because these files can become very large.
Communities statistics files	(See Note)	Statistics files for Communities: The Communities statistics directories are not used in release 2.5. Accept the default location provided by the installation wizard and click Next.
Communities discussion forum content	AIX or Linux: /usr/IBM/LotusConnections/Data/communties/content Windows: C:\LotusConnections\Data\communties\content	Content store for the discussion forums, storing additional content such as images and presentations
Dogear favicon files	AIX or Linux: /usr/IBM/LotusConnections/Data/dogear/favorite Windows: C:\LotusConnections\Data\dogear\favorite	Favicon files directory, used for the favicons (favorite icons) that are generated by Dogear users
Files	AIX or Linux: /usr/IBM/LotusConnections/Data/files/contentstore Windows: C:\LotusConnections\Data\files\contentstore	Files content
Profiles statistics files	AIX or Linux: /usr/IBM/LotusConnections/Data/profiles/statistic Windows: C:\LotusConnections\Data\profiles\statistic	Statistics files, used for storing statistics generated by Profiles. The file format is CSV
Profiles cache	AIX or Linux: /usr/IBM/LotusConnections/Data/profiles/cache Windows: C:\LotusConnections\Data\profiles\cache	Cached files
Search dictionary	AIX or Linux: /usr/IBM/LotusConnections/Data/search/dictionary Windows: C:\LotusConnections\Data\search\dictionary	Search dictionary files
Search index	AIX or Linux: /usr/IBM/LotusConnections/Data/search/index Windows: C:\LotusConnections\Data\search\index	Search index files
Wikis	AIX or Linux: /usr/IBM/LotusConnections/Data/wikis/contentstore Windows: C:\LotusConnections\Data\wikis\contentstore	Wikis content

Option	Description
WebSphere Java mail session	Use a single mail server for all notifications. Choose this option if you can access an SMTP server directly using the host name.
DNS MX records	Use a DNS server to find an available SMTP messaging server. Choose this option if you need to use a DNS server to access the SMTP server.