Configuration settings control how and when various common operations take place. You can edit the settings to change how Lotus® Connections behaves.
About this task
Configure Lotus Connections using scripts accessed with the wsadmin client. These scripts use the connectionsConfig object available in WebSphere® Application Server wsadmin client to interact with the Lotus Connections configuration file, which is named LotusConnections-config.xml
. Changes to common configuration settings require node synchronization and a restart of the all application servers.
Some properties in the LotusConnections-config.xml file cannot be edited using the updateConfig command nor displayed using the showConfig command. Instead, you must check out the configuration file using the checkOutConfig command, and then edit the property values by opening the checked out property file from the temporary directory using a text editor. After editing the property file, be sure to save the file, and then open it in a web browser to make sure you did not introduce any errors. XML files that are well formed display in a web browser; if there are errors, the web browser reports that an error was encountered. After fixing any errors, you must check the file back in using the checkInConfig command.
How do you determine which properties you can edit using the wsadmin commands and which you cannot? Use the showConfig command. This command returns a listing of all the properties that can be edited using the updateConfig command and their current values.
To change common configuration settings, complete the following steps:
- Start the wsadmin client by completing the following steps:
- Open a command prompt, and then change to the following directory of the system on which you installed the deployment manager:
You must run the following command to start the wsadmin client from this specific directory because the Jython files for the product are stored here. If you try to start the client from a different directory, then the execfile() command that you subsequently call to initialize the administration environment for a Lotus Connections component does not work correctly.
- Enter the following command to start the wsadmin client:
- AIX® or Linux®:
./wsadmin.sh -lang jython -user <admin_user_id> -password <admin_password> -port <SOAP_CONNECTOR_ADDRESS Port>
- Microsoft® Windows®:
wsadmin -lang jython -user <admin_user_id> -password <admin_password> -port <SOAP_CONNECTOR_ADDRESS Port>
Use the wsadmin client to access and check out the Lotus Connections configuration files:
- <admin_user_id> is the user name of the IBM® WebSphere Application Server administrator.
- <admin_password> is the password of the WebSphere Application Server administrator.
- <SOAP_CONNECTOR_ADDRESS Port> is the SOAP port for the WebSphere Application Server. The default value of the SOAP port is 8879. If you are using the default port value, you do not need to specify this parameter. If you are not using the default and you do not know the port number, you can look up its value in the WebSphere Application Server Integrated Solution Console. To look up the SOAP port number, do one of the following:
- Open the WebSphere Application Server Integrated Solution Console for the deployment manager, and then select System Administration -> Deployment Manager.
- In the Additional properties section expand Ports, and then look for the SOAP_CONNECTOR_ADDRESS port entry to find the port number.
- AIX or Linux:
./wsadmin.sh -lang jython -username jsmith -password myp@assword -port 8879
- Microsoft Windows:
wsadmin -lang jython -username jsmith -password myp@assword -port 8879
Optional: If you want to find out the current value of a property, you can list the current configuration settings and values using the following command:
- Enter the following command to access the IBM Lotus Connections configuration file: execfile("connectionsConfig.py")
If you are prompted to specify which server to connect to, type 1.
Note: This information is not used by the wsadmin client when you are making configuration changes.
- Enter the following command to check out the Lotus Connections configuration files:
- <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.
AIX and Linux only: The directory must grant write permissions or the command does not run successfully.
- <cell_name> is the name of the WebSphere Application Server cell hosting the Lotus Connections application. This argument is case-sensitive, so type it with care. If you do not know the cell name, type the following command while in the wsadmin command processor:print AdminControl.getCell()
- AIX or Linux:LCConfigService.checkOutConfig("/opt/temp","foo01Cell01")
- Microsoft Windows:LCConfigService.checkOutConfig("c:/temp","foo01Cell01")
Enter the following command to change a common configuration setting:
Optional: Repeat the previous step once for each property setting that you want to change.
is one of the editable Lotus Connections configuration properties and <value>
is the new value with which you want to set that property. See Common configuration properties
for a complete list of editable properties. For example:
What to do next
Check the configuration files back in during the same wsadmin session in which you checked them out. For more information, see the Applying common configuration property changes
Common configuration properties
Find out which common Lotus Connections configuration properties you can edit to change the behavior of Lotus Connections.
Applying common configuration property changes
After you have edited the configuration properties that are common to all Lotus Connections applications, check the changed configuration files in, and restart the servers to apply the changes.
Parent topic: Administering applications
Starting the wsadmin client
Applying common configuration property changes
Customizing the navigation bar
Adding styles to the Lotus Connections stylesheet
Customizing the footer
Adding a section to the footer
Making extensive color and style changes
Exposing email addresses
Turning off active content filtering
Disabling an application
Hiding email addresses
Enabling virus scanning
Disabling the social analytics service
Configuring the 4-in-1 bookmark form
Lotus Connections configuration files