Novell Open Enterprise Server 11 SP3 User guide

www.novell.com/documentation

Novell Archive and Version Services

User Guide

Open Enterprise Server 11 SP2

January 2014

Legal Notices

Novell,Inc.,makesnorepresentationsorwarrantieswithrespecttothecontentsoruseofthisdocumentation,andspecifically

disclaimsanyexpressorimpliedwarrantiesofmerchantabilityorfitnessforanyparticularpurpose.Further,Novell,Inc.,

reservestherighttorevisethispublicationandtomakechangestoitscontent,at

anytime,withoutobligationtonotifyany

personorentityofsuchrevisionsorchanges.

Further,Novell,Inc.,makesnorepresentationsorwarrantieswithrespecttoanysoftware,andspecificallydisclaimsany

expressorimpliedwarrantiesofmerchantabilityorfitnessforanyparticularpurpose.Further,Novell,Inc.,reservestheright

makechangestoanyandallpartsofNovellsoftware,atanytime,withoutanyobligationtonotifyanypersonorentityof

suchchanges.

AnyproductsortechnicalinformationprovidedunderthisAgreementmaybesubjecttoU.S.exportcontrolsandthetrade

lawsofothercountries.Youagreeto

complywithallexportcontrolregulationsandtoobtainanyrequiredlicensesor

classificationtoexport,re‐exportorimportdeliverables.Youagreenottoexportorre‐exporttoentitiesonthecurrentU.S.

exportexclusionlistsortoanyembargoedorterroristcountriesasspecifiedintheU.S.

exportlaws.Youagreetonotuse

deliverablesforprohibitednuclear,missile,orchemicalbiologicalweaponryenduses.SeetheNovellInternationalTrade

ServicesWebpage(http://www.novell.com/info/exports/)formoreinformationonexportingNovellsoftware.Novellassumes

noresponsibilityforyourfailuretoobtainanynecessaryexportapprovals.

Novell,Inc.Allrightsreserved.Nopartofthispublicationmaybereproduced,photocopied,storedon

aretrievalsystem,ortransmittedwithouttheexpresswrittenconsentofthepublisher.

Novell, Inc.

1800 South Novell Place

Provo, UT 84606

U.S.A.

www.novell.com

OnlineDocumentation:ToaccessthelatestonlinedocumentationforthisandotherNovellproducts,seetheNovell

DocumentationWebpage

(http://www.novell.com/documentation/oes11).

Contents 3

Contents

About This Guide 5

1 Overview of Archive and Version Services 7

1.1 Individual File Losses Can Impact Business . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

1.2 Benefits of Archive and Version Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

1.3 Key Concepts of Archive and Version Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

1.4 What’s Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2 What’s New or Changed in Archive and Version Services 11

2.1 What’s New (OES 11 SP2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

2.2 What’s New (OES11 SP1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.3 What’s New (OES11). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

3 Prerequisites and Guidelines for Retrieving File Versions 13

3.1 Prerequisites for Retrieving File Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

3.2 Guidelines for Availability of File Versions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

3.3 NSS File Version Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3.4 Prerequisites for Using the NetStorage Archive Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

4 Installing and Using the NSS File Version Utility 17

4.1 Installing NSS File Version Utility on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

4.1.1 Uninstalling NSS File Version Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

4.2 Installing NSS File Version Utility on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

4.2.1 Uninstalling NSS File Version Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

4.3 Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

4.3.1 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

4.3.2 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

4.4 Viewing the Versioning Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

4.5 Using the NSS File Version Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

4.5.1 Accessing NSS File Version Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

4.5.2 Searching for File Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

4.5.3 Restoring a File Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

4.5.4 Restoring Directory Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24

4.5.5 Deleting All Versions of an Archived File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

5 Restoring File Versions with NetStorage 27

5.1 Accessing Novell NetStorage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

5.2 Navigating the NetStorage Archive Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

5.2.1 Directory Contents Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

5.2.2 Multiple Version Sets Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

5.2.3 File Versions Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

5.3 Restoring a File Version Using NetStorage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33

4 OES 11 SP2: Novell Archive and Version Services User Guide

6 Troubleshooting 39

6.1 NSS File Version Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

A Documentation Updates 41

A.1 January 2014 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

A.1.1 What’s New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

A.2 August 2012. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

A.2.1 What’s New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

About This Guide 5

About This Guide

Thisguidedescribeshowtoaccess,retrieve,andrestoremultiplehistoricalversionsofyourfilesthat

aresavedandmaintainedinaNovellArchiveandVersionServicesonaNovellOpenEnterprise

Server(OES)11SP2server.

 Chapter 1,“OverviewofArchiveandVersionServices,”onpage 7

 Chapter 2,“What’sNewor

ChangedinArchiveandVersionServices,”onpage 11

 Chapter 3,“PrerequisitesandGuidelinesforRetrievingFileVersions,”onpage 13

 Chapter 4,“InstallingandUsingtheNSSFileVersionUtility,”onpage 17

 Chapter 5,“RestoringFileVersionswithNetStorage,”onpage 27

 Chapter 6,“Troubleshooting,”onpage 39

Audience

Thisguideisintendedforusersintheenterprisewhohavenetworkfilesthataresubjecttointerval‐

basedarchivalbyNovellArchiveandVersionServices.

Feedback

Wewanttohearyourcommentsandsuggestionsaboutthismanualand theotherdocumentation

includedwiththisproduct.PleaseusetheUserCommentfeatureatthebottomofeachpageofthe

onlinedocumentation,orgotowww.novell.com/documentation/feedback.htmlandenteryour

commentsthere.

Documentation Updates

ForthemostrecentversionoftheNovellArchiveandVersionServicesUserGuide,seethelatestNovell

OpenEnterpriseServer11documentation(http://www.novell.com/documentation/oes11/

index.html).

Additional Documentation

NovellArchiveandVersionServicesallowsuserstorestoreindividualfilerecoveryofpreviously 

versionedfilesfromanarchive.Yournetworkadministratorinstalls,configures,andmaintainsthe

archiveserverwhereyourfilesareversionedandstoredinanarchivedatabase.Forinforma tion,see

theOES11SP2:NovellArchiveandVersion

ServicesAdministrationGuide.

NovellNetStorageprovidestheWeb‐basedinterfaceforretrievingfilesfromtheNovellArchiveand

VersionServicesserver.Forinformation,seeUsingNetStorageintheOES11SP2:NetStorage

AdministrationGuideforLinux.

6 OES 11 SP2: Novell Archive and Version Services User Guide

Overview of Archive and Version Services 7

Overview of Archive and Version

Services

NovellArchiveandVersionServicesonOES11SP2capturesandstoresperiodicversionsofyour

networkfilesinanarchivedatabase.Asyouwork,thearchiveservertransparentlysavesversionsof

yournetworkfilesthatyoucreate,modify,ordeleteduringascheduledinterval.Ifyourenameor

deletea

directoryorfile,thencreateanotheronewiththesamename,thearchiveserver

distinguishesthoseinstancesandmaintainssetsoftherelatedversions.

ArchiveandVersionServicesfreestheadministratortofocusonothercriticalITissues.Youcanview

alistofversionsofthesourcefiles,select

therequiredfile,thenrecoverit.Youcanaccessfileversions

fromanywhere,atanytime,usingaWebbrowserandanactivenetworkorInternetconnection

withoutthehelpofyouradministrator.

Thissectiondiscussesthefollowing:

 Section 1.1,“IndividualFileLossesCanImpactBusiness,”onpage 7

 Section 1.2,“BenefitsofArchive

andVersionServices,”onpage 8

 Section 1.3,“KeyConceptsofArchiveandVersionServices,”onpage 8

 Section 1.4,“What’sNext,”onpage 10

1.1 Individual File Losses Can Impact Business

Mostenterprisesrelyonyourbestpracticesandpersonalhabitstoprotectyourindividualfiles

betweenbackups.Standardbackupprocedurescapturenetworkfilesperiodicallytoprevent

catastrophicloss.However,backupsdonottrackmodifications,renaming,anddeletionsyoumake

tofilesinbetweenbackups.Youmightemploydifferenttechniquestoensure

thatyoudonotlose

criticalfiles.Forexample,youmightsavemultipleversionsofafileunderdifferentnamesasyou

modifyitovertime.Youmightsavethefileindifferentlocations.Youmightdoboth.

Despiteprecautions,almosteveryuserhasaccidentallymodified,lost,ordeleteda

keyfile.When

problemsoccur,youareleftwithtwochoices:

 Waitfortheadministratortorecoverthefilefrombackupmedia, ifthefilewasbackedupatall.

 Painstakinglyrebuildthefilefromdraftversionsorfromscratch.

File Recovery and Restoration Efforts Waste Resources

Wheneveryouloseafile,youandyourcompanylosethetimeandresourcesinvestedincreatingthe

datainit.Bothfilerecoveryandreconstructioneffortswastevaluableresources:

 It’sinefficient.Youcannotaccess backupfileswithoutadministratoraction.

8 OES 11 SP2: Novell Archive and Version Services User Guide

 It’sinconvenient.Youmustwastetimere‐creatingmaterials.

 It’scostly.Datalosscanaffecttheenterprise’sabilitytomeetbusinesscommitments.Timelost

canimpactyourabilitytomeetmilestones,therebyimpactingdeliverytootherprocessesdown

theline.

System-Level Backup and Recovery Measures Are Not Enough

Mostenterprisesimplementsometypeofsystem‐leveldatabackupandrecoverytopreventagainst

majordatalosses.Backupsoccurperiodicallytopreventcatastrophiclossesofdata.Often,thefiles

youlosehavealifecycleshorterthanthemajorbackupcycles.Untilnow,thesedatalosseshavebeen

anunfortunate

costofdoingbusiness.

Recoveryofasinglefileisnotasimpleprocess.Onlytheadministratorcanaccessthebackupmedia

toretrieveandrecoverthefile.Youmustknowexactlywhenthefileexistedsothattheadministrator

canfindtherightversionofthefile.

Evenafterthe

fileisrecovered,youmustupdatethefilewithchangesmadebetweenthetimeitwas

backedupuntilthetimeitwasmodified,deleted,orlost.

1.2 Benefits of Archive and Version Services

WithNovellArchiveandVersionServicesforOES11SP2,ifyouloseakeyfile,youhaveresources

availabletorecoverqu icklyandrelativelypainlessly.Yousimplyviewalistofrecentversionsofthe

file,selectthefileneeded,thenrecoverit.

NovellArchiveandVersionServicesoffersmany

benefits:

 Theversioningprocessistransparentuntilyouneedtorestoreapreviousversionofafile.

Versioningdoesnotaffecthowapplicationsbehaveandrequiresnoactiononyourpart.

 Allsecurityfeaturesandpermissionsareineffectforthefileversions.

 Versioningsupportsheterogeneousworkenvironments:

 Versioning

workswithanytypeoffilefromanytypeofapplication.

 Youcan restorefileversionswhileworkingfromanywhere,atanytime,usinganactive

networkorInternetconnection.

Youcontroltheversionrecovery;thereisnoneedtocompletelyrebuildafileortoinvolvetheIT

departmentto

restoreit.NovellArchiveandVersionServiceshelpstominimizeyourunproductive

timeandfreestheadministratortofocusonothercriticalissues.

1.3 Key Concepts of Archive and Version Services

YouradministratorconfiguresandmanagestheNovellArchiveandVersionServicesforfilesstored

onNovellStorageServices(NSS)volumesonaOES11SP2server.Totakeadvantageofthisservice,it

isimportanttounderstandseveralkeyconcepts.

File Versions

Fileversionsarepoint‐in‐timecopiesofnetworkfilesthatresideinanarchivedatabase.Your

networkadministratordetermineswhichfiletypesareeligibleforversioningandhowfrequently

versioningoccursforeachdatavolume.Eligiblefilesthatchangeduringanintervaloftime,calledan

epoch,areversioned

attheendoftheinterval.Nomatterhowmanychangesyoumaketoyourfiles

Overview of Archive and Version Services 9

duringanepoch,onlythoseeligiblefilesthatexistattheendoftheepochareversionedandstoredin

thearchivedatabase.Metadatachangesforeligiblefilesarealsonotedinthedatabase.Fileversions

resideinthearchivedatabaseuntiltheyaremanuallydeletedoruntiltheymeetcriteria

forautomatic

deletion.

NOTE:Filenamewithaspecialcharactercolon(:)isnoteligibleforversioning.

Versioning Schedule

Yoursys tem administratorestablishesaversioningschedulethatmeetsuserrequirementsforfile

versioning,givenlimitedstorageandbandwidthresources.

Archive Database

Fileversionsresideinthearchivedatabaseonthearchiveserver.Youcanretrievefileversionsfrom

thearchivedatabaseatanytime,fromanywhere,usingtheArchivefunctioninNovellNetStorage.

YoucanalsousetheNSSFileVersionUtilityonyourWindows2000/XP/VistaorSUSELinux

Enterprise

Desktop(SLED)10orSLED10SP1workstationtoretrievefilesfromthearchivedatabase.

Forsecurityreasons,therestoredfileordirectoryanditscontentareassignedtheirmostrecent

settingsforfilesystema ttributes,trustees,andtrusteerightstoyourOES11SP2NSSvolume.

File Eligibility Policy

Youradministratorsetscriteriatodeterminewhichfilesareeligibleforversioning.Filescanbe

includedorexcludedaccordingtotheirpath,fileextension,orfilenamepatterns.Ifyourfilesmeet

theresultantcriteria,theyareeligibleforversioning.Youdonothavedirectcontroloverwhichof

yourfilesare

versioned,whentheversioningoccurs,orwhatthestateofyourfilesiswhentheepoch

endsandthefileversionsarecopiedtothearchivedatabase.Workwithyouradministratorto

establishyourversioningneeds.

Version Delete Policy

Theadministratorcontrolshowlongfileversionsarekeptandhowmanyfileversionscanexistata

time.Versionedfilesmighthavealimitedlifetimeinthearchive.Thedeletepolicyforvolumescan

beconfiguredtoallowindefiniteretentionofatleastonemostrecentfileversion.Workwith

your

administratortoestablishyourfileretentionneeds.

Versioning Policy

Administratorsetstheversioningcriteria likefilestobeversioned,whenversioningoccurs,orthe

stateofthefileswhentheepochends,filters,deletepolicyforallthefilesonaparticularvolume.All

thisinformationisdisplayedintheVe rsioning Policy ,Right‐clicktheArchiveiconinthesystem

tray

andselectViewVersioningPolicytoviewthedetails.

NSS File Version Utility for File or Directory Retrieval and Restoration

TheNSSFileVersionUtilityprovidesconvenientanddirectaccesstoarchivedversionsofyourfiles

usingeitherWindowsorLinuxdesktop.RestoreArchivedVersionsoptionisavailablewhenyouright‐

clickafileordirectoryintheexplorer.Theutilityallowsyoutoviewrecentversionsofyourfilesin



thearchivedatabaseandrestorethedesiredfile.

10 OES 11 SP2: Novell Archive and Version Services User Guide

Novell NetStorage for Web-Based File Retrieval and Restoration

NovellNetStorageprovidesWeb‐basedaccesstoarchivedversionsofyourfilesusingawebbrowser

andinternetconnection.TheArchivefunctionallowsyoutoviewrecentversionsofyourfilesinthe

archivedatabaseandrestorethedesiredfile.Selectthepreviousversionofthefile,thenclickRestore

downloadthefilelocallyortorestorethefileversiontoitslaststoragelocation.

1.4 What’s Next

Usethefollowingtabletodeterminewheretofindtheinformationyouneed.

Table 1-1 PossibleTas ks

If You Need Do This

To understand the requirements for retrieving file

versions

“Prerequisites and Guidelines for Retrieving File

Versions” on page 13

To use the Windows-based NSS File Version Utility to

access file versions

“Installing and Using the NSS File Version Utility” on

page 17

To use the Web-based Archive function in Novell

NetStorage to access file versions

“Restoring File Versions with NetStorage” on page 27

What’s New or Changed in Archive and Version Services 11

What’s New or Changed in Archive and

Version Services

ThissectiondescribesenhancementsandchangesinArchiveandVersionServicessincetheinitial

releaseofNovellOpenEnterpriseServer(OES)11.

 Section 2.1,“What’sNew(OES11SP2),”onpage 11

 Section 2.2,“What’sNew(OES11SP1),”onpage 11

 Section 2.3,“What’sNew(OES11),”onpage 11

2.1 What’s New (OES 11 SP2)

TheArchiveandVersionServicesinOES11SP2hasbeenmodifiedtorunon64‐bitSUSELinux

EnterpriseServer(SLES)11SP3.

IMPORTANT:BeginningwithOES11SP2,thereisnoactivedevelopmentorenhancementto

ArchiveandVersionServicesandsupportwillbelimitedtosecurityfixes.

2.2 What’s New (OES11 SP1)

TheArchiveandVersionServicesinOES11SP1hasbeenmodifiedtorunon64‐bitSUSELinux

EnterpriseServer(SLES)11SP2.TherearenootherchangesintheOES11SP1releaseofArchiveand

VersionServices.

2.3 What’s New (OES11)

TheArchiveandVersionServicesservicehasbeenmodifiedtorunonOES11.Therearenoother

changesintheOES11releaseofArchiveandVersionServices.

12 OES 11 SP2: Novell Archive and Version Services User Guide

Prerequisites and Guidelines for Retrieving File Versions 13

Prerequisites and Guidelines for

Retrieving File Versions

Beforeyoucanaccessinterval‐basedversionsofyourfiles,yournetworkadministratormust

configureNovellArchiveandVersionServices.Thissectionexplainshowyouradministratorcan

configuretheservicetomeetyourarchivalneeds.

 Section 3.1,“PrerequisitesforRetrievingFileVersions,”onpage 13

 Section 3.2,“GuidelinesforAvailabilityofFileVersions,”on

page 14

 Section 3.3,“NSSFileVersionUtility,”onpage 14

 Section 3.4,“PrerequisitesforUsingtheNetStorageArchiveFunction,”onpage 15

3.1 Prerequisites for Retrieving File Versions

Previousversionsofyourfilescanexistinthearchivedatabaseonlyafteryourfilesmeetthe

followingprerequisites:

 YouradministratormustconfigurefileversioningfortheNovellStorageServicesdatavolume

onaOES11SP2serverwhereyourdataisstored.

 Youradministratorsetscriteriatodeterminewhich

filesareeligibleforversioning,suchasby

pathorfileextension.Ifyourfilesmeetthecriteria,theyareeligibleforversioning.

 Versioningoccursforeligiblefilesatscheduledintervals,calledepochs.Youradministratorcan

alsomanuallypauseversioningjobsandrunjobsondemand.

 Afile’slifetime mustspan

theendofoneepochtobeversioned.Onlyfilesthatexistwhenthe

versioningoccursareversioned.Ifyoucreateanddeleteafilewithintheepoch,itcannotbe

versioned.

 Itdoesnotmatterhowmuchorhowoftenyouchangeaneligiblefileduringaepoch.The



versioningprocesscapturesthefileinwhateverstateitisinattheendoftheepoch.Youdonot

havedirectcontroloverwhichofyourfilesareversioned,whentheversioningoccurs,orwhat

thestateofyourfilesiswhentheepochendsandthefileversions

arecopiedtothearchive

database.

 Versionedfilestypicallyhavealimitedlifetimeinthearchive.Theadministratorconfiguresa

deletepolicythatsetsthemaximumkeeptimeandthemaximumnumberofversionstoretain.

Thedeletepolicyforvolumescanbeconfiguredtoallowindefiniteretentionofat

leastonemost

recentfileversion.

 TousetheNSSFileVersionUtility,youmustdownloadtheexecutablefromtheWelcomepage

andinstallonyourWindowsorSLEDdesktop.

 ToaccessversionsusingNovellNetStorage,youradministratormustinstallandconfigurea

NovellNetStorageserver,thenconfigureNetStorageservices

toaccessArchiveservice.

Forinformationabouttheversioningpoliciesforyournetworkfiles,contactyoursystem

administrator.

14 OES 11 SP2: Novell Archive and Version Services User Guide

3.2 Guidelines for Availability of File Versions

AfteryoursystemmeetstheSection 3.1,“PrerequisitesforRetrievingFileVersions,”onpage 13 ,

thereareseveralreasonsthatpreviousversionsofacurrent,renamed,ordeletedfilemightnotexist

inthearchivedatabase.

File Versions Are No Longer Supported for Your Files

Ifyourfileisinavolumeordirectorythatisnolongerconfiguredforversioning,fileversionsmight

notbeavailable.Forinformation,contactyoursystemadministrator.

File’s Lifetime Does Not Span the End of an Epoch

Afileisversionedonlyifitslifetimespansthe endofanepoch.Ifyoucreateafileafteranepoch

begins,anddeleteitbeforetheendoftheepoch,thefilecannotbeversioned.Afile’sversionmight

notbeavailableifitsscheduledversioningprocessesispaused

ordelayedforaperiodoftimethat

exceededthelifetimeofthefile.Althoughthefrequencyoftheepochusuallyislessthanthetypical

lifetimeofyourfiles,theremightbeoccasionswhentheversioningtimeisextended.Forexample,if

thetimeittakestosaveversions

ofallthefileseligibleforversioningexceedsthescheduleepoch

timeinterval,somescheduledepochsmightbeskippeduntilthecurrentprocessendsandthenext

scheduledstarttimeoccurs.

File Is Open During the Versioning Process

Ifafileisopenduringtheversioningprocess,acopyofthefilecannotbesavedtothearchive

database.InOES11SP2,youradministratorhastheoptionofusingNSSpoolsnapshot technology

duringtheversioningprocesstosavepoint‐in‐timecopiesofbothclosedandopen

files.Ifsnapshot

technologyisnotused,thefilesthatareeligibleforversioningarecopieddirectlyfromthesource

volume.Inthiscase,exclusivelyopenfilescannotbeversioned.

File Is Deleted before A Version Is Saved

Ifyourfileexistsattheendofanepoch,butyoudeleteitbeforeitcanbecopiedtothearchive

database,thatfileversionisnotsavedtothearchivedatabase.

File Version Exceeded Retention Thresholds

Typically ,thefile’sarchivedversionsaredeletedaut omaticallyfromthearchivedatabaseasthey

exceedthemaximumtimetokeepversionsorthemaximumnumberofversionspermitted,as

configuredbytheadministrator.

Filenames and Case Sensitivity

ForOES11SP2,filenamesarecasesensitive.Ifyouusethe

Rename

commandtomodifythecaseof

anylettersinafilename, itsfileversionsaresavedunderdifferentname.

3.3 NSS File Version Utility

 NSSFileVersionUtilityforOES11SP2

Prerequisites and Guidelines for Retrieving File Versions 15

 NSSFileVersionUtilityforWindows

3.4 Prerequisites for Using the NetStorage Archive Function

IftheadministratorprovidesaccesstoyournetworkfileswithNovellNetStorage,youcanuseits

Archivefunctiontolocateandrestorefileversionsfromanywhere,atanytime,usingacompatible

WebbrowserandanetworkorInternetconnection.

YouneedanyofthefollowingWebbrowsersonyourcomputer:

 Mozilla*Firefox*1.5.xorlater

 MozillaFirefoxforMacintosh2.0.x

 Microsoft*InternetExplorer6.0SP2orlater

Type Description

Operating System SLED 10 or SLED 10 SP1

Dependencies

 Novell Client 1.2 SP2 or later

 KDE or GNOME* base libraries

 Mono 1.2.2

File Manager Konqueror or Nautilus

Type Description

Operating System

 Windows 2000 Professional SP4

 Windows XP SP2

 Windows Vista

Dependencies

 Novell Client 4.9.1 SP 2 or later for Windows 2000/ XP

 Microsoft .NET 2.0 framework

 Novell Client 1.0 for Windows Vista

16 OES 11 SP2: Novell Archive and Version Services User Guide

Installing and Using the NSS File Version Utility 17

Installing and Using the NSS File Version

Utility

NovellArchiveandVersionServicesforOES11SP2provideconvenientanddirectaccessto

previouslyarchivedversionsofyourfilesusingtheNovellStorageServices(NSS)FileVersionUtility.

Thearchivedfileversionsresideinthearchivedatabase.

Thissectiondiscussesthefollowingtasks:

 Section 4.1,“InstallingNSSFileVersionUtility

onLinux,”onpage 17

 Section 4.2,“InstallingNSSFileVersionUtilityonWindows,”onpage 18

 Section 4.3,“LogFiles,”onpage 18

 Section 4.4,“ViewingtheVersioningPolicy,”onpage 19

 Section 4.5,“UsingtheNSSFileVersionUtility,”onpage 21

4.1 Installing NSS File Version Utility on Linux

Afteryouhavemettheprerequisites,installtheNSSFileVersionUtilityonyourworkstation.For

prerequisites,see“NSSFileVersionUtility”onpage 14.

1 LaunchaWebbrowser,thenopentheWelcomepagewiththefollowingURL:

https://svrname/

ReplacesvrnamewiththeactualDNSnameorIPaddressoftheArchiveserver.

2 Intheleftnavigator,selectClientSoftware>ArchiveVersioning.

Dependingonyourrequirementinsta lltheArchiveVersioning32‐bitClientforLinux(

novell-

versioning-client-i586.tar.gz

)orArchiveVersioning64‐bitClientforLinux(

novell-

versioning-client-x86_64.tar.gz

NOTE:Thestepslistedbelowarefor 32‐bitinstallation.Toinstallon64‐bit,use

novell-

versioning-client-x86_64.tar.gz

3 Installthefollowingrpms:



novell-fileversionutility-linux-1.0.0-x.i586

 DependingonyourdesktopinstalleitherKDEorGNOMEplug‐ins:

 KDE:

novell-fileversionutility-linux-kdeplugin-1.0.0-x.i586

 GNOME:

novell-fileversionutility-linux-nautilus-plugin-1.0.0-x.i586

Afterasuccessfulinstallation,theRestoreArchivedVersionsisavailablewhenyouright‐clickafileor

directoryonanetworkdrive(thatisamappedNSSvolume).

18 OES 11 SP2: Novell Archive and Version Services User Guide

IfyouareusingaGNOMEdesktop,loginagainforsuccessfulinstallationoftheutility.TheRestore

ArchivedVersionsisavailablewhenyouright‐clickafileordirectoryonanetworkdrivethatisa

mappedtoaNSSvolume.

4.1.1 Uninstalling NSS File Version Utility

RemovethefollowingrpmstouninstalltheNSSFileVersionUtility:



novell-fileversionutility-linux-kdeplugin-1.0.0-x.i586.rpm

or

novell-fileversionutility-linux-nautilus-plugin-1.0.0-x.i586.rpm



novell-fileversionutility-linux-1.0.0-x.i586.rpm

IfyouareusingaGNOMEdesktop,loginagaintoyourworkstationtocompletelyuninstalltheNSS

FileVersionutility.

4.2 Installing NSS File Version Utility on Windows

1 LaunchaWebbrowser,thenopentheWelcomepagewiththefollowingURL:

https://svrname/

ReplacesvrnamewiththeactualDNSnameorIPaddressoftheArchiveserver.

2 Intheleftnavigator,selectClientSoftware>ArchiveVersioning.

Dependingonyourrequirementinsta lltheArchiveVersioning32‐bitClientforWindows

(

NSSFileVersionUtility.exe

)orArchiveVersioning64‐bitClientforWindowsVista

(

NSSFileVersionUtility_x64.exe

3 DownloadandinstalltheexecutablefiletoyourWindowsworkstation.

NOTE:OnWindowsVista64‐bit,youneedtomanuallyregisterthe

VshellExtn.dll

.Onthe

elevatedcommandprompt,enter

regsvr32 VShellExtn.dll /s



Afterasuccessfulinstallation,theRestoreArchivedVersionsisavailablewhenyouright‐clickafile

ordirectoryonanetworkdrive(thatisamappedNSSvolume).

4.2.1 Uninstalling NSS File Version Utility

UninstalltheNSSFileVersionUtilityusingAddorRemovePrograms.

NOTE:ToperformcleanuninstallationonWindowsVista,youmustclosetheVersioningwindow,

thenperformuninstallation.

4.3 Log Files

 Section 4.3.1,“Linux,”onpage 19

 Section 4.3.2,“Windows,”onpage 19

Installing and Using the NSS File Version Utility 19

4.3.1 Linux

The

log.txt

fileislocatedin

/$home/.versioning

folder.

Bydefaultonlyfatalerrorsarelogged.Tologdebugorallmessagesconfigurethe

NovellVersioningClient.exe.config

filelocatedat

opt/novell/versioning-client/bin

folder

andeditthelevelvalueparameterstoDEBUGorALL.

or

4.3.2 Windows

The

log.txt

fileislocatedinthe

Program\Application

folder.Forexample,

c:\Program

Files\Novell\Versioning\log.txt

.

Bydefaultonlyfatalerrorsarelogged.Tologdebugorallmessagesconfigurethe

NovellVersioningClient.exe.config

fileandeditthelevelvalueparameterstoDEBUGorALL.

or

IntheWindowsVista32‐bitplatformthelogfileislocatedat

c:\users\<username>\AppData\Local\VirtualStore\Program Files\Novell\Versioning

.

IntheWindowsVista64‐bitplatformtocreatelogfile,youhavetoconfigurethe

c:\Program

Files\Novell\Versioning \NovellVersioningClient.exe.config

file.Toconfigurethe

NovellVersioningClient.exe.configfile,edittheparanameandvalueparameters:

<param name=“File” value=“c:\users\<username>\log.txt”

wherethevalueofelementparamnamemustbeFileandtheelementvaluecontainsthedesired

locationforthelogfile.

4.4 Viewing the Versioning Policy

Theadministratorsetstheversioningcriteriatofilterthetypeoffilestobeversioned,durationand

thenumberofversionsretainedforagivenvolume.Selectthevolumetoviewthe policysetforall

thefilesthatareeligiblefor versioning.

Youcanviewtheversioningpolicyofthe

jobsthatareintherunningstate.

1 Right‐clickinthesystemtray,thenclickViewVersioningPolicy.

2 Selectthevolume.

Ifyouencounteranyerrors,checkthe

log.txt

file.Configurethe

Versioning.Policy.exe.config

filetologtheerrormessagesrelatedtoversioningpolicyin

the

log.txt

file.

3 Refertothetablebelowfordetailsonthefields.

20 OES 11 SP2: Novell Archive and Version Services User Guide

Option Description

Server Name The OES 11 SP2server where the data to be versioned is located.

Volume Name The OES 11 SP2 NSS volume where the data to be versioned is located.

Job Status The current operational state of the job.

Scheduled: The job is scheduled to save file versions; currently it is not active.

Running: The job is saving file versions to the archive database.

Stopped: The archived data is available to you, but the job is disabled and no

new versions are captured.

Cleanup: The Clean Up Users job is in progress. The job removes obsolete

user information.

Page is loading ...

Novell Open Enterprise Server 11 SP3 User guide

Related papers

Other documents