Oracle Internet File System. Setup and Administration Guide

268 Pages·2000·2.104 MB·English

by  Nicklin A.

(cid:1)
Oracle Internet File System
Setup and Administration Guide
Release 1.1
September2000
PartNo. A81197-05
SetupandAdministrationGuide,Release1.1
PartNo. A81197-05
Copyright©1999,2000,OracleCorporation.Allrightsreserved.
PrimaryAuthor: AimeeNicklin
ContributingAuthors: JeffBackes,DenniseBrown,EdmondChui,DennisDawson,VijayDevadhar,
KevinGillett,TomGrant,MeiHong,FrancineHyman,VasantKumar,TimLockwood,DaveLong,David
Pitfield,KarthikRaju,SylivaPerez,TinaSeto,DavidTom
ThePrograms(whichincludeboththesoftwareanddocumentation)containproprietaryinformationof
OracleCorporation;theyareprovidedunderalicenseagreementcontainingrestrictionsonuseand
disclosureandarealsoprotectedbycopyright,patent,andotherintellectualandindustrialproperty
laws.Reverseengineering,disassembly,ordecompilationoftheProgramsisprohibited.
Theinformationcontainedinthisdocumentissubjecttochangewithoutnotice.Ifyoufindanyproblems
inthedocumentation,pleasereportthemtousinwriting.OracleCorporationdoesnotwarrantthatthis
documentiserrorfree.Exceptasmaybeexpresslypermittedinyourlicenseagreementforthese
Programs,nopartoftheseProgramsmaybereproducedortransmittedinanyformorbyanymeans,
electronicormechanical,foranypurpose,withouttheexpresswrittenpermissionofOracleCorporation.
IftheProgramsaredeliveredtotheU.S.Governmentoranyonelicensingorusingtheprogramson
behalfoftheU.S.Government,thefollowingnoticeisapplicable:
RestrictedRightsNoticeProgramsdeliveredsubjecttotheDODFARSupplementare"commercial
computersoftware"anduse,duplication,anddisclosureofthePrograms,includingdocumentation,
shallbesubjecttothelicensingrestrictionssetforthintheapplicableOraclelicenseagreement.
Otherwise,ProgramsdeliveredsubjecttotheFederalAcquisitionRegulationsare"restrictedcomputer
software"anduse,duplication,anddisclosureoftheProgramsshallbesubjecttotherestrictionsinFAR
52.227-19,CommercialComputerSoftware-RestrictedRights(June,1987).OracleCorporation,500
OracleParkway,RedwoodCity,CA94065.
TheProgramsarenotintendedforuseinanynuclear,aviation,masstransit,medical,orotherinherently
dangerousapplications.Itshallbethelicensee'sresponsibilitytotakeallappropriatefail-safe,backup,
redundancy,andothermeasurestoensurethesafeuseofsuchapplicationsiftheProgramsareusedfor
suchpurposes,andOracleCorporationdisclaimsliabilityforanydamagescausedbysuchuseofthe
Programs.
Oracleisaregisteredtrademark,andinterMediaText,Gist,JDeveloper,OracleApplications,Oracle
ParallelServer,OracleReports,OracleWorkflow,andOracle8aretrademarksorregisteredtrademarksof
OracleCorporation.Othernamesmaybetrademarksoftheirrespectiveowners.
Contents
Send Us Your Comments.................................................................................................................. xiii
Preface......................................................................................................................................................... xv
IntendedAudience............................................................................................................................... xv
SkillsRequiredtoAdministerOracleiFS.......................................................................................... xv
StructureofthisGuide........................................................................................................................ xvi
RelatedDocuments............................................................................................................................. xvii
1 Getting Started with OracleiFS
WhatisOracleiFS?............................................................................................................................. 1-2
BenefitsofUsingOracleiFS........................................................................................................ 1-2
Files:ADefinition......................................................................................................................... 1-4
OracleiFSService......................................................................................................................... 1-4
TheOracleHTTPServer.............................................................................................................. 1-4
OracleiFSComponents..................................................................................................................... 1-5
OracleiFSUsesThreeTypesofObjects........................................................................................ 1-6
SettingUpOracleiFSisaFour-StepProcess................................................................................ 1-7
Task1:PlanYourSystemandSetUptheFolderHierarchy.................................................. 1-8
Task2:AddUsersandGroups................................................................................................... 1-9
Task3:LoadFilesintoOracleiFS.............................................................................................. 1-9
Task4:SetUpSecurity................................................................................................................ 1-9
iii
TheFiveAdministrationTools....................................................................................................... 1-10
UseOracleiFSManagerAsAnExtensionofOEM............................................................... 1-10
UsetheWebInterfaceforBasicTasks..................................................................................... 1-13
UseXMLConfigurationFilestoCreateRepositoryObjects................................................ 1-14
UsetheCommandLineUtilitiesforRegularMaintenance................................................. 1-15
UseServerManagertoManageandMonitortheRunningServersandAgents.............. 1-15
2 Starting OracleiFS
StartingOracleiFS.............................................................................................................................. 2-2
StartingServerManager.................................................................................................................... 2-2
UsingifstartonUNIX.................................................................................................................. 2-3
UsingifsstartonWindowsNT................................................................................................... 2-4
UsingtheifssvrmgrCommand.................................................................................................. 2-4
StoppingOracleiFS............................................................................................................................ 2-5
ShuttingDownAllAgentsandServersinOracleiFS............................................................. 2-5
ShuttingDownAllAgentsandServersManagedbyaSpecificServerManager.............. 2-6
ShuttingDownSpecificAgentsorServersManagedbyaSpecificServerManager......... 2-6
StartingtheJWS.................................................................................................................................. 2-7
ConfiguringtheSystemforOptimalPerformance...................................................................... 2-8
PropertyDescriptions.................................................................................................................. 2-8
SecondaryProperties.................................................................................................................... 2-9
UsingAnalyze............................................................................................................................... 2-9
LoggingInastheAdministratorfortheFirstTime................................................................... 2-10
StartingandLoggingintoOracleiFSManager..................................................................... 2-10
3 Using OracleiFS Manager
OracleiFSManager:AnOverview.................................................................................................. 3-2
YouMustHaveAdministrativePermissions........................................................................... 3-2
PartsoftheOracleiFSManagerWindow...................................................................................... 3-2
MenuBar........................................................................................................................................ 3-3
ConnectionInformation............................................................................................................... 3-5
Toolbar............................................................................................................................................ 3-5
Navigator....................................................................................................................................... 3-6
ContextMenus.............................................................................................................................. 3-7
DetailView.................................................................................................................................... 3-7
iv
StatusBar....................................................................................................................................... 3-7
Browser.......................................................................................................................................... 3-7
UsingCreateandCreateLiketoCreateNewObjects................................................................. 3-8
WorkingwithPropertySheets....................................................................................................... 3-10
ModifyingObjectsUsingPropertySheets.............................................................................. 3-10
GettingHelp...................................................................................................................................... 3-11
4 Task 1: Set Up the Folder Hierarchy
WhatIsaFolderHierarchy?............................................................................................................. 4-2
WhatIsaFolderinOracleiFS?................................................................................................... 4-2
WhatIsInstalled?......................................................................................................................... 4-2
GuidelinesforStructuringtheFolderHierarchy......................................................................... 4-3
PlanningYourFolderHierarchyandAccessRequirements...................................................... 4-4
DefaultFolderACLs.................................................................................................................... 4-4
SettingUptheFolderHierarchy:TheStepstoFollow................................................................ 4-5
1.DefinetheStructure................................................................................................................. 4-5
2.NameandDescribetheFolders............................................................................................. 4-5
3.DefineFolderSecurity............................................................................................................. 4-5
4.CreatetheHierarchy................................................................................................................ 4-5
5.SettheMountPoints................................................................................................................ 4-5
CreatingandDeletingFoldersUsingOracleiFSManager........................................................ 4-6
DeletingaFolderUsingOracleiFSManager........................................................................... 4-6
CreatingFoldersUsingtheCommandLineUtilities.................................................................. 4-7
CreatingMultipleFoldersUsingXML........................................................................................... 4-8
CreatingandModifyingMountPoints.......................................................................................... 4-9
CreatingMountPoints................................................................................................................. 4-9
ModifyingMountPoints........................................................................................................... 4-11
DeletingMountPoints............................................................................................................... 4-11
SettingUpFoldersforUsers........................................................................................................... 4-11
5 Task 2: Add Users and Groups
UnderstandingUsersinOracleiFS................................................................................................. 5-2
UserProfiles.................................................................................................................................. 5-2
CredentialManagerUsers........................................................................................................... 5-2
HTTPAuthentication................................................................................................................... 5-3
v
CreatingUsers............................................................................................................................... 5-3
SettheDefaultUserDefinitionsUsingOracleiFSManager.................................................... 5-4
CreatetheOracleiFSUsersUsingOracleiFSManager.............................................................. 5-6
UsinganXMLConfigurationFiletoCreateUsers....................................................................... 5-9
XMLExample................................................................................................................................ 5-9
AdditionalUserDefinitions...................................................................................................... 5-10
ViewingUsers.................................................................................................................................... 5-13
ChangingaUser’sPassword........................................................................................................... 5-13
ChangingaUser’sHomeFolder.................................................................................................... 5-13
ChangingaUser’sDefaultACLforDocuments........................................................................ 5-14
ChangingaUser’sE-mailAddress................................................................................................ 5-14
ChangingaUser’sQuotaControl.................................................................................................. 5-14
DeletingUsers................................................................................................................................... 5-14
CreatingGroupsUsingOracleiFSManager............................................................................... 5-16
ViewingGroups................................................................................................................................ 5-17
AddingUsersandGroupstotheTargetGroup.......................................................................... 5-17
RemovingGroupsandUsersfromtheTargetGroup................................................................ 5-18
RenamingGroups............................................................................................................................. 5-18
DeletingGroups................................................................................................................................ 5-18
CreatingGroupswithXML............................................................................................................ 5-19
6 Task 3: Load Files into OracleiFS
TheFourWaystoLoadFilesintoOracleiFS................................................................................. 6-2
DragandDropintheWindowsandWebInterfaces.............................................................. 6-2
UseFTPtoLoadFiles................................................................................................................... 6-2
BrowseandUploadUsingtheWebInterface.......................................................................... 6-2
UsetheCommandLineUtilities................................................................................................ 6-2
DragandDropFilesintoOracleiFS............................................................................................... 6-3
FTPYourFilesintoOracleiFS.......................................................................................................... 6-3
UploadFilesUsingtheWeb............................................................................................................. 6-4
UploadFilesUsingtheCommandLineUtilities......................................................................... 6-5
VersionedVs.Non-VersionedFiles................................................................................................. 6-5
DeletingOlderFileVersions............................................................................................................ 6-6
MigratingYourData........................................................................................................................... 6-6
vi
7 Task 4: Set Up Security
OverviewofSecurityinOracleiFS................................................................................................. 7-2
TheSystemACLs.......................................................................................................................... 7-2
WorkingwithACEs..................................................................................................................... 7-3
WorkingwithPermissionBundles............................................................................................ 7-3
UsersandGroupsasGrantees......................................................................................................... 7-6
PrimaryUserProfilesandDefaultACLs....................................................................................... 7-7
CreatingaCustomACL..................................................................................................................... 7-7
ModifyingACLs................................................................................................................................. 7-9
DeletingACLs................................................................................................................................... 7-10
UsingtheWebInterfacetoApplyACLstoaFolderorFile..................................................... 7-10
UsingtheWindowsInterfacetoApplyanACL......................................................................... 7-10
UsingXMLtoCreateanACL......................................................................................................... 7-11
Example........................................................................................................................................ 7-11
8 Using Server Manager to Start and Stop Servers
ServerManager:AnOverview......................................................................................................... 8-2
ManagingServerManagerwithOracleiFSManager................................................................. 8-4
PartsoftheOracleiFSMonitorWindow.................................................................................. 8-4
StartingOracleiFSMonitor......................................................................................................... 8-7
StartingAnAgentwithOracleiFSMonitor................................................................................. 8-9
StoppingAnAgentwithOracleiFSMonitor........................................................................... 8-9
StoppingaServerManagerInstancewithOracleiFSMonitor............................................. 8-9
UsingtheCommandLinetoManageServerManager............................................................. 8-10
MonitoringServerManagerServersandAgents.................................................................. 8-11
ServerManagerCommands—TheCompleteList................................................................. 8-11
OracleiFSAgents............................................................................................................................. 8-13
ExpirationAgent......................................................................................................................... 8-15
GarbageCollectionAgent......................................................................................................... 8-15
ContentGarbageCollectionAgent.......................................................................................... 8-17
DanglingObjectAVCleanupAgent....................................................................................... 8-17
EventExchangerAgent............................................................................................................. 8-18
ExternalServerAgent................................................................................................................ 8-19
ServiceWatchdogAgent........................................................................................................... 8-22
QuotaAgent................................................................................................................................ 8-23
vii
OutboxAgent.............................................................................................................................. 8-24
DefinitionFilesforProtocolServers............................................................................................ 8-24
WindowsClientProtocol(WCP)Server................................................................................. 8-25
WindowsNTFileSystemProtocolServer(forWindowsNT)............................................ 8-26
SimpleMailTransferProtocol(SMTP)Server....................................................................... 8-27
InternetMailAccessProtocol(IMAP)Server......................................................................... 8-28
ServerMessageBlock(SMB)ProtocolServer......................................................................... 8-29
FileTransferProtocol(FTP)Server.......................................................................................... 8-31
CommandLineUtilitiesProtocol(CUP)Server.................................................................... 8-33
9 Configuration and Back Up
ConfigurationandPortIssues.......................................................................................................... 9-2
ProtocolsandtheirPorts.............................................................................................................. 9-2
ConfiguringE-mail............................................................................................................................. 9-3
E-mailSetupforUNIX................................................................................................................. 9-3
SendmailConfigurationforUNIX............................................................................................. 9-3
IntegratingOracleiFSMailandSendmailPro8.9.3.................................................................... 9-5
InstallingSendmailPro8.9.3....................................................................................................... 9-5
OracleiFSInstallationDependencies........................................................................................ 9-5
ConfiguringSendmail.................................................................................................................. 9-5
QuickSetupSteps......................................................................................................................... 9-6
SendmailPro8.9.3GraphicalAdministrationTool................................................................. 9-6
UsingE-mailwithOracleiFS...................................................................................................... 9-6
UsingtheWindowsNTFileSystemProtocolServer.................................................................. 9-7
AccessingOracleiFSthroughtheWindowsNTFileSystemProtocolServer.................... 9-7
StartingtheWindowsNTFileSystemProtocolServer.......................................................... 9-8
BackupandRecoveryofData.......................................................................................................... 9-9
SavingtheSoftwareInstallation................................................................................................. 9-9
SavingtheData............................................................................................................................. 9-9
ConfiguringOracleApacheWebServer........................................................................................ 9-9
ConfiguringApacheAsYourWebServeronWindowsNT..................................................... 9-10
10 Using OracleiFS Manager for Development Tasks
ClassObjects:AnOverview........................................................................................................... 10-2
TheCompleteClassHierarchy....................................................................................................... 10-2
viii
CreatingClassObjects..................................................................................................................... 10-4
AddExtendedAttributes.......................................................................................................... 10-7
ModifyingClassObjects............................................................................................................... 10-10
DeletingClassObjects................................................................................................................... 10-11
ClassDomains:AnOverview...................................................................................................... 10-11
WhyUseaClassDomain?...................................................................................................... 10-11
CreatingClassDomains................................................................................................................ 10-12
ModifyingClassDomains............................................................................................................ 10-13
DeletingClassDomains................................................................................................................ 10-13
ValueDomains:AnOverview...................................................................................................... 10-13
WhyUseaValueDomain?..................................................................................................... 10-14
CreatingValueDomains............................................................................................................... 10-14
ModifyingValueDomains........................................................................................................... 10-16
DeletingValueDomains............................................................................................................... 10-16
ValueDefaults:AnOverview....................................................................................................... 10-16
WhyUseaValueDefault?...................................................................................................... 10-16
Example...................................................................................................................................... 10-16
CreatingValueDefaults................................................................................................................ 10-17
ModifyingValueDefaults............................................................................................................ 10-18
DeletingValueDefaults................................................................................................................ 10-18
AgentsandOverrides:AnOverview.......................................................................................... 10-19
WhatIsanAgent?.................................................................................................................... 10-19
WhatisanOverride?............................................................................................................... 10-19
UsingJavaServerPagestoDisplayDocumentsinOracleiFS.............................................. 10-20
JSPExecution............................................................................................................................. 10-20
RegisteringJSPs.............................................................................................................................. 10-21
ModifyingJSPs............................................................................................................................... 10-22
DeletingJSPs................................................................................................................................... 10-22
Parsers:AnOverview..................................................................................................................... 10-23
RegisteringParsers......................................................................................................................... 10-24
RegisteringaParserbyExtension.......................................................................................... 10-25
RegisteringanXMLParser..................................................................................................... 10-25
ModifyingParsers.......................................................................................................................... 10-26
DeletingParsers.............................................................................................................................. 10-26
Renderers:AnOverview............................................................................................................... 10-26
ix
RegisteringRenderers.................................................................................................................... 10-27
ModifyingRenderers..................................................................................................................... 10-30
DeletingRenderers......................................................................................................................... 10-30
Formats/Mimetypes:AnOverview............................................................................................. 10-30
CreatingFormats/Mimetypes....................................................................................................... 10-31
ModifyingaFormat/Mimetype.................................................................................................... 10-32
DeletingaFormat/Mimetype........................................................................................................ 10-32
11 OracleiFS Repository Views
UsingtheOracleiFSRepositoryViewsforSystemMaintenance.......................................... 11-2
OracleiFSHasEightDifferentOracleiFSRepositoryViews................................................. 11-2
Example:SelectingAttributesofaDocument........................................................................ 11-9
12 What Your Users Need to Know
WhatYourUsersNeedtoKnowAboutWorkingwiththeWindowsInterface................... 12-2
InstallingtheOracleOracleiFSUtilities................................................................................. 12-2
Right-ClickanOracleiFSFolderorFiletoAccessOracleiFSFunctions........................... 12-3
ConnectingtoMountPoints..................................................................................................... 12-4
WhatYourUsersNeedtoKnowAboutWorkingwiththeWebInterface............................ 12-5
SupplyYourUserswiththeURLfortheWebInterface....................................................... 12-5
ToConnecttoaMountPointUsingtheWebInterface:....................................................... 12-6
13 OracleiFS Log Files and Troubleshooting Information
TroubleshootingGeneralProblems.............................................................................................. 13-2
OracleiFSConfigurationAssistantErrors.............................................................................. 13-2
StoppingMultipleServerInstancesoftheSameName........................................................ 13-3
UsingtheOracleiFSLogFiles....................................................................................................... 13-4
UsingtheConfigurationLogFiles................................................................................................ 13-4
IfsConfigOut.log......................................................................................................................... 13-5
IfsConfigSql.log........................................................................................................................... 13-5
CommonErrorsFoundintheIfsConfigOut.logandIfsConfigSql.logFiles...................... 13-5
UsingtheProtocolServerLogFiles.............................................................................................. 13-6
TheSMBLogFile........................................................................................................................ 13-6
TheFTPandCUPLogFiles...................................................................................................... 13-7
x