7
Client Packages Installation

This chapter describes installation of the client packages used with Oracle 9iFS. Various clients are provided for administrators and end users. Topics include:

• Installing the Oracle 9iFS Windows Utilities

• Accessing Oracle 9iFS through HTTP

• Registering the Oracle 9iFS Portlet with Oracle Portal

• Installing the Oracle 9iFS FileSync Component

• Installing the Command Line Client Utilities

• NFS Client Configuration

Installing the Oracle 9iFS Windows Utilities

The Oracle 9iFS Windows Utilities provides users with Microsoft Windows clients access to content management features such as check-in/check-out and versioning.

The Oracle 9iFS Windows Utilities installation package is loaded into the Oracle 9iFS server, in the /ifs/clients/winui directory. To access this directory from a Windows client, users can map a network drive using SMB or use the Network Neighborhood. They can also access this directory using FTP.

To install the Oracle 9iFS Windows Utilities, users should follow these steps:

1. Save and exit all Windows applications.

2. Locate the Setup.exe file in the /ifs/clients/winui/ directory.

3. Double-click to run the Setup.exe program, or run it from the Run command in the Start Menu.

4. Follow all instructions and accept the defaults unless your system administrator tells you otherwise.

   By default, the Oracle 9iFS Windows Utilities are installed in the following directory:

   C:\Program Files\Oracle\iFS

   Three required Microsoft components will be installed if they are not already on your system:

   1. Windows Sockets Version 2 (WinSock2)--All Windows platforms after Windows 95 should already have WinSock2 preinstalled with the operating system. The Oracle 9iFS Installer will install WinSock2 on Windows 95 clients that do not already have it.

   2. Common Control 4.0 Upgrade--If your system does not have Microsoft Common Control 4.0, the Oracle 9iFS Installer will install the upgrade. You must select "Yes" when you are asked for whether or not you want to upgrade.

   3. HTML Help 4.0--If your system does not have Microsoft HTML Help 4.0, the Oracle 9iFS Installer will install it. You must select "Yes" when you are prompted to upgrade in order to access the help for Oracle 9iFS Windows Utilities properly.

5. After you install the Oracle 9iFS Windows Utilities, you must restart the machine.

   Once you've installed the Oracle 9iFS Windows Utilities, the Windows Explorer File menu and the Windows Explorer context menu (right-click menu) will include utilities for advanced Oracle 9iFS features. To view the context menu, right-click a file or folder on an Oracle 9iFS drive.

Accessing Oracle 9iFS through HTTP

To access Oracle 9iFS through HTTP, use the following URL:

http://<server-name>:<port-number>/ifs/files

This URL is required for the following:

• Access through a web browser.

• Access through the DAV applications, such as Web Folders.

• Access or connection to the server using the FileSync feature.

Registering the Oracle 9iFS Portlet with Oracle Portal

The Oracle 9iFS portlet is a Portal component that gives users a summary of information about their Oracle 9iFS data. On the portlet, users can see their quotas, initiate a search, list documents or folders, and upload documents. The portlet links to the Oracle 9iFS Web interface.

Oracle Portal administrators can add the Oracle 9iFS portlet to their own installation of Oracle Portal, by registering it as a Web Provider on the portal:

1. On the portal, click the Administer tab.

2. In the Provider portlet, click the Add a Portlet Provider link.

3. Fill out the form to create a Web Provider.

4. Click OK.

For more instructions on adding the portlet to a portal page see the Oracle Portal documentation.

Figure 7-1 The Oracle 9iFS Portlet

Installing the Oracle 9iFS FileSync Component

The FileSync component provides users with a restricted disconnected client for Oracle 9iFS. This component is only installable on a Windows client PC. To install the FileSync component, users execute the Setup.exe self-installing file located in the /ifs/clients/filesync directory in an Oracle 9iFS repository. They can access this file using SMB, WebFolders, or the Web interface. The steps for users to follow are:

1. Download the Setup.exe file from /ifs/clients/filesync onto your PC and execute the file. This will install the FileSync component on your local PC.

2. Click the Oracle 9iFS FileSync program icon, which is on your Start -> Programs program listing.

Installing the Command Line Client Utilities

The Oracle 9iFS Command Line Client Utilities are available on any machine where Oracle 9iFS has been installed. They can also be installed on a Solaris client or a PC, or by copying a directory from the Oracle 9iFS server to a directory on your local machine.

You can map a network drive using SMB or use the Network Neighborhood on your local machine to access these directories. You can also access these directories using FTP.

To install the Oracle 9iFS Command Line Utilities:

1. Change to the directory on your local machine into which you want to place the Command Line Utilities. For example, on a Windows client machine:

   c:\cd cmdline
   

2. Using the Windows NT/2000 client or FTP software, map a network drive the Oracle 9iFS server. The specific location depends on the client:

• For a Solaris client, change the directory to /ifs/clients/cmdline/unix.

• For a PC client, change the directory to /ifs/clients/cmdline/win32.

• Copy the contents of the appropriate platform directory for your machine to your local directory; for example, c:\cmdline in the example above.

• Edit the following parameters in the ifscmdline.sh or ifscmdline.bat file. If you are using a Windows client, use WordPad to save the formatting.
  • IFS_CMD_CLASSPATH--The location of the cmdlineutils.jar file. Set to the path on the local machine; for example, c:\cmdline\cmdlineutils.jar in the example.

  • IFS_COOKIE_DIRECTORY--The session information for the Command Line Client Utilities is maintained in the IfsCookie file, which is generated each time a user logs in. This variable specifies where this file should be placed on the local system. If this variable is not set, the IfsCookie file will be saved into the current working directory.

  • JRE_CMD--The location of either the JDK binary. For example, C:\jdk1.2.2\bin\java.

  • IFS_CUP_SERVER--Set this variable to the server where the Command Line Utility Protocol Server (CUP) is running, for example, ifstestmachine. This variable must be set when running the Command Line Utilities on a client machine since the Command Line Utility Protocol Server (CUP) will not be locally available.

  • IFS_CUP_PORT--All Oracle 9iFS commands access the CUP using the default port, 4180. If the CUP server is started on a port other than 4180, this variable must be set to that port number. For example, if you start the CUP on port 4182, this variable must be set to 4182.

For more information on the Command Line Utilities, see the Oracle Internet File System Setup and Administration Guide.

NFS Client Configuration

The Network File System (NFS) protocol is used to provide file sharing between a client machine and a server machine across a network. The NFS protocol is a standard protocol widely used for file sharing on UNIX platforms. Although used primarily on UNIX platforms, the NFS protocol is designed to be operating system-independent and implementations of the NFS protocol exist for other platforms, such as Windows. This section describes how to install NFS clients for the various platforms.

Solaris 2.7, 2.8

If the Oracle 9iFS NFS server is running as the primary NFS server on the host, then a standard mount command can be used to mount Oracle 9iFS.

Syntax:

    mount <host>:<pathname> <mount_point> 

Example:

    mount ifsserver:home /data/ifs 

If the Oracle 9iFS NFS server is not the primary NFS server on the host, then the port number for the Oracle 9iFS NFS server must be explicitly specified. Either of the following two commands can be used to mount a secondary iFS server.

Syntax:

    mount -o port=4049,public <host>:<pathname> <mount_point> 

Example:

    mount -o port=4049,public ifsserver:home /data/ifs 

Syntax:

    mount nfs://<host>:4049/<pathname> <mount_point> 

Example:

    mount nfs://ifsserver:4049/home /data/ifs 

Red Hat Linux 6.2

If the Oracle 9iFS NFS server is running as the primary NFS server on the host, then a standard mount command can be used to mount Oracle 9iFS.

Syntax:

    mount <host>:<pathname> <mount_point> 

Example:

    mount ifsserver:home /data/ifs 

If the Oracle 9iFS NFS server is not the primary NFS server on the host, then the port number for the Oracle 9iFS NFS server and the Oracle 9iFS Mount server must be explicitly specified. The following command can be used to mount a secondary Oracle 9iFS server.

Syntax:

    mount -o port=4049,mountport=4048 <host>:<pathname> <mount_point> 

Example:

    mount -o port=4049,mountport=4048 ifsserver:home /data/ifs 

Hummingbird NFS Maestro 7.0

Before using the Hummingbird NFS Maestro client to access the Oracle 9iFS NFS server, you will need to check that the NFS Maestro client is properly configured.

Configuring Hummingbird NFS Maestro

1. From the Control Panel, bring up the Network settings.

2. Find NFS Maestro Client and display its properties. The precise steps for locating the NFS Maestro Client properties will vary depending upon whether you are on Windows 98, Windows NT or Windows 2000. The Hummingbird NFS Maestro Client Properties dialog will be displayed:

Figure 7-2 Hummingbird NFS Maestro Client Properties

Select the Properties button for System/UNIX authentication to display the Location of the Authentication Server dialog (Figure 7-3).

Figure 7-3 Location of the Authentication Server

Text description of the illustration 6nfspro2.gif

Enter the location of the authentication server and click OK. NFS Maestro requires an authentication server to validate that the username and password used when linking to an NFS server is a valid Unix username and password.

NFS Maestro will first try to access an authentication server on the NFS server machine. If an authentication server is not running on the NFS server machine, NFS Maestro will try to use the default authentication server. Check with your system administrator to determine if you will need to specify a default authentication server.

Linking an NFS Directory Using the NFS Maestro Network Access Tool

1. From the NFS Maestro folder, start the NFS Network Access tool. The NFS Network Access dialog displays (Figure 7-4).

Figure 7-4 NFS Network Access Dialog

Text description of the illustration 6nfs1acc.gif

Select the Advanced button to bring up the Advanced Connection Properties dialog (Figure 7-5).

Figure 7-5 Advanced Connection Properties Dialog

Text description of the illustration 6nfs2acc.gif

    nfs link <drive>: \\<host>\<pathname> <username> 

    nfs link n: \\ifsserver\home scott 

    nfs link <drive>: \\<host>\<pathname> <username> /n:<port_number> 

    nfs link n: \\ifsserver\home scott /n:4049