WebSphere Application Server environment variables

Unless you change the directory paths during the installation, the default IBM® WebSphere® environment variables are defined for IBM Connections application directories. These variables are referenced from the configuration files that are associated with the applications.

The following tables list the default environment variables that are defined for application directories and for the customization base directory.
Note: Production deployments often more than one shared content store to avoid problems when applications attempt to read or write to a device at the same time. If you use multiple devices, change the environment variables to match your deployment. You must also update the properties in the IBM Connections configuration engine; otherwise, the export/import utility does not work properly. For more information about IBM Connections configuration engine properties, see ConfigEngine properties.
Table 1. Activities default WebSphere environment variables
Variable name Description / Local or shared* Default value
ACTIVITIES_CONTENT_DIR File upload directory / shared

AIX® and Linux: /opt/IBM/Connections/data/shared/activities/content

IBM i: /QIBM/UserData/IBM/Connections/data/shared/activities/content

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\activities\content
ACTIVITIES_HOME Directory in which Activities was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/activities/activities/activities

IBM i: /QIBM/ProdData/IBM/Connections/activities/activities/activities

Microsoft Windows: C\Program Files\IBM\Connections\activities\activities\activities
ACTIVITIES_JDBC_DRIVER_HOME JDBC Driver JAR files directory / local

JDBC driver library path that you specified when you installed the product. For example: opt/ibm/db2/java
ACTIVITIES_STATS_DIR Statistics directory / shared

AIX and Linux: /opt/IBM/Connections/data/shared/activities/statistics

IBM i: /QIBM/UserData/IBM/Connections/data/shared/activities/statistics

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\activities\statistics
Table 2. Blogs default WebSphere environment variables
Variable name Description / Local or shared* Default value
BLOGS_CONTENT_DIR File upload directory / shared

AIX and Linux: /opt/IBM/Connections/data/shared/blogs/upload

IBM i: /QIBM/UserData/IBM/Connections/data/shared/blogs/upload

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\blogs\upload
BLOGS_JDBC_DRIVER_HOME JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
BLOGS_HOME Directory in which Blogs was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/blogs/blogs/blogs

IBM i: /QIBM/Proddata/IBM/Connections/blogs/blogs/blogs

Microsoft Windows: C:\Program Files\IBM\Connections\blogs\blogs\blogs
Table 3. Bookmarks default WebSphere environment variables
Variable name Description / Local or shared* Default value
DOGEAR_FAVICON_DIR Icons upload directory / shared

AIX and Linux: /opt/IBM/Connections/data/shared/dogear/favorite

IBM i: /QIBM/UserData/IBM/Connections/data/shared/dogear/favorite

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\dogear\favorite
DOGEAR_JDBC_DRIVER_HOME JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
DOGEAR_HOME Directory in which the Bookmarks application was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/dogear/dogear/dogear

IBM i: /QIBM/Proddata/IBM/Connections/dogear/dogear/dogear

Microsoft Windows: C:\Program Files\IBM\Connections\dogear\dogear\dogear
Table 4. Communities default WebSphere environment variables
Variable name Description / Local or shared* Default value
CATALOG_INDEX_DIR Directory in which the index is stored / local

AIX and Linux: /opt/IBM/Connections/data/local/catalog/index

IBM i: /QIBM/UserData/IBM/Connections/data/local/catalog/index

Microsoft Windows: C\Program Files\IBM\Connections\data\local\catalog\index
CATALOG_REPLICATION_DIR Directory in which the delta index files are stored / shared

AIX and Linux: /opt/IBM/Connections/data/shared/catalog/indexReplication

IBM i: /QIBM/UserData/IBM/Connections/data/shared/catalog/indexReplication

Microsoft Windows: C\Program Files\IBM\Connections\data\shared\catalog\indexReplication
COMMUNITIES_JDBC_DRIVER_HOME JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
COMMUNITIES_HOME Directory in which Communities was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/communities/communities/communities

IBM i: /QIBM/Proddata/IBM/Connections/communities/communities/communities

Microsoft Windows: C:\Program Files\IBM\Connections\communities\communities\communities
Table 5. Customization default WebSphere environment variable
Variable name Description / Local or shared* Default value
CONNECTIONS_CONFIGURATION_PATH Stores configuration information and polices for IBM Connections applications and users.

AIX and Linux: /opt/IBM/Connections/data/configuration

IBM i: /QIBM/UserData/IBM/Connections/data/shared/configuration

Microsoft Windows: C:\IBM\Connections\data\shared\configuration

CONNECTIONS_ CUSTOMIZATION_PATH

 Customization directory / shared

AIX and Linux: /opt/IBM/Connections/data/shared/customization

IBM i: /QIBM/UserData/IBM/Connections/data/shared/customization

Microsoft Windows: C:\Program files\IBM\Connections\data\shared\customization
Table 6. Files default WebSphere environment variables
Variable name Description / Local or shared* Default value
FILES_CONTENT_DIR File upload directory / shared

AIX and Linux: /opt/IBM/Connections/data/shared/files/upload

IBM i: /QIBM/UserData/IBM/Connections/data/shared/files/upload

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\files\upload
Files_HOME Directory in which the Files application was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/files/files/files

IBM i: /QIBM/Proddata/IBM/Connections/files/files/files

Microsoft Windows: C:\Program Files\IBM\Connections\files\files\files
Files_JDBC_DRIVER_HOME JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
Table 7. Forums default WebSphere environment variables
Variable name Description / Local or shared* Default value
FORUM_CONTENT_DIR Forum content directory / shared

AIX and Linux: /opt/IBM/Connections/data/shared/forums/content

IBM i: /QIBM/UserData/IBM/Connections/data/shared/forums/content

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\forums\content
FORUM_JDBC_DRIVER_HOME JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
FORUM_HOME Directory in which the Forum application was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/forum/forum/forum

IBM i: /QIBM/Proddata/IBM/Connections/forum/forum/forum

Microsoft Windows: C:\Program Files\IBM\Connections\forum\forum\forum
Table 8. Home page default WebSphere environment variables
Variable name Description / Local or shared* Default value

Homepage_JDBC_DRIVER_HOME

 JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
Homepage_HOME Directory in which the Home page application was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/homepage/homepage/homepage

IBM i: /QIBM/Proddata/IBM/Connections/homepage/homepage/homepage

Microsoft Windows: C:\Program Files\IBM\Connections\homepage\homepage\homepage
Table 9. Metrics default WebSphere environment variables
Variable name Description / Local or shared* Default value
METRICS_HOME Directory in which the Metrics application was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/metrics/metrics/metrics

IBM i: /QIBM/Proddata/IBM/Connections/metrics/metrics/metrics

Microsoft Windows: C:\Program Files\IBM\Connections\metrics\metrics\metrics

METRICS_JDBC_DRIVER_HOME

 JDBC driver JAR files directory / local. JDBC driver library path that you specified when you installed the product.
Table 10. News default WebSphere environment variables
Variable name Description / Local or shared* Default value

ACTIVITY_STREAM_SEARCH_INDEX_DIR

 Directory in which the index for Activity Stream search is stored / local

AIX and Linux: /opt/IBM/Connections/data/local/news/search/index

IBM i: /QIBM/UserData/IBM/Connections/data/local/news/search/index

Microsoft Windows: C:\Program Files\IBM\Connections\data\local\news\search\index

ACTIVITY_STREAM_SEARCH_REPLICATION_DIR

 Replication directory for Activity Stream Search / shared

AIX and Linux: /opt/IBM/Connections/data/news/search/indexReplication/ActivityStream

IBM i: /QIBM/UserData/IBM/Connections/data/shared/news/search/indexReplication

Microsoft Windows: C:\Program Files\IBM\Connections\data\news\search\indexReplication\ActivityStream
AUDIT_FILE_ROOT_DIR Stores temporary attachments for audit purposes. / shared

AIX and Linux: /opt/IBM/Connections/data/shared/audit

IBM i: /QIBM/UserData/IBM/Connections/data/shared/audit

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\audit

NEWS_JDBC_DRIVER_HOME

 JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
NEWS_HOME Directory in which the News application was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/news/news/news

IBM i: /QIBM/Proddata/IBM/Connections/news/news/news

Microsoft Windows: C:\Program Files\IBM\Connections\news\news\news
Table 11. Profiles default WebSphere environment variables
Variable name Description / Local or shared* Default value
PROFILES_CACHE_DIR Cache directory / local

AIX and Linux: /opt/IBM/Connections/data/local/profiles/cache

IBM i: /QIBM/UserData/IBM/Connections/data/local/profiles/cache

Microsoft Windows: C:\Program Files\IBM\Connections\data\local\profiles\cache
PROFILES_HOME Directory in which the Profiles application was installed. This variable is only necessary on the first node. / local

AIX and Linux: /opt/IBM/Connections/profiles/profiles/profiles

IBM i: /QIBM/Proddata/IBM/Connections/profiles/profiles/profiles

Microsoft Windows: C:\Program Files\IBM\Connections\profiles\profiles\profiles

PROFILES_JDBC_DRIVER_HOME

 JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
PROFILES_STATS_DIR Statistics directory / shared

AIX and Linux: /opt/IBM/Connections/data/shared/profiles/statistics

IBM i: /QIBM/UserData/IBM/Connections/data/shared/profiles/statistics

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\profiles\statistics
Table 12. Search default WebSphere environment variables
Variable name Description / Local or shared* Default value

CRAWLER_PAGE_PERSISTENCE_DIR

 Directory that is used to store the seedlist pages persisted during crawling.

AIX and Linux: /opt/IBM/Connections/data/local/search/persistence

IBM i: /QIBM/UserData/IBM/Connections/data/local/search/persistence

Microsoft Windows: C:\Program Files\IBM\Connections\data\local\search\persistence
EXTRACTED_FILE_STORE Directory that is used to store the extracted file content.

AIX and Linux: /opt/IBM/Connections/data/shared/search/extracted

IBM i: /QIBM/UserData/IBM/Connections/data/shared/ExtractedText

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\search\extracted

FILE_CONTENT_CONVERSION

 Platform-specific path to the application that is called for text extraction from files at indexing time. / local

AIX and Linux: /opt/IBM/WebSphere/Connections/data/local/search/stellent/dcs/oiexport/exporter

IBM i: /QIBM/UserData/IBM/Connections/data/shared/search/stellent/dcs/oiexport/exporter

Microsoft Windows: Program Files\IBM\Connections\data\local\search\stellent\dcs\oiexport\exporter

SEARCH_DICTIONARY_DIR

 Dictionary directory / shared

AIX and Linux: /opt/IBM/Connections/data/shared/search/dictionary

IBM i: /QIBM/UserData/IBM/Connections/data/shared/search/dictionary

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\search\dictionary
SEARCH_HOME Directory in which Search was installed. This variable is necessary only on the first node. / local

AIX and Linux: /opt/IBM/Connections/search/search/search

IBM i: /QIBM/Proddata/IBM/Connections/search/search/search

Microsoft Windows: C:\Program Files\IBM\Connections\search\search\search
SEARCH_INDEX_DIR Index directory / local

AIX and Linux: /opt/IBM/Connections/data/local/search/index

IBM i: /QIBM/UserData/IBM/Connections/data/local/search/index

Microsoft Windows: C:\Program Files\IBM\Connections\data\local\search\index
SEARCH_INDEX_BACKUP_DIR Backup index directory / local

AIX and Linux: /opt/IBM/Connections/data/local/search/backup

IBM i: /QIBM/UserData/IBM/Connections/data/local/search/backup

Microsoft Windows: C:\Program Files\IBM\Connections\data\local\search\backup

SEARCH_INDEX_SHARED_COPY_LOCATION

 Directory used for automatic distribution of the baseline index to other nodes. An index in this folder will be deleted 30 days after it is created. If this variable is deleted, automatic index rollout will be disabled. / shared

AIX and Linux: /opt/IBM/Connections/data/shared/search/staging/

IBM i: /QIBM/UserData/IBM/Connections/data/shared/search/staging/

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\search\staging\

SEARCH_JDBC_DRIVER_HOME

SEARCH_JDBC_DRIVER_
HOME
 JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
Table 13. WebSphere Application Server Service Integration Bus file store environment variables
Variable name Description / Local or shared* Default value
MESSAGE_STORE_PATH Directory that is used to store the files that are used and managed by the messaging engines of the WebSphere Service Integration Bus (SIB) for the IBM Connections bus (permanent, temporary, and log file) / shared
Note: The same requirements for other shared content apply to this directory. In addition, if NFS is used, use version 4 of the protocol.

AIX and Linux: /opt/IBM/Connections/data/shared/messageStores

IBM i: /QIBM/UserData/IBM/Connections/data/shared/messageStores

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\messageStores
Table 14. Wikis default WebSphere Application Server environment variables
Variable name Description / Local or shared* Default value
WIKIS_CONTENT_DIR File upload directory, / shared

AIX and Linux: /opt/IBM/Connections/data/shared/wikis/upload

IBM i: /QIBM/UserData/IBM/Connections/data/shared/wikis/upload

Microsoft Windows: C:\Program Files\IBM\Connections\data\shared\wikis\upload
WIKIS_HOME Directory in which the Wikis application was installed. This variable is necessary only on the first node. / local

AIX and Linux: /opt/IBM/Connections/wikis/wikis/wikis

IBM i: /QIBM/ProdData/IBM/Connections/wikis/wikis/wikis

Microsoft Windows: C:\Program Files\IBM\Connections\wikis\wikis\wikis

WIKIS_JDBC_DRIVER_HOME

 JDBC Driver JAR files directory / local JDBC driver library path that you specified when you installed the product.
*Shared content must be accessible (read/write) by all nodes in a cluster. The shared content store must be in a shared repository that grants read/write access to the Deployment Manager and all the nodes. Use one of the following methods to create a shared data directory:
  • Network-based file shares (for example: NFS, SMB/Samba, and other share types)
  • Storage area network drives (SAN)
  • If you are using a shared-file system on Microsoft Windows, specify the file location by using the Universal Naming Convention (UNC) format. For example: \\server_name\share_name
Note: From version 3 of IBM Connections, all variables changed from being server-level variables to cell-level variables. Variables with a server level scope are more granular than variables with a node or cell level scope.

Both shared and local content stores must be accessible by using the same path from nodes and the deployment manager.