Configuration settings control how and when various common
operations take place. You can edit the settings to change how HCL Connections behaves.
About this task
Use the connectionsConfig script in the wsadmin client to
interact with the LotusConnections-config.xml file.
When you change common configuration settings, you must synchronize
the nodes and restart the application servers.Some properties in
the LotusConnections-config.xml file cannot be
edited with this procedure. They cannot be edited by using the updateConfig
command nor displayed by using the showConfig command. Instead, you
must check out the configuration file by using the checkOutConfig
command and then edit the property values with a text editor. After you
edit the file, save it and open it in a web browser to make sure that
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 you fix any errors, you must check
in the file by using the checkInConfig command.
Use the showConfig
command to determine which properties you can edit by using the wsadmin
commands. This command returns a list of all the properties that can
be edited by using the updateConfig command and their current values.
To
change common configuration settings by using wsadmin commands, complete
the following steps:
Procedure
- 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:
app_server_root/profiles/dm_profile_root/bin
where dm_profile_root is the Deployment Manager profile directory; this
directory is usually called dmgr01. For example, on Windows™, the directory is C:\Program
Files\IBM\WebSphere\AppServer\profiles\Dmgr01\bin.
Attention: You must run the command to start the wsadmin client
from this specific directory because the Jython files for the product
are stored there. If you start the client from a different directory,
the execfile() command 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
where:
- admin_user_id is the user name of the Administrator
role on IBM® WebSphere® Application Server. This administrator
must be configured at the cell level, not at the cluster, node, or
server level.
- admin_password is the password of the WebSphere® Application Server
administrator.
- SOAP_CONNECTOR_ADDRESS_PORT is the SOAP port
for the WebSphere® Application
Server deployment manager server. The default value of the SOAP port
is 8879. If you are using the default port value, you do not have
to specify this parameter. If you are not using the default value
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,
complete the following steps:
- Open the WebSphere® Application
Server Integrated Solution Console for the deployment manager, and
then select .
- In the Additional properties section expand Ports,
and then look for the SOAP_CONNECTOR_ADDRESS port entry to find the
port number.
For example:
- AIX® or Linux™: ./wsadmin.sh -lang jython
-username primaryAdmin -password p@assword -port 8879
- Microsoft™
Windows™: wsadmin -lang jython -username
primaryAdmin -password p@assword -port 8879
- Use the wsadmin client to check out HCL Connections configuration files:
-
Enter the following command to load the HCL Connections
configuration file: execfile("connectionsConfig.py")
If you are prompted to
specify a service to connect to, type 1 to
select the first node in the list. Most commands can run on any node.
If the command writes or reads information to or from a file by using
a local file path, you must select the node where the file is stored.
This information is not used by the wsadmin client when you are making
configuration changes.
- Enter the following command
to check out HCL Connections
configuration files:
LCConfigService.checkOutConfig("working_directory","cell_name")
For example:
- AIX® or Linux™: LCConfigService.checkOutConfig("/opt/temp","foo01Cell01")
- Microsoft™
Windows™:
LCConfigService.checkOutConfig("c:/temp","foo01Cell01")
- Optional:
If you want to find out the current value of a property, you
can list the current configuration settings and values by using the
following command:
LCConfigService.showConfig()
- Enter the following command to change a common configuration
setting:
LCConfigService.updateConfig("property","value") where
property is
one of the editable HCL Connections
configuration properties and
value is the new value
with which you want to set that property. For a complete list of editable
properties, see
Common configuration properties . For example:
LCConfigService.updateConfig("versionStamp","")
- Optional: Repeat the previous step for each
property setting that you want to change.
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 topic.