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 that you enable it in Java Client.

To enable Agile Drive:

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

2. In the Agile Drive drop-down list, select Enabled.

   Figure 2-1 Enabling Agile Drive

   
   

   Once you enable the Agile Drive, the access is Read-only.

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.

Note: For configuration on Web Service Security environment, see the Agile PLM Web Services Guide.

Changing Parameter Values in the settings.conf File

To change parameter values in the settings.conf file:

1. Navigate to

   <Installed Server Location>\agileDomain\applications\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 host name>:<port>/Agile/RMIServlet
file.server.url	Specifies the location of the File Server (Manager). The format is http://<server host name>:<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 Single Sign On setup:

1. Make sure you enable Agile Drive in 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

   
   

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

   Figure 2-3 Settings for Oracle Internet Directory Authenticator

   
   

3. Make sure 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 Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit).

Deployment Architecture

• XML based request/response model

• Customized version of Apache Tomcat/8.5.3 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 Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit) times out after 30 seconds.

To increase the Microsoft Client time-out:

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.

Notes on Platform Settings

Refer to the Agile PLM Capacity Planning Guide for all software requirements.

• The Web Folders Client is bundled with Microsoft Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit). Download and install Microsoft Web Folder Update KB907306 from

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

• To ensure the effective working of file uploads in Mac OSX Finder, disable the creation of intermediate file store (.DS_Store).

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

Mapping Agile Drive

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

• "On Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit) System"

• "On Macintosh System"

• "On GNOME Linux System"

• "On KDE Linux System"

On Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit) System

To map Agile Drive on Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit):

1. Click the Start button in Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit).

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 Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit).

   Figure 2-4 Edit DWORD Value

   
   

4. Close regedit to save the changes.

5. Restart the service of ”Web Client” in Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit).

6. Launch the command in Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit).

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 Microsoft Windows 10, 8.1, 7 (64-bit, 32-bit).

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

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.

Note: Unable to Add, Get or Delete files in Web Dav on the Linux 7 operating system.