Configuration properties control how and when various Files
operations take place. You can edit the properties to change the ways
that Files operates.
Before you begin
To edit configuration files, you must
use the IBM® WebSphere® Application Server wsadmin client.
See Starting the wsadmin
client for information about how to start the wsadmin command-line
tool.
About this task
Configure Files using scripts accessed with the wsadmin
client. These scripts use the AdminConfig object available in IBM WebSphere Application Server wsadmin client
to interact with the Files configuration file. Changes to Files configuration
settings require node synchronization and a restart of the Files server
before they take effect.
To edit Files configuration properties,
complete the following steps:
Procedure
- Start the wsadmin client.
- Start the Files Jython script interpreter.
- Use the following command
to access the Files configuration files:
execfile("filesAdmin.py")
If
you are asked to select a server, you can select any server.
- Check out the Files configuration
files using the following command:
FilesConfigService.checkOutConfig("working_directory",
"cell_name")
where:
- working_directory is the temporary working
directory to which the configuration XML and XSD files are copied.
The files are kept in this working directory while you make changes
to them.
Note: AIX®, Linux, and IBM i 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 IBM Connections application.
This argument is required. 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:
FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommServerNode01Cell")
- Optional: To view a list of the valid Files
configuration settings and their current values, use the following
command:
FilesConfigService.showConfig()
Here
is some sample output from the FilesConfigService.showConfig() command:Files configuration properties:
security.logout.href = /files/ibm_security_logout
activeContentFilter.enabled = true
cache.user.timeout = 43200000
cache.http.publicContentMaxAgeInSecs = 604800
db.dialect = DB2
- Some properties must be edited using the wsadmin client;
others can only be edited by editing the configuration XML file directly.
To change a Files configuration setting, do one of the following:
- Optional: Repeat step 4 for each single-value
property setting that you want to change.
- Optional: After updating the Files properties
with new values, use the FilesConfigService.showConfig() command
to display the list of properties and their updated values. These
are the values that will be checked in with the FilesConfigService.checkInConfig() command.
What to do next
You must check the configuration files back in after making
changes, and they must be checked in during the same wsadmin session
in which they were checked out for the changes to take effect. See
the topic Applying Files property changes for details.