Checking out the Activities configuration filesAdded by IBM on February 2, 2011 | Version 1 (Original)
|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.
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.
- 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>
Access and check out the Activities 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:
- Use the following command to access the Activities configuration file:
If prompted to specify which server to connect to, type 1.
The information about which server to connect to is only used by the wsadmin client when you are running administrative commands to collect statistics.
- Check out the Activities configuration files using the following command:
- <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 only: 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 Lotus 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:
- Microsoft Windows:
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:
- 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:
- 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
Parent topic: Changing Activities configuration property values
Next topic: Activities configuration properties