HP StorageWorks RISS Components Reference Guide
HP Reference Information Storage System
Administrator Guide
Version 1.6
T3559-90809
Part number: T3559-90809
econd edition: September 2007
S
Legal and notice information
© Copyright 2004-2007 Hewlett-Packard Development Company, L.P.
Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose. H ewlett-Packard shall not be liable for errors contained herein or
for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied,
reproduced, or translated into another language without the prior written consent of Hewlett-Packard. The information contained in
this document is subject to change without notice. The only warranties for HP products and services are set forth in the express
warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional
warranty. HP shall not be liable for technical o r editorial errors or omissions contained herein.
Microsoft® and Windows® are US registered trademarks of Microsoft Corporation. Outlook™ is a trademark of Microsoft
Corporation.
Hewlett-Packard Company shall not be liable for technical o r editorial errors or omissions contained herein. The information is
provided “as is” without warranty of any kind and is subject to change without notice. The warranties for Hewlett-Packard Company
products are set forth in the express limited warranty statements for such products. Nothing herein should be construed as
constituting an additional warranty.
Contents
Aboutthisguide ......................... 13
Intendedaudience..................................... 13
Relateddocumentation................................... 13
Documentconventionsandsymbols ............................. 14
HPtechnicalsupport.................................... 14
Subscriptionservice .................................... 15
Otherwebsites...................................... 15
Providing feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1 RISS overview . . . . . ..................... 17
RISS........................................... 17
RIM ........................................... 17
RISSpoweron/off..................................... 18
Poweroff....................................... 18
Poweron....................................... 18
HowtorestartRISSafterapowerfailure ......................... 18
2IntroductiontoPlatformControlCenter(PCC) ............ 21
AccessingPCC ...................................... 21
Userinterfacecomponents ................................. 21
Userinterfaceorientationtips ................................ 22
Viewsforcommontasks .................................. 23
Updating views b efore printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Leftmenuviews ...................................... 23
Monitoringandreporting.................................. 24
Statusesandstates..................................... 25
Smartcelllifecyclestates................................ 25
3 System Status . . . . . ..................... 27
Overview......................................... 27
ApplicationEvents................................... 27
ApplicationEventsfeatures ............................. 28
AppliancePerformance................................. 28
AccountManagerService................................ 28
FailedIndexedDocumentsandCatchAll ......................... 28
ApplianceStatistics .................................. 29
ApplianceStatisticsfeatures............................. 30
RISSVersion ..................................... 30
SMTPFlowControl................................... 30
StorageStatus....................................... 30
SystemStatus ....................................... 31
ApplianceControl..................................... 33
ApplianceControlviewfeatures............................. 33
Starting,stopping,andrestartingserversonthesystem ................... 33
PerformanceGraph .................................... 34
Example:ApplianceStoregraph............................. 34
Example:SystemMonitoringgraph............................ 35
Creatingperformancegraphs.............................. 35
Administrator Guide
3
4Configuration.......................... 37
RISS Configuration..................................... 37
Domain Configuration ................................. 37
Appliance Configuration ................................ 37
FirewallSettings...................................... 38
SSL Configuration ..................................... 38
Available certificatesigningrequests........................... 39
Creating a certificatesigningrequest........................... 39
Deleting a certificatesigningrequest ........................... 39
Installing and generating a certificateonthePCCportal................... 40
Installing and generating a certificateontheHTTPportals.................. 40
SoftwareVersion ..................................... 41
DisplayingSoftwareVersion............................... 41
5 Account Synchronization..................... 43
AccountSynchronizationoverview .............................. 43
CreatingandrunningDASjobs ............................... 43
CreatingLDAPserverconnections ............................ 43
Creatingjobs..................................... 44
Mappingadvancedoptions............................. 45
AssigningHTTPportals................................. 46
Starting,scheduling,andstoppingDASjobs........................ 47
Editingordeletingjobs................................... 47
ManagingavailableHTTPportals .............................. 47
EditingordeletingavailableLDAPconnections......................... 47
ViewingDAShistorylogs.................................. 48
6 Account Manager (AM) ..................... 49
AccountManageroverview................................. 49
AccountManagerviewfeatures............................. 51
Managinguseraccounts .................................. 51
Addinganewuser .................................. 51
Editinguserinformation................................. 52
Useraccountinformation................................ 53
Managinggroups..................................... 54
Managingrepositories................................... 54
Addingrepositories .................................. 54
Editingrepositoryinformation.............................. 55
Repositoryinformation ................................. 56
7Otherusermanagementfeatures ................. 57
ManualAccountLoader .................................. 57
Exportinguseraccountinformation............................ 57
Loadinguseraccountinformation ............................ 57
ErrorRecovery ...................................... 58
ErrorRecoveryfeatures................................. 58
Repairingsynchronizationerrors............................. 59
8 Data manag ement . . . . .................... 61
Replication........................................ 61
DatabaseReplication.................................. 61
(Re-)Initializingdb2replication............................ 62
ReplicationStatus ................................... 63
DataReplicationFlow ................................. 63
Smartcellcloning..................................... 64
Cloningviewfeatures ................................. 65
Cloningsmartcells(copyingdata)............................ 65
4
Reprocessing ....................................... 66
Reschedulingallreprocessingschedules.......................... 66
Editingreprocessingschedules.............................. 66
Changingthereprocessingstatus ............................ 67
UsingtheReprocessingUtility .............................. 67
Viewingreprocessinghistorylogs ............................ 68
Repository-levelretention .................................. 68
Searchingforandeditingarepositoryretentionperiod ................... 68
Editingdomainretentionperiods............................. 69
Changingtheretentionprocessingstatus ......................... 70
Viewingretentionhistorylogs .............................. 70
Databaseanddatabackup................................. 70
Backup filelocations.................................. 71
Restoring DB2 and master configuration filebackups .................... 71
Restoring the master configu ration files .......................... 72
9Reporting ........................... 73
EventViewer ....................................... 73
SearchingtheEventViewer............................... 73
OtherEventViewerfeatures............................... 74
SNMPManagement.................................... 74
DownloadingtheRISSMIB ............................... 74
SettingtheSNMPserver ................................ 74
SelectingSNMPtraps ................................. 75
ReceivingSNMPeventsbyemail............................. 76
SettingSNMPCommunity................................ 76
EmailReporter ...................................... 76
Detailedemailreports ................................. 76
Creatingandschedulingemailreports .......................... 77
LogfileSender....................................... 77
10 External access . . . ..................... 79
RIMManagement ..................................... 79
MiningOverview ................................... 79
SystemServices .................................. 80
ConfiguredTasks ................................. 80
JournalMining .................................. 81
SelectiveArchiving................................. 82
Synchronize D eleted Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
TombstoneMaintenance .............................. 83
11PSTImporter.......................... 85
PSTImporteroverview ................................... 85
PSTImporterprocess.................................. 85
Archive Request file .................................. 85
InstallingPSTImporter ................................... 86
Installationrequirements ................................ 86
Clienthardwarerequirements ............................ 86
Clientsoftwarerequirements............................. 86
RISSsoftwarerequirements ............................. 86
Networkrequirementsonclientmachine ....................... 86
Installationprocedure ................................. 86
UsingPSTImporter..................................... 87
ArchiveRequestLoader................................. 87
Creating or revising an Archive Request file ...................... 87
Validating fileusingtheArchiveRequestLoaderuserinterface .............. 89
Validating filefromcommandline .......................... 90
PSTImportMonitor................................... 90
Administrator Guide
5
UsingPSTImportMonitor.............................. 90
Displaying reports and log files ........................... 92
Archive Request file specifications .............................. 93
Settingsdescription .................................. 93
Sample file...................................... 95
12AuditLog........................... 97
EnablingtheAuditLogfeature................................ 97
GrantinguseraccesstotheAuditLogrepository........................ 97
Monitoringstatus ..................................... 98
Setting Audit Log repository retention periods . . . . . . . . . . . . . . . . . . . . . . . . . 98
13Backupsystemadministration .................. 99
RISSbackupstrategy.................................... 99
TivoliStorageManager................................... 99
GainingaccesstotheRISSbackupserver........................... 99
Smartcelldatabackups .................................. 100
SeparateGroupVolumes.................................. 100
TSMbackupterms..................................... 100
How RISS configuresTSM.................................. 101
Addingandlabelingnewmedia(Webinterface)........................ 102
Addingandlabelingnewmedia(commandline)........................ 104
Restoringasmartcell.................................... 105
Preparingthebackupserverfordisasterrecovery........................ 107
Thingstobackup ................................... 107
TSMDisasterRecoveryManager............................. 107
Example:Preparingthebackupserverforadisaster .................... 107
Recoveringthebackupserver ................................ 109
Example:Recoveringtheserverfromadisaster ...................... 109
14 ConfiguringOutlook ...................... 113
ConfiguringyoursystemforExchangeandOutlook....................... 113
Configuringuseraccountsonservers........................... 113
InstallingtheOutlookplug-in .............................. 114
Registrysettings.................................. 114
Manuallycreatingotherregistrysettings ....................... 117
Installing and configuringtheOutlookplug-inforusers ................. 117
Configuringjournalmining ............................... 118
Settingregistrykeyforjournaling .......................... 118
Enablingjournalingonmailboxstores ........................ 118
Configuringmailboxmining............................... 119
ConfiguringExchangeforemailstubsupport ..................... 119
Publishingforms.................................. 119
SettingupInformationStores .............................. 120
AddingmailboxesusingMailAttender ........................ 120
SetupAuto-Search................................. 122
Scheduler ...................................... 122
StartingScheduler................................. 122
Schedulinganevent ................................ 123
Enablingloadbalancingmessagebymessage..................... 123
Enablingascheduledevent............................. 124
Editingselectivearchivingevents........................... 124
Editingjournalminingevents ............................ 126
Editingtombstonemaintenanceevents ........................ 128
EditingSynchronizeDeletedItemsevents ....................... 128
Copyingascheduledevent ............................. 129
Deletingascheduledevent ............................. 130
ModifyingrulesinMailAttender............................. 130
6
ModifyingaruleusingMailAttender......................... 131
Startingselectivearchiving ............................... 133
StatusView...................................... 133
MonitoringView.................................. 133
Deletingend-userdeleteditemsontheRISS ........................ 135
Location of deleted items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Configuringdeletionretention............................ 135
SchedulingdeletionfromRISS............................ 137
End-userdeletesecurity............................... 139
OWARISS ...................................... 140
Systemrequirements ................................ 140
Multiplemailstores ................................ 140
MultipleRISSsystems................................ 141
TemporarystorageinDraftsfolder .......................... 141
Configuring the asp.config file............................ 142
ChangingtheASPtime-out ............................. 143
Browserfunctionality................................ 143
Multi-usersupport ................................. 143
Index .............................. 145
Administrator Guide
7
Figures
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22 ..Resettingprocess................................ 92
23
24
25
26
27
28
29
30 ..Provisionerstatus................................ 106
31
32
33
34
35
36
37
38
39
40
41
42
43
..PCCuserinterface ............................... 22
..PerformanceGraph:StoreRate.......................... 35
..PerformanceGraph:FreeMemory ........................ 35
..Domain Configuration.............................. 37
..NewLDAPconnection ............................. 44
..CreateDASjob ................................ 44
..Mapping in
..Advancedoptions ............................... 45
..Assignajobtoaportal............................. 46
..AccountManagerview ............................. 50
..Editing u
..Editingrepositoryinformation .......................... 55
..Editingreprocessingschedules.......................... 66
..Changethereprocessingstatus.......................... 67
..Reproce
..UserRepositorysearchresults .......................... 69
..Editrepositoryretentionperiod.......................... 69
..Editdomainretentionperiod........................... 70
..ArchiveRequestLoaderwindow ......................... 87
..Creating a new file............................... 88
..PSTImportMonitor............................... 91
..AuditLogenabled ............................... 98
..Accessingdomainrepository........................... 98
..AccessingAuditLogrepository.......................... 98
..Policydomainstructure ............................. 101
..Libraryproperties................................ 103
..Labelandcheckinvolumes ........................... 103
..Serverprocesslist ............................... 104
ingmailboxesusingMailAttender ...................... 120
..Add
..Settingsviewbutton............................... 121
..MailboxProperties ............................... 121
..NewAuto-Search................................ 122
hedulinganevent .............................. 123
..Sc
..Typesofevents................................. 123
..Enablingascheduledevent ........................... 124
..SelectiveArchivingEventwindow......................... 126
..JournalMiningEventwindow .......................... 127
..TombstoneMaintenanceEventwindow ...................... 128
..Synchronize D eleted Items event window . . . . . . . . . . . . . . . . . . . . . . 129
..Copyingascheduledevent ........................... 129
..Deletingascheduledevent ........................... 130
formation.............................. 45
seraccountinformation ......................... 52
ssingutility............................... 67
8
44
..Rules..................................... 131
45
..EditLocalRulewindow ............................. 131
46
..AddInformationStoreswindow.......................... 132
47
..Possibleconditions ............................... 133
48
..MonitoringViewwindow ............................ 134
49
..Mailboxstore ................................. 136
50
..Deletionsettings ................................ 137
Administrator Guide
9
Tables
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
..Documentconventions.............................. 14
..RIMapplicationsforusers............................ 17
..RISS and RIM applications for administrators . . . . . . . . . . . . . . . . . . . . 18
..Views for common system administration tasks . . . . . . . . . . . . . . . . . . . 23
..Viewsaccessiblefromleftmenu ......................... 23
..Smartcelllifecyclestates ............................ 25
..Link to Ove
..ApplicationEventsfeatures............................ 28
..ApplianceStatisticsfeatures ........................... 30
..StorageStatusviewfeatures ........................... 31
..LinktoStorageStatusview............................ 31
..SystemStatusviewfeatures ........................... 32
..LinktoSystemStatusview ............................ 33
..LinktoApplianceControlview.......................... 33
..Applian
..PerformanceGraphfeatures ........................... 34
..LinktoPerformanceGraphview ......................... 34
..Link to RISS Configurationview.......................... 37
..Firewallports ................................. 38
..LinktoFirewallSettingsview........................... 38
..Link to SSL Configurationview .......................... 38
..Available certificatesigningrequests(CSRs)intheRISSsystem ............ 39
..Softw
..LinktoSoftwareVersionview........................... 41
..LinktoAccountSynchronizationview ....................... 43
..LinktoAccountManagerview.......................... 49
..AccountManagerviewfeatures ......................... 51
..Useraccountinformation ............................ 53
..Repositoryinformation ............................. 56
..LinkstotheManualAccountLoaderview ..................... 57
..
LinkstoErrorRecoveryview ........................... 58
..ErrorRecoveryfeatures ............................. 58
..LinktoReplicationview ............................. 61
..DatabaseReplicationfeatures .......................... 62
..ReplicationServiceGeneralStatus ........................ 63
..DataReplicationFlow.............................. 63
..LinktoCloningview .............................. 64
..Cloningviewfeatures.............................. 65
..LinktoReprocessingview ............................ 66
..LinktoRetentionview.............................. 68
..DBBackupHistory ............................... 71
..LinktoDBandDataBackupview......................... 71
..EventViewerfeatures.............................. 73
rview................................ 27
ceControlviewfeatures ......................... 33
areVersionviewfeatures.......................... 41
10
44
..LinkstoEventViewer .............................. 73
45
..LinkstoSNMPManagementview......................... 74
46
..LinkstoEmailReporterview ........................... 76
47
..DetailedEmailReports ............................. 77
48
..LinkstoLogFileSenderview ........................... 78
49
..LinktoRIMManagementview .......................... 79
50
..Mining Over
51
..LinktoMiningOverview............................. 80
52
..SystemServicesfeatures............................. 80
53
..ConfiguredTasksfeatures ............................ 81
54
..JournalMiningfeatures ............................. 81
55
..Tagsin<Header> ............................... 94
56
..Tagsin<FileSpec>............................... 95
57
..Useraccountsoncustomerservers ........................ 114
58
..Append to a CSV file.............................. 138
59
..CSVColumns ................................. 139
viewviewfeatures.......................... 80
60 ..Summaryreport ................................ 139
61
..SetAdmin.exe ................................. 139
62
..Mail Att
enderruletodeletetemporaryitemsinDraftsfolder ............. 142
Administrator Guide
11
12
About t his guide
This guide provides information about administering the HP Reference Information Storage System
(RISS). It also contains information about administering HP RIM for Exchange. For information on
administering HP RIM for Domino, also see the HP RIM for Domino Administration Guide included on the
documentation CD in the RIM for Domino product.
Intended aud
This guide is intended for:
• HP Reference Information Storage System (RISS) administrators
• HP RIM for Ex
RIM for Domi
included on the documentation CD in the RIM for Domino product.
ience
change administrators
no administrators will also want to use the HP RIM for Domino Administration Guide
Related documentation
HP provides the following RISS and RIM documentation.
For administrators and installers:
• HP Reference Information Storage System Administrator Guide (located on the RISS product
documentation CD) — also includes RIM for Exchange administration information
• HP Reference Information Storage System Installation Guide (available to HP personnel installing
RISS or RIM for Exchange)
• Online help for the Platform Control Center (PCC), also included in the administrator guide
• HP RIM for Domino Administrator Guide (located on the documentation CD included in the RIM
for Domino product)
• HP RIM for Domino Installation Guide (available to HP personnel installing RIM for Dom ino )
For users:
• HP Reference Information Storage System User Guide (located on the documentation CD) — also
includes RIM for Exchange administration information
• Online help for the RISS Web Interface, also included in the above user guide
• HP RIM for Domino User Guide (located on the documentation CD included in the RIM for
Domino product)
For developers:
This release includes the following guides for developers, which are available at the HP Developer
and Solution Partner Program web site at h
• HP Reference Information Storage System Query Web Service API Developer Guide
• HP Reference Information Storage System I LM Object Storage API Developer Guide
ttp://www.hp.com/go/ilmdspp/:
Administrator Guide
13
Document conven
Table 1 Document conventions
tions and symbols
Convention
Medium blue text: Related
documentation
Medium blue, underlined text
ttp://www.hp.com)
(h
Bold font
Italic font
Monospace font
Monospace, italic font
Monospace, bold font
Element
Cross-reference links and email addresses
Web site addresses
• Key names
• Text typed into a GUI element, such as into a box
• GUI elements that are clicked or selected, such as menu and
list items, buttons, and check boxes
Text emphasis
• File and directory names
• System output
• Code
• Text typed at the command line
• Code variables
• Command-lin e variables
Emphasis of file and directory names, system output, code, and
texttypedatthecommandline
WARNING!
Indicates that failure to follow directions could result in bodily harm or death.
CAUTION:
Indicates that failure to follow directions could result in damage to equipment or data.
IMPORTANT:
Provides clarifying information or specific instructions.
NOTE:
Provides additional information.
TIP:
Provides helpful hints and shortcuts.
HP technical support
Telephone numbers for worldwide technical support are listed on the HP support web
ttp://www.hp.com/support/.
site:h
Collect the following information before calling:
14
About this guide
• Technical support registration number (if applicable)
• Product serial numbers
• Product model names and numbers
• Applicable error messages
• Operating system type and revision level
• Detailed, specificquestions
For continuous quality improvement, calls may be recorded or monitored.
Subscription
HP strongly recommends that customers register online using the Subscriber’s choice web site:
h
ttp://www.hp.com/go/e-updates.
Subscribing to this ser vice provides you with email updates on the latest product enhancements, newest
driver versions, and firmware documentation updates as well as instant access to numerous other product
resources.
After subscribing, locate your products by selecting Business support and then Storage under Product
Category.
service
Other web sites
For other product information, see the following HP web s ites:
•h
ttp://www.hp.com
•http://www.hp.com/go/storage
•http://www.hp.com/service_locator
•http://www.hp.com/support/manuals
Providing
For feedba
feedback
ck on manuals or online help, send comments to storagedocs.feedback@hp.com.
Administrator Guide
15
16
About this guide
1RISSoverview
This chapter describes key concepts involving the HP Reference Information Storage System (RISS) and
Reference Information Manager (RIM).
It contains the following topics:
•RISS,page17
•RIM, page 17
RISS
RISS is a fault-tolerant, secure system of hardware and software that archives files and email messages for
your organization, and lets you search for archived documents. RISS provides the following main functions:
• Automatic, active data archiving (email and specific document types) that helps your organization
meet regula
• Interactive data querying to search for and retrieve archived data according to various criteria.
RIM
Reference Information Manager (RIM) is management software for RISS. To interact with the system,
users can use the following applications:
tory requirements.
Table 2 RIM applications for users
Application Tasks
RIM for Exchange (customer
option)
RIM for Domino (customer
option)
RISS and RIM provide the following troubleshooting and administrative tools:
Search for emails using Microsoft Outlook with a Microsoft
Exchange mail server. View and work with archived emails.
Search for emails using IBM Lotus Notes with an IBM Domino
mail server. View and work with archived emails.
Administrator Guide
17
Table 3 RISS and RIM applications for administrators
Application Tasks
Platform Control Center (PCC) Monitor and troubleshoot system status and performance, and
PST Importer
Audit Log
RIM for Exchange: Mai l
Attender
RIM for Domino Create selective archiving rules for Domino. See the HP RIM for
Web UI The Web UI allows administrators and users to use their web
RISS power on/off
Below are instructions for turning the RISS on and off, and specific instructions to follow in case of
apowerfailure.
manage user accounts. See "Introduction to Platform Control
Center (PCC) "onpage21.
Batch process multiple PST files. See "PST Importer"onpage85.
Enable the Audit Log for regulatory compliance. See "Audit
log"onpage97.
Create selective archiving rules for Microsoft Exchange and
Outlook. See "Configuring your system for Exchange and
Outlook"onpage113.
Domino Administrator Guide included with the RIM for Domino
product on the documentation CD.
browser to search for documents archived on the system, and
save and reuse your search-query definitions and results. See
the RISS User Guide.
Power off
To turn off the RISS, from PCC enter:
# /opt/bin/stop
# /opt/bin/shutdown
Wait a few minutes until the PCC console shutdown is complete before removing power from the RISS
systems.
Power on
To power on the RISS:
1. Make sure the RISS switch(es) are powered up. Once power is restored, the switch(es) should
automatically come up.
2. Power on the kickstart server. Wait five minutes.
3. Power on everything else. Order is insignificant, unless there has been a power failure (see
below).
How to restart RISS after a power failure
After a power failure has occurred, a specific power on sequence is required:
1. Power off all systems.
2. Power on the kickstart server.
3. When the kickstart machine is running, log on and issue the commands:
4. Wait for the start to complete successfully.
5. Power on db2, routers,and loadbalancers.
/etc/init.d/postgresql stop
/etc/init.d/postgresql start
18 RISS overview
6. Power on smart cells.
7. Power on metaservers.
8. Power on remaining servers.
9. Wait for all machines to start, then log in to the PCC console and issue the command:
/opt/bin/restart
10. Once RISS has restarted, verify (with the PCC web interface) that the RISS is running and monitoring
is reporting system availabilities as expected.
NOTE:
In the event both routers go down, the system should be restarted with /opt/bin/restart once
the routers are back up.
Administrator Guide
19
20 RISS overview
2 In troduction to Plat form Control
Center (PCC)
This chapter introduces the Platform Control Center (PCC) administration tool for monitoring and
troubleshooting the RISS and user accounts.
It includes the following topics:
•AccessingPCC,page21
• User interface components,page21
•Userinterfaceorientationtips, page 22
•
Views for common tasks, page 23
•
Updating views before printing,page23
•
Left menu views,page23
• Monitoring and reporting ,page24
•
Statuses and states, page 25
Accessing
To access the PCC, open a web browser, enter the PCC server’s IP address, then log in using the
administrative user name and password.
Administ
for more i
You can also log in as the super user, if directed to do so by HP technical support. The RISS super user
login name and password are set up during system installation.
PCC
rator privileges are set up in the Account Manager. See "User account information"onpage53
nformation.
User interface components
PCC is an HTML-based application containing a menu on the left side of the page (referred to as the left
menu). Use the left menu to access most views in the PCC.
Administrator Guide
21
Figure 1 PCC user interface
User interface orientation tips
To orient yourself, pay at tention to the different ways a view is characterized.
• Link text: A navigation link leading to a view is a general description of the view.
Most links to a view are from the left menu.
• HTML nam
e: Each PCC view has a descriptive H TML name, which is displayed in the browser.
22
Introduction to Platform Control Center (PCC)
Views for common tasks
Table 4 Views for
common system administration tasks
Task
Check overall system health and performance
Check smar t cell health and performance
Monitor system status and RAID support
Start, stop, and restart system servers "Appliance Control"onpage33
Check the RISS configuration "RISS configuration"onpage37
Display firewalled ports enabled in the system
View software versions used by system hosts "Software Version"onpage41
Synchronize user accounts "Account Synchronization" on page 43
Manage user accounts "Account Manager (AM)" on page 49
Monitor,start,andstopreplicationfordomains
Clone smart cells (copy data) "Smartcell Cloning"onpage64
Check database backup h istory "Database and data backup" on page 70
Monitor system alerts
Activate SNMP traps and send email notifications
Configure periodic email reports of system status and
performance
Link to email mining services
View
"Overview" on page 27
"Appliance Statistics"onpage29
"System Status" on page 31
"Firewall Settings"onpage38
"Replication"onpage61
"Event Viewer" on page 73
"SNMP Management" on page 74
"Email Reporter" on page 76
"RIM Management"onpage79
Updating views before printing
PCC views displayed in the web browser are not automatically updated. To manually update the view,
click Refresh (or Reload)inthebrowser.
If the browser caches web pages, the cached view displayed when you click the browser’s Back button
can be out of date. Refresh it manually.
Some browsers print from a n updated version of the web page without refreshing the browser display. If
the displayed view is out of date, the printout can appear different from the displayed view. To ensure
you print what is displayed, refresh the browser manually before printing.
Left menu views
The left menu provides quick access to PCC views. The left menu varies depending on the way the system
is configured. For example, systems not using replication do not have the Replication menu item available.
Table 5 Views accessible from left menu
Left menu item
"Overview" on page 27
"Storage Status" on page 30
"System Status" on page 31
Description
View summary of system health, storage status, smart cell
performance by domain, and system alerts and warnings.
View summary, by domain, of document storage rates and
used/free disk space.
View summary, by server, of system capacity and performance.
Administrator Guide
23
Left menu item
Description
"Appliance Cont
"Performance Graph"onpage34
General Configuration views
"RISS configura
"Firewall Settings" on page 38
"SSL Configuration" on page 38 Generate third party public certificate requests for the PCC and
"Software Ver
User Manage ment views
"Account Synchronization" on page 43
"Account Err
"Account Manager (AM)" on page 49
"Manual Account Loader" on page 57
RIM Management views
"RIM Management"onpage79
rol"onpage33
tion"onpage37
sion" on page 41
or Recovery"onpage58
Start, stop, or r
Graph system storage and indexing rates and system
performance.
Display hardwa
system.
Display each firewalledportthatisenabledinthesystem.
HTTP portals.
View software
Configure dynamic account synchronization (DAS) to
automatically create and update RISS users with information
obtained from LDAP servers.
Repair account synchronization errors.
Provision, update, and manage RISS user accounts.
Create and update RISS users if the server is not using LDAP.
Access the email miner using VNC.
estart one or more servers on the system.
re and configuration information about the RISS
versions used by system hosts.
"Mining Overview"onpage79
Data Management views
"Replication"onpage61
"Smartcell Cloning" on page 64 Clone smart cells (copy data) to give them a new, viable mirror
"Reprocessing " on page 66
"Repository level retention"onpage68
"Database and data b ackup"onpage70
Reporting views
"Event Viewer"onpage73
"SNMP Management" on page 74
"Email R
"LogFile Sender" on page 77
eporter"onpage76
View status information about the email mining system for each
domain.
Monitorandstartorstopreplicationfordomains.
cell.
Schedule and enable reprocessing based on new routing rules.
Configure retention periods for doma ins and repositories.
View status information about database and configuration file
backup, including results of the last two backups.
View events with a critical or recovery status that have occurred in
a system service or application.
Set SNMP traps for system monitoring and send email
notifications.
Configure system monitoring reports to be sent to email recipients.
Send output and error log file reports, by machine type, to email
recipients.
Monitoring and reporting
PCC mon
• system health
24
itors the system and reports on its health and activity. PCC provides reports on:
Introduction to Platform Control Center (PCC)
• system performance
• smart cell states
Hosts in the system (and their services) are organized into groups of the same type, called host groups.
For example, to view all smart cell hosts, display the status of the host group SMARTCELL Servers in
the System Status view.
As long as ser vices appear to be functioning correctly (OK), the host is assumed to be healthy (UP). If
monitoring indicates a host is not functioning correctly (DOWN), none of its services are available
(they can have any status except OK). If a service has CRITICAL status, but the host is UP, the service
probably needs to be restarted.
Statuses and states
Several PCC v
services. Status values measure relative health, and can be associated with a status condition conveying
ameasureofconfidence in the reported value.
For example, the health of a smart cell in the SUSPENDED life cycle state can be reported with the
HEALTHY hos
they should be.
PCC views often use status and state loosely and interchangeably when referring to hosts and services.
State is always used when referring to smart cell life cycle states, but status and state are both used when
reporting s
refer to st
iews show current life cycle states of smart cells or status values of particular hosts or
t status value, which means the RISS op erating system and applications are functioning as
mart cell health, since smar t cells are regarded as a host like any other. PCC views also
atus conditions as states or state types.
Smart cell life cycle states
Table 6 Smart cell life cycle states
Life cycle state Definition
ASSIGNED
CLOSED
COMPLETE_PROCESSING
BACKING_UP
SYNC_WAIT
RESTORE
The cell is assigned to a doma in.
The cell is available for document storage, search, and
retrieval. If backup is enabled, cell data ca n be backed
up.
The cell is full.
It is available for document search and retrieval, but not
storage. If backup is enabled, all cell data was backed
up before the cell entered this state.
dexing is being completed.
Data in
The cell is full. It is available for document search and
retrieval, but not storage. If backup is enabled, cell data
can be backed up.
The cell is available for document search and retrieval.
If backup is enabled, the cell is backing up all its
indexes and new data that has not yet been backed up.
The cell is available for document search and retrieval.
ll is a target for data restoration from another
The ce
cell.
smart
ll is not available for document storage, search,
The ce
trieval.
or re
Importance
normal
normal
mainten
maintenance
maintenance
maintenance
ance
Administrator Guide
25
Life cycle state Definition
DISCOVERY
RESET
SUSPENDED
The meta server a
cell’s start state (the state following DISCOVERY), based
on expected st
The cell is not
or retrieval.
The cell is being recycled. Stored documents and
corresponding management data, such as document
indexes, are destroyed during recycling.
The system administrator has determined that existing
cell data is no longer needed. The RESET state is only
set manually.
The cell is not affiliated with any domain, so it is not
available for document storage, search, or retrieval.
Either of the following is true:
• The cell or its mirror cell has one or more failed
processes.
• The mirror cell is DEAD.
NOTE:
Ifthecell’sstatusisOK,onlythemirrorcellhas
failed.
The cell is not available for storage. It is available for
document search and retrieval (unless a failed process
disabled the search engine). If backup is enabled,
the cell is backing up new data that h as not yet been
backed up.
nd smart cell are determining the
ates of the cell and its mirror smart cell.
available for document storage, search,
Importance
maintenance
(startup only)
maintenance
failure
DEAD
UNKNOWN
FREE
The cell has failed.
Itisnotavailablefordocumentstorage,search,or
retrieval. If backup is enabled, some or all c ell data
might not be backed up; if so, data will never be
backed up.
The state of the smart cell is unknown.
The cell is free. (Shown in blue.) It can become
ASSIGNED or become a target for data restoration.
The cell is not affiliated with any domain, so it is not
available for document storage, search, or retrieval.
failure
unknow
normal
n
26
Introduction to Platform Control Center (PCC)
3 System Status
This chapter discusses the information that is found in the system status views.
It includes the following topics:
•
Overview,page27
•
Storage Status, page 30
•
System Status,page31
•
Appliance Control, page 33
•
Performance Graph, page 34
Overview
The Overview provides a high-level look at system health. It displays the following information:
• Critical events that are occurring in a system ser vice or application.
• Informatio
• A summary of the number of RISS users, groups, and repositories in the system.
• A sum mary of the number of failed indexed documents and catch-all repository documents.
• Informati
• Information about the RISS software version.
• The number of SMTP connections in each domain.
n about document storage rates and capacity, for the system and for each domain.
on, by domain, about the status, health, and storage rate of each smart cell.
NOTE:
y, you would monitor the Overview every day.
Typicall
Table 7 Link to Overview
Origin
left menu
Application Events
The Application Events lo g at the top of the Overview displays the critical events that are currently
occurring in system services or applications.
Clicking More Details takes you to the Event Viewer, where you can search for events by type and time
period. See "Event Viewer" on page 73 for more information.
NOTE:
The Application Events log does not appear in the Overview if critical events are not currently occurring.
You can view previous system events by navigating to Reporting > Event Viewer.
Link
Overview
Administrator Guide
27
Application Ev
ents features
Table 8 Applica
Feature
Event
Machine
IP
Date
Level
tion Events features
Description
Information describing the event or error, including the service or
application name.
The name of the
The IP address of the server on which the event is occurring.
Thedateoftheevent.
The status of t
Appliance Performance
This area of t
Status"onpa
and total di
graph displays the system’s storage space ratio. The line graph on the right shows the messages per
second that the system stored in the past day, ending with the current time.
he overview provides information from the Storage Status view (see "Storage
ge 30) . The table on the left displays the number of documents stored, the amount of used
sk space, the document storage rate, and the document index rate for each domain. The bar
Account Manager Service
The Account Manager Service provides a brief summary of information from the PCC Account Manager
(see "Account Manager (AM)" on page 49). This area displays the number of individual RISS users and
groups, pending users and groups, and the number of RISS repositories. It also displays the number of
synchronization errors, if a ny, pertaining to RISS user accounts. Synchronization errors can be corrected
in the Error Recovery view (see "Account Error Recovery" on page 58).
server on which the event is occurring.
he event. In Application Events, the only status shown is
critical.
Failed I
ndexed Documents and CatchAll
This area of the Overview displays the following information:
• Failed Indexed: The number of documents that were not indexed. (For example, the system
might no
indexing repository, which can be viewed in the Account Manager (see "Account Manager
(AM)" on page 49. Click the Repository radiobuttoninAM,clicktheOther tab, then open the
failed indexing repository.
• CatchA
large to be indexed, messages that cannot be parsed, and messages that cannot be routed to a
registered RISS user. The number includes messages that went into catch-all from the SMTP portals
as well as those from the smart cell indexers.
Messages that cannot be parsed have malformed message structures (MIME) or unsupported
chara
Messages that cannot be routed do not correspond to any system routing rule. They are not
recognized as destined for a registered RISS user. Mailing-list messages cannot be routed if the
recipient’s name is not included in the message as a destination.
The c
(AM)"onpage49byclickingtheRepository radio button in AM, clicking the Other tab, then
opening the catch-all repository.
The failed indexing and catch-all repositories are automatically created when the system is started.
t have been able to index the particular file type.) These documents are in the failed
ll: The number of messages in the system’s catch-all repository, including m essages too
cter sets.
atch-all repository can be viewed in the Account Manager (see "Account Manager
28 System Status
NOTE:
If the number of documents shown is –1, the values cannot be read.
Appliance Statistics
The Appliance Statistics area provides status, health, and storage information about the RISS smart cells.
You can click a tab to view information about smart cells in all domains or smart cells in a particular
domain. The Appliance Statistics area also shows the IP addresses of free smart cells in the system.
Each smart cell’s life cycle state is color-coded.
•
•
•
•
•
•
•
See "Smart cell life cycle states" on page 25 for more information.
The icon at the beginning of the table row displays the health of the RISS operating system and
applications on the smart cell:
•
•
•
•
TIP:
If you move your mouse over the icon, you will see more information including node status, active thread
count, and the smart cells’s MAC address and IP address.
A green table row indicates a smart cell is ASSIGNED.
AlightgreentablerowindicatessmartcellisCLOSED.
A yellow-orange table row indicates a smart cell is in the COMPLETE_PROCESSING,
SYNC-WAIT, BACKING_UP, or RESTORE state.
A light yellow table row indicates a smart cell is in the DISCOVERY or RESET state.
A red table row indicates a smart cell is SUSPENDED.
A black table row indicates a smart cell is DEAD.
A gray table row indicates the state of a smart cell is UNKNOWN.
A green check icon indicates the smart cell ser ver is started and healthy.
A gray icon indicates that JBoss and the RISS applications have stopped.
A yellow icon indicates that JBoss is running, but one or more RISS applications are unhealthy.
A red X icon indicates that JBoss is running, but one or more RISS applications have failed.
Administrator Guide
29
Appliance Stat
istics features
Table 9 Applian
Feature
RISS Appliance The RISS appliance name, IP address, and document storage rate.
Domain
Group Name
Smartcell IP
Smartcell Rol
State
Stored Doc(s)
ce Statistics features
Description
The name of the domain.
A smart-cell group identifier generated automatically by RISS. This
number is unique across all systems.
The IP address of the smart cell.
e
A smart cell ca
Thecurrentlifecyclestateofthesmartcell. See"Smart cell life cycle
states"onpage25.
The number of documents stored since the smart cell was assigned.
nbePrimary,Secondary,Replica-1,orReplica-2.
NOTE:
When the system is actively storing documents, this count might
be different than the stored document count in "Appliance
performance
the smart ce
" on page 28. This number is the real-time count on
ll, while the Appliance Performance count (taken from
the local database) is only updated every minute.
Indexed Doc(s)
Store Rate
Index Rate
The number o
The number of documents being stored per second.
The number of documents being indexed per second.
f documents indexed since the smart cell was assigned.
Index D eletion Queue
Other Smart Cells
RISS Version
Near the bottom of the Overview, you will find information about the RISS system software (also known as
L2) and application software (also known as L3) .
SMTP Flow C
ontrol
At the bottom of the Overview, the SMTP Flow Control area shows the following information, by d omain:
• The maximum number of connections allowed
• The curren
• The number of archiver connections
Storage Status
The Storage Status view provides detailed document storage information for each domain.
The number o
IP addresses of smart cells in the FREE state.
t number of connections
f documents scheduled for deletion.
30 System Status
Loading...