Home
Administering Connections 6 CR6
Welcome to the HCL Connections 6 CR6 documentation. HCL Connections is social networking software designed for the workplace. Its features help you to establish dynamic networks that connect you to the people and information you need to achieve your business goals.
Administering
Run administration and maintenance tasks to keep your environment up-to-date. For example, learn how to customize your deployment or how to use the wsadmin utility to edit configuration files. You can also schedule tasks, maintain application databases, moderate content, or manage users and their roles.
Administering Files
You administer Files using the wsadmin client to specify properties in a configuration file, or run administrative commands.
Finding the location of a stored file
Use the FilesUtilService.getFileById command to locate a file stored in a directory on a file system.

Administering Connections 6 CR6
Welcome to the HCL Connections 6 CR6 documentation. HCL Connections is social networking software designed for the workplace. Its features help you to establish dynamic networks that connect you to the people and information you need to achieve your business goals.
- What's new in HCL Connections 6
  Find out about features that are new or updated in this release of HCL Connections.
- Product overview
  Learn how to deploy, customize, and administer the IBM Connections social networking product.
- Planning
  Before installing HCL Connections™, study the system requirements, deployment options, and documentation conventions.
- Installing
  To install IBM® Connections, you need to follow a detailed series of procedures.
- Migrating and updating
  Migrate IBM® Connections and its supporting software to the latest release and then update the installation with the latest interim fixes or Cumulative Refresh (CR).
- Administering
  Run administration and maintenance tasks to keep your environment up-to-date. For example, learn how to customize your deployment or how to use the wsadmin utility to edit configuration files. You can also schedule tasks, maintain application databases, moderate content, or manage users and their roles.
  - Administering common areas
    Administer the common areas of IBM® Connections.
  - Administering Activities
    Configure Activities to best meet the needs of your environment.
  - Administering Blogs
    Administer site-wide settings for Blogs from either the Blogs user interface or via the wsadmin client.
  - Administering Bookmarks
    You configure and administer Bookmarks using scripts accessed using the wsadmin client. Changes to Bookmarks configuration settings require a restart of the Bookmarks server before they take effect. Changes made using administrative commands take effect immediately.
  - Administering Communities
    Configure and administer Communities using scripts accessed using the IBM® WebSphere® Application Server wsadmin client.
  - Administering Files
    You administer Files using the wsadmin client to specify properties in a configuration file, or run administrative commands.
    - Enabling sync for files and folders
      Enable sync for files and folders in the Files application. This feature enhances collaboration by allowing users to keep files and folders synchronized even when working offline.
    - Managing images and videos for thumbnails and preview
      You can control the size of thumbnails for images and videos using the file-preview-config.xml.
    - Enabling round-trip editing for files
      Enable round-trip editing for files so that users can check out a file and edit it locally with one click.
    - Administering Push Notification
      With push technology the file sync feature scales to multiple clients and the clients can update their content faster when changes are made on the server.
    - Changing Files configuration property values
      Configuration properties control how and when various Files operations take place. You can edit the properties to change the ways that Files operates.
    - Running Files administrative commands
      Use administrative commands to perform tasks that manipulate Files content.
    - Backing up Files data
      Files stores data in both the database and a file system. This adds some complication in keeping the application available to users while backing up data.
    - Displaying files inline
      Configure Files to display files inline instead of as attachments. This is useful when you use the Files API to download and display active content, such as Adobe® Flash (.swf) files, in your own HTML pages. Enable inline display by changing a configuration property in the files-config.xml file. Then set the inline parameter to true in your download requests.
    - Restricting file types in Files
      You can restrict the types of files that users can upload in Files.
    - Setting a maximum size on libraries
      Use FilesLibraryService commands to assign a policies to libraries. A library is a set of files owned by a person or community. A policy sets a maximum size for a library.
    - Working with Files policies
      Use the FilesPolicyService commands to add, edit, count, and return information about policies. You apply policies to libraries to set a maximum size on those libraries.
    - Seeing Files library information
      Use FilesLibraryService commands to see information about libraries, such as its owner, type, and size. A library is a set of files owned by a person or community and stored in the database.
    - Filtering lists returned by commands
      Use the FilesUtilService commands to filter lists of maps returned by browse commands.
    - Printing information returned by commands
      Use the FilesPrintService.saveToFile command to print information returned by other commands.
    - Disabling automatic email notification of file updates
      When an user downloads a file for the first time, Files sets a preference so that the user receives an email notification when the file is edited or commented on. The assumption is that users want to receive email about updates to the file. You can disable this notification using the files-config.xml file.
    - Disabling file versioning
      By default, when a user uploads a new version of a file it becomes the latest version, and all previous versions are kept. Users can see all versions of a file in the user interface. You can disable file versioning in the files-config.xml properties file.
    - Transferring ownership of user files
      As an administrator, you can use a wsadmin command to transfer a user's Connections files to a new owner.
    - Deleting user files from the system
      Use the FilesLibraryService delete commands to delete user files.
    - Finding the location of a stored file
      Use the FilesUtilService.getFileById command to locate a file stored in a directory on a file system.
  - Administering Forums
    Administer Forums by specifying properties in a configuration file or running administrative commands.
  - Administering the Home page
    You can administer site-wide settings for the Home page from the Home page administration user interface or using the wsadmin client.
  - Administering Libraries
    A Library provides the services of an Enterprise Content Management (ECM) system to Communities. To enable the use of Libraries, you must make some configuration changes to Connections and to each ECM system that you plan to use.
  - Administering Metrics for Cognos
    Administer metrics in IBM® Connections by modifying configuration settings, backing up data, and running commands to perform maintenance tasks.
  - Administering the News repository
    You administer the News repository using scripts accessed using the wsadmin client. Changes to News configuration settings require node synchronization and a restart of the Home page server before they take effect.
  - Administering Profiles
    Profiles provides two types of administrative capabilities: configuration settings and administrative commands. You change configuration settings and execute administrative commands by running scripts from the wsadmin command line.
  - Administering Search
    The Search service provides a point for performing full text and tag searches across all the deployed IBM® Connections applications. Search is a required application for all IBM Connections applications, and it must be running to prevent unexpected behaviors in the other applications.
  - Administering Wikis
    Configure and administer Wikis by using the wsadmin client to run administrative commands or by editing the configuration file directly.
  - Administering Component Pack for Connections
    Monitor the services for Component Pack for IBM Connections™ and troubleshoot issues.
- Customizing
  Customize IBM® Connections to fit your environment.
- Security
  IBM® Connections provides a flexible security infrastructure that supports an open, easily shareable data model.
- Mobile
  See the IBM Connections Mobile documentation for Connections Cloud and Connections on-premises.
- Developing
  Get information about how to use the APIs provided with IBM® Connections and how to use Connections Customizer to modify the Connections pages that are returned to users.
- Troubleshooting and support
  To isolate and resolve problems with your IBM® products, you can use the troubleshooting and support information. This information contains instructions for using the problem-determination resources that are provided with your IBM products, including HCL Connections™.

Finding the location of a stored file

Use the FilesUtilService.getFileById command to locate a file stored in a directory on a file system.

Before you begin

To use administrative commands, you must use the wsadmin client. See Starting the wsadmin client for details.

About this task

Files uploaded through the IBM® Connections Files component are stored on a shared file system, as described in the topic Installing IBM® Connections 6.0.

This command can be useful when restoring backup versions of data. See the topic Backing up Files data for more information.

Procedure

Start the wsadmin client.
Start the Files Jython script interpreter using the following command:
```
execfile("filesAdmin.py")
```
Run the following command to locate a file stored in the following file directory:
```
FilesUtilService.getFileById("fileId", "isRendition", "checkExistence")
```
Where

fileID is the ID of a file stored in the database. The ID must be a string in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

isRendition indicates whether or not the file that you want to locate is a rendition-type file. Rendition-type files are generated by the Files service from normal files uploaded by end users. Rendition files are used for previews, thumbnails, and so on. They are stored in a separate location.

checkExistence indicates whether this command checks if the file exists or not. If the file doesn't exist, its location is not returned.
For example, enter the following command:
```
wsadmin>FilesUtilService.getFileById("00a29a17-7443-47d6-8099-3727c8956304", "true", "false")
```
The command returns the file path as a string, even if the file is not in use:[/nsf/IBM/Connections/data/shared/files/upload/files/renditions/86/124/00a29a17-7443-47d6-8099-3727c8956304]

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the HCL Software Support site.