6 Configuring the File Manager

6.1 About the File Manager

The File Manager manages files in a repository or vault in the file system. A File Manager provides a place to store and retrieve files locally or remotely. The File Manager can be installed on the same machine as the Agile Application Server or on a separate machine. The File Manager can also be installed in a cluster or distributed across geographic regions.

Multiple File Managers can be deployed in a distributed configuration with or without a reverse-proxy web server. A distributed File Manager configuration allows you to install additional file managers at remote locations so that remote sites can store and retrieve files locally, while still making the files available to the Agile PLM system.

Note:

If you are using AutoVue, then the AutoVue Server component should also be installed with each File Manager.

The usage model for a distributed File Manager configuration is as follows:

The File Manager located nearest to the application server should be designated the primary File Manager.
Users upload and download files from their preferred File Manager.
File replication between File Managers is on-demand. When a remote user requests a file that does not exist on their preferred File Manager, the system copies the file to the remote user's preferred File Manager.
Checking out and checking in files is the same as getting and adding files.
Deleting a file in the application only removes references to the file and does not remove the file from the file vault. Use the vault utility to clean up additional files on non-primary File Managers.

6.2 Deployment Configurations

You can deploy the File Manager in either a standalone or redundant configuration. If you plan to install the Application Server and File Manager on the same machine (co-deployed), choose both components during the Agile PLM installation.

Note:

You should run the Agile PLM installer only once on each machine and select all components you want to install on a given machine during that one install session.

In the preferred redundant configuration, each node in the cluster has the Application Server and the File Manager co-deployed. File Managers have a shared disk for file vaults.

You can also choose to install the File Manager and Application Server components on separate machines, but this configuration requires more hardware. If you choose to install this type of setup, the Application Servers and File Managers should be installed separated before configuring and validating.

6.3 Configuring the File Manager Settings

After installing the File Manager and setting up a load balancer or reverse-proxy server for it, you must configure the File Manager settings in the Java Client.

Note:

Before configuring the File Manager, make sure you set up any load balancer or reverse-proxy server.

To configure File Manager settings:

Start the Agile Application Server:

Windows service: Start the Windows service AgilePLM.

Windows command line: Choose Start > All Programs > Agile > Agile PLM > Start Agile Server. A command window may appear and this window must remain open but can be minimized.

UNIX command line: Run the startAgile.sh script located in the AGILE_HOME/agileDomain/bin directory.

Wait until the following message appears in the command window or application server log file before connecting: "Agile PLM Server Starting Up".
Start the Agile Java Client, as described in Installing and Configuring Java Client.
Log in as an Agile Administrator user.
Click the Admin tab.
Choose Server Settings > Locations. The Server Location window appears.
Click the File Manager tab to bring it forward.
Double-click the entry to display the File Manager dialog box.
Click the Advanced button and check the Viewer Content URL.
Enter the value of the File Manager URL.

The File Manager URL is the URL the Agile Web Client connects to. The format is:

http://<proxy_or_loadbalancer>:<port>/<fileserver_virtual_path>/AttachmentServlet
Click the Standard Vault Type to display the drop-down list.

You can choose to have a Standard or Custom vault. A standard vault is the default vault type that contains the new files and redlines, while a custom vault allows you to attach a disk of data to Agile PLM as-is, without reorganizing the files. A custom vault is always set up as read-only.

You can attach an arbitrary file structure to the File Manager without the files being uploaded. Refer to the Agile PLM Import and Export Guide for more information on how to configure FileLoad for custom vaults.
Enter a description of the vault in the Description field.

Verify that the primary location where the files are stored in the Base Storage Directory field is the same location you entered during installation. The default location is \files. The location can be a shared network storage directory, such as a Storage Area Network (SAN).

Important:

Do not specify a mapped drive that may not be mapped automatically after a reboot. Instead, specify a local drive or UNC name, including directory path, like this: \\fileserver\filevault

Enter a location where the purged (deleted) files are automatically moved to in the Purge Directory field. The default location is \files\purge. The location can be a shared network storage directory, such as a SAN.

Important:
Do not specify a mapped location. Instead, specify a local drive or UNC name including directory path, like this: \\fileserver\filevault\purge
Set the vault as Read-Write or Read-Only from the Category drop-down list. Each File Manager can have only one Read-Write vault.

If you have multiple vaults, then the additional vaults should be defined as Read-Only.
If you have additional vaults, then click the plus-sign to add these vaults.
Click OK when done.
Start the File Manager, as described in "Starting the File Manager"

There are additional configuration settings used to fully configure File Manager through the Java Client. These settings are:

Filename Prefix (Preferences)
Checksum computation (Preferences)
DFM Optimized Replications (Preferences)

For more information on these additional settings, see the Agile PLM Administrator Guide.

6.3.1 Reconfiguring File Manager and WebDAV after Setting up a Web Proxy Server

If you set up a Web proxy server for Agile File Manager that is different from the server or port you specified when you installed Agile PLM, you must make sure that File Manager and WebDAV point to the proxy server on the correct port. Otherwise, File Manager may not start successfully and Agile PLM clients will not be able to access file attachments.

For instructions on setting up a Web proxy server for File Manager, see "Configuring IIS as a Proxy Server for Agile PLM".

To configure File Manager and WebDAV after setting up a Web proxy server:

Configure File Manager locations in Java Client.
Stop the File Manager.
Using a text editor, open the server.conf file for File Manager in the AGILE_HOME\agileDomain\config directory.
Find the file.server.url entry, and update it to reflect the proxy server hostname or alias and port number. After you modify the file.server.url.entry, it should look similar to this:

file.server.url=http://webserver.company.com:80/Filemgr/services/FileServer

Note The file.server.url entry must match the File Manager Internal Locator entry (defined in Java client: Server Settings > Locations) or the File Manager will not initialize successfully.
Save the server.conf file.
Restart the File Manager (Tomcat).

6.4 Starting the File Manager

After you have configured the File Manager, you can start the server.

To start the File Manager on Windows:

Choose Start > Administrator Tools > Services.
Start the Apache Tomcat AgileFM service.

You can check for errors in the stdout and stderr logs in the AGILE_HOME\FileManager\logs directory.

To start the File Manager on UNIX:

Open a terminal window.
Change to the AGILE_HOME/FileManager/bin directory.
Start the File Manager:

> ./startup.sh

6.5 Stopping the File Manager

To stop the File Manager on Windows:

Choose Start > Administrator Tools > Services.
Stop the Apache Tomcat AgileFM service.

You can check for errors in the stdout and stderr logs in the AGILE_HOME\FileManager\logs directory.

To stop the File Manager on UNIX:

Open a terminal window.
Change to the AGILE_HOME/FileManager/bin directory.
Stop the File Manager:

./shutdown.sh -force

6.6 Validating the File Manager Installation

To verify that the File Manager installed successfully, check the following URL:

http://<fileserver_home>:<port>/<fileserver_virtual_path>/Configuration

For example, you might type the following URL:

http://filevault.mycompany.com:8080/Filemgr/Configuration

If you are using a Web proxy server for File Manager, the URL might look like this:

http://webproxy.mycompany.com:80/Filemgr/Configuration

After a moment, the File Manager Configuration page should display. This page tests the File Manager and Application Sever connections. If Success is listed in the Status column for all connections, your installation was successful.