You can edit the Activities configuration files in two
ways: by using the wsadmin client or by editing the configuration
XML files directly. In both cases, you must first check out the configuration
files and later check them back in using the wsadmin client.
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
- Access and check out the Activities configuration
files.
- Use
the following command to access the Activities configuration file:
execfile("activitiesAdmin.py")
If
prompted to specify a service to connect to, type 1 to pick 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 using a local file path,
you must pick the node where the file is stored.
- Check out the Activities configuration
files using the following command:
ActivitiesConfigService.checkOutConfig("working_directory","cell_name")
where:
- 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.
Note: AIX®, and Linux™: The directory must grant write permissions or the command
will not run successfully.
- cell_name is the name of the WebSphere® Application Server cell hosting
the HCL Connections application.
This argument is case-sensitive, so type it with care. If you do not
know the cell name, you can determine it by typing the following command
in the wsadmin command processor:
print AdminControl.getCell()
For example:
- AIX® and Linux™:
ActivitiesConfigService.checkOutConfig("/opt/act/temp","foo01Cell01")
- Microsoft™ Windows™:
ActivitiesConfigService.checkOutConfig("c:/act/temp","foo01Cell01")
- 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:
ActivitiesConfigService.showConfig()
- Some properties must be edited using the wsadmin client;
others can only be edited by editing the configuration XML file directly.
To change an Activities configuration setting, do one of the following
command:
- To edit a property using the wsadmin client, use the following
command:
ActivitiesConfigService.updateConfig("property","value")
where property is
one of the editable Activities configuration properties and value is
the new value with which you want to set that property. See Activities
configuration properties for a complete list of editable properties.
For example:ActivitiesConfigService.updateConfig("activeContentFilter.enabled", "true")
- To edit the value of a property in a configuration file directly,
from the temporary directory to which you checked it out, open the
file in a text editor, and then make your changes.
What to do next
After making changes, you must check the configuration files
back in and you must do so during the same wsadmin session in which
you checked them out for the changes to take effect. See Applying
property changes for details.