Skip Headers

Agile Product Lifecycle Management Agile Drive User Guide Release 9.3.3 E39306-01 |
| Contents

Previous | 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.

   Description of the illustration ch2_001.jpg

   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' allows 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 SSO 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.
   Description of the illustration ch2_003.png

   Description of the illustration ch2_004.png

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

   Example:

   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

   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 Window 7 and the results are as shown below.

Description of the illustration ch2_005.png

Description of the illustration ch2_006.png

### 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 correct 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 that 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"

- "On Windows VISTA System"

- "On Windows 7 System"

- "On Macintosh System"

- "On GNOME Linux System"

- "On KDE Linux System"

### 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, together 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 9same 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 user name 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 Web site 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, together 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 need to right-click on it and select Open.

### On Windows 7 System

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

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. This enables basic authentication for Windows 7.

   Description of the illustration ch2_009.png

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 up against the below warning message. Since this is a WIN7 limitation, the workaround is to disconnect and configure Agile Drive again.

Description of the illustration ch2_012.png

### 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, together 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:

   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 lower case.
   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.

   Name | Enter a name of your choice.
   User | Enter your Agile PLM user name.
   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 lower case.

4. Click Connect.

   The Agile Drive folder window appears.