Skip Headers
Agile Product Lifecycle Management Agile Drive User Guide
Release 9.3.3
E39306-02
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

2 Setting Up Agile Drive

This chapter helps you to configure and map Agile Drive settings.

Enabling Agile Drive in Java Client

When you deploy Agile PLM, by default, the Agile Drive is set as Disabled. To use Agile Drive, ensure to enable it in Java Client.

To enable Agile Drive:

  1. In Java Client, go to Server Settings > Preferences.

  2. From the Agile Drive dropdown list, select Enabled. By default, Agile Drive is set to Disabled.

    Figure 2-1 Enabling Agile Drive

    Enabling Agile Drive

    Once you enable the Agile Drive, the access will be Read-only. To change the access to Read-Write, see Configuring the Agile Drive Settings.

  3. Restart all Distributed File Managers.

Configuring Agile Drive Settings

You can customize settings for Agile Drive by editing parameter definitions in the settings.conf file.

Changing Parameter Values in the settings.conf File

To change parameter values in the settings.conf file:

  1. Navigate to

    <Installed server location>\FileManager\webapps\webdav.war\WEB-INF\classes\

    <Installed server location>\FileManager\work\Catalina\localhost\webdav\WEB-INF\classes

  2. Open 'settings.conf' file

  3. Set the readonly.mode=false & Save file.

  4. Restart FileServer.

Parameter Definitions

You can edit the settings.conf file to define the following parameters.

  • URL for Application and File Manager

  • User Account Details

  • Encoding Details

  • Readonly mode

  • Exclusion Filters

  • Cache tuning

  • Maximum rows displayed

URL for Application and File Manager

Name Description
app.server.url Specifies the location of the Agile PLM Application Server. The format is http://<Server>:<Port>/Agile/RMIServlet
file.server.url Specifies the location of the File Server (Manager). The format is http://<Server>:<Port>/Filemgr/services/FileServer

User Account Details

User Credentials Description
Name Agile User ID Example: ifsuser
Password The encrypted Agile User Password Example: 221B758BAAE4C4

Encoding Details

Parameter Description
name.encoding Encodes directory names using HTML URL Encoding. Setting the value to 'FALSE' enables HTML URL encoding on folder names.

Read Only Mode

Parameter Description
readonly.mode Setting it to 'FALSE' turns on the 'Read-write' mode. Setting it to 'TRUE' enables you to only view the files and not modify them. The default setting is 'TRUE'.

Cache Tuning Parameters

Parameter Description
cache.reload.interval Setting cache reload interval to 2 enables you to refresh the cache twice.
cache.timeout Setting cache timeout to 30 implies cache entries are deleted from Agile Drive after being inactive for 30 minutes.

30 indicates the time to live (TTL) for cache entries. The minimum cache timeout is 20 minutes.


Exclusion Filters

Parameter Description
exclude.filetypes Specifies file types that should be filtered out of the file list. Usage: exclude.filetypes - doc,dwg,prt. For example, to filter out Word files and show only PDFs, set exclude.filetypes=doc.

Maximum Rows Displayed

Parameter Description
max.rows Specifies the number of rows to be displayed in the Search Results and BOM tables.

Minimum value = 250

Maximum value = 5000


Agile Drive Configuration for OAM Setup

The Agile Drive configurations given below are applicable for Oracle Access Manager and Windows NTLM.

To configure Agile Drive for Sinle Sign On setup:

  1. Ensure Agile Drive is enabled in the Java Client.

  2. Configure LDAP Authenticator in WLS Admin console. Refer to the Agile PLM Administrator Guide for details.

    Figure 2-2 Settings for the AgileRealm

    AgileRealm

    Given below is a graphic image of the Oracle Internet Directory Authenticator Settings.

    Figure 2-3 Settings for Oracle Internet Directory Authenticator

    OID Authenticator
  3. Ensure the File Server and Agile Drive application are configured with WLS direct access without going through the proxy URL.

    Example 2-1 IN server.conf for File server

    • app.server.http://<Server>:<Port>/Agile/services/FSHelper

    • file.server.url=http://<Server>:<Port>/Filemgr/services/FileServer

    • dms.server.url=http://<Server:<Port>/Agile/services/DmsService

    Example 2-2 In Settings.conf for Agile Drive

    • app.server.url=http://<server>:<Port>/Agile/RMIServlet

    • file.server.url=http://<server>:<Port>/Filemgr/services/FileServer

  4. Configure Agile Drive in Windows XP and Windows 7.

Deployment Architecture

  • XML based request/response model

  • Customized version of Tomcat 6.0 Web DAV Servlet

  • Supported on most platforms

  • Deployed on File Manager instance as a new Web Application

  • Communicates with Application Server for object meta data

  • Caching for better performance

Optional Settings

Agile Searches on Windows XP/Vista times out after 30 seconds. This is due to the timeout feature of Microsoft Internet Explorer 7.

To increase the Microsoft Client timeout:

  1. Add a ReceiveTimeout DWORD value with a data value of (<number of seconds>)*1000 in the Registry settings as follows: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet SettingsExample: If you want the timeout duration to be 8 minutes, set the ReceiveTimeout data value to 480000 (<480>*1000).

  2. Reboot the system.

Platform Settings

  1. Microsoft Windows Explorer - XP/Vista

    The Web Folders Client is bundled in XP/Vista. Download and install Microsoft Web Folder Update KB907306 from

    http://www.microsoft.com/downloads/details.aspx?FamilyId=17C36612-632E-4C04-9382-987622ED1D64&displaylang=en

  2. MAC OSX Finder

    To ensure the effective working of file uploads, disable the creation of intermediate file store (.DS_Store).

    http://support.apple.com/kb/HT1629

  3. IIS Support

    Supports only IIS 6.0 & 7.0.

    Ensure the WebDAV Web Service Extension is set to Allowed.

Mapping Agile Drive

You can map Agile Drive on one of the following operating systems.

On Windows XP System

To map Agile Drive on MS Windows XP system:

You cannot deploy Agile Drive on MS Windows XP-64 since it does not contain the web folders component.

  1. On the desktop, double-click the My Network Places icon.

  2. Click the Add a network place link.

  3. In the Add Network Place Wizard window click Next. Choose a network location.

  4. Enter the Host Name or IP Address of the server where Agile Drive is deployed, with its Port Number and the Folder Name, as follows:.

    http://<Host Name or IP Address>:<port>/webdav/


    Note:

    Use the host name/IP address of web proxy or Tomcat server where Agile Drive is deployed (same as the Agile File Manager by default). Contact your Agile administrator for the IP address and complete path of Agile Drive.

  5. Click Next. In the Connection window that pops up, enter your Agile PLM username and password. Contact your Agile administrator for username and password.

    If you do not want Agile Drive to ask you for username and password each time you connect, select the Remember my password check box.

  6. Click OK. Enter a name for the network place.

  7. Click Next.

  8. Click Finish.

The Agile Drive folder window appears.

On Windows VISTA System

To map Agile Drive on Windows VISTA system:

  1. Click Computer in the Start menu.

    • In the Computer window, click the Map a Network Drive icon.

    • In the Map Network Drive wizard window, click the Connect to a website that you can use to store your documents and pictures link.

    • In the Add Network Location Wizard window, click Next. Choose a custom network location.

  2. Specify the location of your website.

  3. Select Choose a custom network location.

  4. Enter the Host Name or IP Address of server where Agile Drive is deployed, with its Port Number and the Folder Name, as follows:

    http://<Host Name or IP Address>:<port>/webdav/


    Note:

    Use the host name/IP address of web proxy or Tomcat server where Agile Drive is deployed (same as the Agile File Manager by default). Contact your Agile administrator for the IP address and complete path of Agile Drive.

  5. Click Next.

  6. In the Connection window that pops up, enter your Agile PLM username and password. Contact your Agile administrator for username and password.

    If you do not want the Agile Drive to ask you for username and password each time you wish to connect, select the Remember my password check box.

  7. Click OK. Enter a name for the network location. You may change this name to one of your choice.

  8. Click Finish.

  9. Click Next.

The Agile Drive folder window appears.


Important:

Agile Drive folders do not open in Windows Vista when you double-click. You must click and select Open.

On Windows 7 System

To map Agile Drive on Windows 7 system (both 32-bit and 64-bit system):

  1. Click the Start button in Windows 7.

  2. Run regedit.

  3. Navigate to key "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\WebClient\Parameters" in regedit and modify the parameter "BasicAuthLevel" with value of 2, which enables basic authentication for Windows 7.

    Figure 2-4 Edit DWORD Value

    DWORD Value
  4. Close regedit to save the changes.

  5. Restart the service of ”Web Client” in Windows 7 Services.

  6. Launch the command in Windows 7.

  7. Enter the following in the command line: net use * http://<Host Name or IP Address>:<port>//webdav/ PASSWORD /USER:USERID where User= Username, and password.

  8. Press ENTER.

You have successfully mapped Agile Drive on Windows 7.


Note:

Users connecting to Agile Drive on WIN7 come across the below warning message. Since this is a WIN7 limitation, the workaround is to disconnect and configure Agile Drive once again.

Figure 2-5 Restoring Network Connections

Restoring Network Connections

On Macintosh System

To map Agile Drive on the Macintosh system:

  1. Select Connect to Server from Go in Main menu.

  2. In the Connect to Server window, enter the Host Name or IP Address of the server where Agile Drive is deployed, with Port Number and Folder Name, as follows:

    http://<Host Name or IP Address>:<port>/webdav/


    Note:

    Use the host name/IP address of web proxy or Tomcat server where Agile Drive is deployed (same as the File Manager by default). Contact your Agile administrator for the IP address and complete path of Agile Drive.

  3. Click Connect.

  4. Enter your Agile PLM username and password.

  5. Click OK.

    The Agile Drive folder window appears.

On GNOME Linux System

To map Agile Drive on the GNOME Linux system:

  1. Select Connect to Server... from Places in the main menu. The Connect to Server screen appears.

  2. Enter the following parameters:

    Field Description
    Service type Select WebDAV (HTTP) from the drop-down list.
    Server Enter the IP Address of the server where Agile Drive is deployed.
    Port Enter Port Number of the server. The default value is 80.
    Folder Enter webdav in lowercase.
    User Name Enter your Agile PLM username.
    Name to use for connection Enter any name of your choice.

    Contact the Agile administrator for required values.


  3. Click Connect.

  4. Enter your Agile PLM password and click Connect.

    The Agile Drive default folder window appears.

On KDE Linux System

To map Agile Drive on the KDE Linux system:

  1. Open Shell Console and execute knetattach.

  2. Select Webfolder (webdav) and click Next.

  3. Enter data in the table below or contact your Agile administrator for required values.

    Field Description
    Name Enter a name of your choice.
    User Enter your Agile PLM username.
    Server Enter the IP Address of the server where Agile Drive is deployed.
    Port Enter Port Number of the server. The default value is 80.
    Folder Enter webdav in lowercase.

  4. Click Connect.

    The Agile Drive folder window appears.