REVISION NOTICE This is the first release of this manual for Softek Storage Manager, Version 2.3. A complete revision history is provided at the end of the manual. ABSTRACT The Softek Storage Manager Administration and User Guide v2.3 (ML-145029) provides an overview of Softek Storage Manager, including a description of the Softek Storage Manager Console, the features and functionalities of Softek Storage Manager. RESTRICTIONS ON USE The information contained in this manual is the licensed property of Fujitsu Software Technology Corporation. Use of the information contained herein is restricted pursuant to the terms and conditions of a license agreement. Fujitsu Softek and Softek Storage Manager are trademarks of Fujitsu Software Technology Corporation. Microsoft and Windows are registered trademarks and Windows NT is a trademark of Microsoft Corporation. All other trademarks and product names are the property of their respective owners. © 2003,4 Fujitsu Software Technology Corporation. © 2003,4,2007 Fujitsu Limited. All rights reserved. Printed in U.S.A. All specifications are subject to change without notice.

i

About This Guide

This manual describes the Softek Storage Manager’s features and functionality. Softek Storage Manager provides comprehensive Space Management functions, and melds them with state of the art ‘Policy Management’ and ‘Task Automation’.

Softek Storage Manager is Fujitsu Softek’s innovative solution to the challenges of storage management. This version of Softek Storage Manager is a robust storage management solution that allows you to view, filter and analyze storage information, as well as manage files and storage resources across operating platforms.

Audience The Softek Storage Manager Administration and User Guide (ML-145029) is for Storage Administrators and managers who use Softek Storage Manager to manage storage resources across the enterprise.

Related Publications The following publications contain related information:

Title Part Number

Softek Storage Manager Introductory Guide, Version 2.3 ML-145027

Softek Storage Manager Installation Guide, Version 2.3 ML-145028

Softek Storage Manager Reports User Guide, Version 2.3 ML-145030

Softek Storage Manager Mainframe Agent Messages Guide, Version 2.3

ML-145031

Softek Storage Manager Software and Installation Release Notes, Version 2.3

ML-145032

ii

Contents of this Manual

Section 1 The Softek Storage Manager Console

Chapter 1: Introduction An introduction to Storage Management, Softek Storage Manager and the Softek Storage Manager Console.

Chapter 2: Key Features The basic components that make up the Softek Storage Manager Console.

Section 2 Getting Started

Chapter 3: Getting Started Initial steps and procedures that need to be undertaken in order to set up and configure Softek Storage Manager.

Section 3 Managing Storage

Chapter 4: Managing Storage Resources

Describes how to manage storage resources across the network.

Chapter 5: Creating Action Sets

Describes how to use Softek Storage Manager’s automation feature.

Chapter 6: Viewing Action Logs

Describes how to view logs.

Chapter 7: Managing Groups

Describes how to create server groups and use them to manage storage more efficiently.

Chapter 8 Using Custom Commands

Describes how to define custom commands such as FTP, archive and backup.

Section 4 System Administration

Chapter 9: Configuring Administrators and Setting System Options

Describes how to configure system administrators and set system, reporting and database options.

Chapter 10: Configuring Archive Servers

Describes how to configure the servers used for archiving files.

Chapter 11: Space Agents, Data Collector and Database

Describes SpaceAgent and DataCollector Functions.

Chapter 12:Scanning Remote File Systems

Describes how to Softek Storage Manager allows a Windows Space Agent to remotely scan shared files systems.

Chapter 13: Configuring Space Agents

Describes the working of the Agent Configurator that allows configuration of the Space Agent to scan both local and remote Filesystems.

Chapter 14:I ntegration with Systemwalker ResourceCoordinator.

Describes the configuration to operate SSM with Systemwalker Resource Coordinator.

Chapter 15:Logs Describes the creation of logs for analysis

Glossary Describes some of the terms used in this manual.

iii

Notices The following notices are used throughout this manual.

NOTE

Gives readers additional significant information about the subject to increase their knowledge or to guide their actions.

TIP

Helps users apply the techniques and procedures described in the text to their specific needs.

!

CAUTION: Alerts readers to a situation that could damage the software or interrupt operations.

iv

CONTENTS

About This Guide .......................................................................................ii CONTENTS................................................................................................ v 1.................................................................................................................... 5 Introduction................................................................................................ 5

1.1 Overview ............................................................................................................... 7 1.1.1 Managing Storage Resources with Softek Storage Manager..................... 7

1.2 Collecting File Information ................................................................................. 8 1.3 Reports .................................................................................................................. 8 1.4 Action Sets Processing and Automation............................................................. 8 1.5 Remote File System Scanning ............................................................................. 9

2.................................................................................................................. 11 Key Features ............................................................................................. 11

2.1 Toolbars and Windows ...................................................................................... 13 2.2 Application Window........................................................................................... 14

2.2.1 Show Statement Toolbar.............................................................................. 14 2.2.2 Command Toolbar ....................................................................................... 15 2.2.3 Visualizer Window....................................................................................... 15 2.2.4 Detailer Window and Tabs.......................................................................... 17

2.3 Launch Bar ......................................................................................................... 18 2.3.1 Storage Function .......................................................................................... 19 2.3.2 Action Sets Function .................................................................................... 19 2.3.3 Logs Function............................................................................................... 19 2.3.4 Groups Function .......................................................................................... 19 2.3.5 Reports Function ......................................................................................... 19

3.................................................................................................................. 25 Getting Started ......................................................................................... 25

3.1 Getting Started Overview.................................................................................. 27 3.2 Launching the Storage Manager Console ........................................................ 27

3.2.1 Operating Modes ......................................................................................... 29 3.3 Configuring an Administrator .......................................................................... 29 3.4 Setting Up a Server Data Collection Schedule ................................................ 30 3.5 Configuring System Options ............................................................................. 31 3.6 Building a Show Statement................................................................................ 32 3.7 Setting a Default Threshold for Server File System Capacity ....................... 34 3.8 Setting File System Capacity Threshold for a Selected Server...................... 34 3.9 Customizing Column Displays.......................................................................... 35

3.9.1 Using the Column Configurator................................................................. 35 3.9.2 Showing and Hiding Columns in the Visualizer ....................................... 36 3.9.3 Setting Rules for Display Colors................................................................. 36

v

3.10 Rule Example.................................................................................................... 37 4.................................................................................................................. 43 Managing Storage Resources .................................................................. 43

4.1 Accessing the Storage Function......................................................................... 45 4.2 Viewing and Filtering Files................................................................................ 45

4.2.1 Visualizer for Files ....................................................................................... 46 4.2.2 Details Tab for Files ..................................................................................... 47 4.2.3 Server Tab for Files...................................................................................... 48

4.3 Managing Files with File Commands............................................................... 49 4.3.1 Deleting Files ................................................................................................ 49 4.3.2 Archiving Files.............................................................................................. 50 4.3.3 Archiving and Deleting Files....................................................................... 51 4.3.4 Invoking A Custom Command ................................................................... 51 4.3.5 Exporting a File View .................................................................................. 51 4.3.6 Updating File Data....................................................................................... 52 4.3.7 Setting a Default Layout ............................................................................. 53

4.4 Viewing and Filtering Folders........................................................................... 53 4.4.1 Visualizer for Folders .................................................................................. 54 4.4.2 Details Tab for Folders ................................................................................ 56 4.4.3 Server Tab for Folders................................................................................. 57

4.5 Managing Folders with Folder Commands ..................................................... 57 4.5.1 Archiving Folders......................................................................................... 58 4.5.2 Exporting a Folder View ............................................................................. 59 4.5.3 Updating File Data....................................................................................... 59 4.5.4 Updating Folder Capacity........................................................................... 60 4.5.5 Invoking a Custom Command ............................................................... 61 4.5.6 Setting a Default Layout ............................................................................. 61

4.6 Viewing and Filtering File Systems .................................................................. 61 4.6.1 Viewing File Systems in the Visualizer....................................................... 62 4.6.2 Viewing Details for a File System ............................................................... 64

4.7 Managing File Systems with File System Commands .................................... 64 4.7.1 Exporting a View.......................................................................................... 65 4.7.2 Updating File Data....................................................................................... 67 4.7.3 Updating Folder Capacity........................................................................... 67 4.7.4 Updating Capacity Data.............................................................................. 67 4.7.5 Invoke a Custom Command ....................................................................... 67 4.7.6 Setting a Default Layout ............................................................................. 67

4.8 Viewing and Setting Options for Servers ......................................................... 67 4.8.1 Viewing Servers in the Visualizer............................................................... 69 4.8.2 Viewing Server Details and Setting Options.............................................. 69

4.9 Scheduling Server Data Collection ................................................................... 70 4.10 Managing Servers with Server Commands ................................................... 71

4.10.1 Exporting a Server View ........................................................................... 71 4.10.2 Updating File Data..................................................................................... 72 4.10.3 Updating Folder Capacity......................................................................... 72 4.10.4 Updating Server Capacity Data................................................................ 72

vi

4.10.5 Viewing Pending Server Capacity Updates ............................................. 73 4.10.6 Setting a Default Layout ........................................................................... 73

4.11 Managing Database Utilization....................................................................... 73 4.11.1 Creating a Database Action Set ................................................................ 73 4.11.2 Viewing Database Information in the Visualizer .................................... 74 4.11.3 Viewing Database Details .......................................................................... 75

4.12 Scheduling Database Data Collection ............................................................ 76 4.13 Managing Databases with Database Commands .......................................... 77 4.14 Viewing Server Information and Selecting an Administrator ..................... 79 4.15Viewing Tablespace Information ..................................................................... 80 4.16 Viewing Tablespace Details ............................................................................. 81 4.17 Viewing DSI Information for Symfoware ...................................................... 81 4.18 Viewing Database Files .................................................................................... 82 4.19 Viewing Database Files Details ....................................................................... 85

5.................................................................................................................. 89 Creating Action Sets................................................................................. 89

5.1 Accessing the Action Sets Function................................................................... 91 5.2 Using Action Sets to Manage Servers............................................................... 91 5.3 Creating an Action Set ....................................................................................... 92 5.4 Setting up a Data Collection Schedule for an Action Set................................ 93 5.5 Assigning an Action Set...................................................................................... 95 5.6 Defining Actions for an Action Set.................................................................... 96

5.6.1 Perform these actions at capacity/database data update ......................... 98 5.6.2 Perform these actions at File data update:................................................ 99 5.6.3 Perform these actions at Folder capacity update: .................................. 100 5.6.4 Perform these actions at Database Configuration update:.................... 101

5.7 Defining Parameters for an Action Set Export File ...................................... 102 5.8 Previewing Action Results ............................................................................... 102 5.9 Overriding an Action Set for a Server............................................................ 106 5.10 Refresh the list of servers on Action Set – Assignments Tab...................... 107

6................................................................................................................ 109 Viewing Action Logs .............................................................................. 109

6.1 Viewing Logs......................................................................................................111 6.2 The Visualizer for Logs.....................................................................................111 6.3 Detailer for Logs............................................................................................... 112 6.4 Setting Log Data Retention Options............................................................... 113

7................................................................................................................ 115 Managing Groups .................................................................................. 115

7.1 Overview ........................................................................................................... 117 7.2 Defining a New Group ..................................................................................... 118 7.3 Configuring a Group........................................................................................ 118 7.4 Managing Group Members............................................................................. 119 7.5 Managing Group Subscribers......................................................................... 120 7.6 Assigning an Action Set to a Group................................................................ 121

7.6.1 Assigning Server Action Sets..................................................................... 121 7.6.2 Assigning Database Action Sets ................................................................ 122

vii

7.7 Overriding an Action Set for a Server Within a Group ............................... 122 8................................................................................................................ 125 Using Custom Commands..................................................................... 125

8.1 Remote versus Local Custom Commands ..................................................... 127 8.2 Defining a Custom Command......................................................................... 127 8.3 Defining an Optional Custom Command Context........................................ 129 8.4 Using a System-defined Custom Command .................................................. 130 8.5 Rules and Guidelines for Using Custom Commands.................................... 130

8.5.1 Expected Return Code .............................................................................. 131 8.6 Invoking a Custom Command Interactively ................................................. 131 8.7 Invoking a Custom Command through a Server Action Set........................ 132 8.8 Invoking a Custom Command Following an Action Set Export ................. 133 8.9 Custom Command Parameters....................................................................... 133 8.10 Usage Example: Custom Command............................................................. 135

8.10.1 Objective................................................................................................... 135 8.10.2 Windows Archive Using Info-Zip ........................................................... 136 8.10.3 UNIX Archive Using Info-Zip................................................................. 138 8.10.4 Cleaning Up Archive Folders.................................................................. 140

9................................................................................................................ 145 Configuring Administrators and Setting System Options ................. 145

9.1 Configuring an Administrator ........................................................................ 147 9.2 Adding or Editing an Administrator .............................................................. 148 9.3 Creating a Default Administrator................................................................... 148 9.4 Administering a Database ............................................................................... 149

9.4.1 Administrator Notifications about Action Set Executions ..................... 149 9.5 Configuring System Options ........................................................................... 149

9.5.1 Options: Storage Data Tab........................................................................ 149 9.5.2 Options: System Tab.................................................................................. 150 9.5.3 Options: Reporter Tab............................................................................... 153 9.5.4 Options: DB Server Tab ............................................................................ 154

10.............................................................................................................. 157 Configuring Archive Servers ................................................................ 157

10.1 Introduction.................................................................................................... 159 10.2 About NetWorker........................................................................................... 159

10.2.1 Configuring the Networker Server ........................................................ 160 10.2.2 Configuring NetWorker for UNIX Space Agents ................................. 160 10.2.3 Configuring Archive Servers with NetWorker ..................................... 160

10.3 Configuring Archive Servers with NetWorker............................................ 161 10.4 Configuring Veritas Netbackup .................................................................... 162 10.5 Configuring Archive Servers with Tivoli for Windows Servers ................ 162 10.6 Setting the System Variable Path to Find the DSMC Command .............. 164 10.7 Configuring Archive Servers with Tivoli on Unix Servers......................... 165

10.7.1 Example of a Unix dsm.sys file:.............................................................. 166 11 .............................................................................................................. 167 Space Agents, Data Collector and Database........................................ 167

viii

11.1 Space Agents Definition and Purpose........................................................... 169 11.2 Space Agent Functions ................................................................................... 169

11.2.1 Space Agent Data Collection ................................................................... 169 11.2.2 Data Collector........................................................................................... 169 11.2.3 Operations ................................................................................................ 169

11.3 Backing Up the Database............................................................................... 170 12.............................................................................................................. 171 Scanning Remote File Systems ............................................................. 171

12.1 Overview ......................................................................................................... 173 12.2 Scanning Remote File Systems with a UNIX Space Agent......................... 173 12.3 Scanning Remote File Systems with a Windows Space Agent .................. 174

12.3.1 Configuring Applications with Softek Process Monitor Configurator174 13.............................................................................................................. 177 Configuring Space Agents ..................................................................... 177

13.1 Introduction.................................................................................................... 179 13.2 Space Agent Configuration for Windows.................................................... 179

13.2.1 Overview................................................................................................... 179 13.2.2 FileSystem Tab ........................................................................................ 180 13.2.3 Folder Tab................................................................................................. 184 13.2.4 Configuring in Windows Cluster environment .................................... 190

13.3 Space Agent Configuration for UNIX .......................................................... 191 13.3.1 UNIX Agent Configuration File. ............................................................ 191 13.3.2 Configuring FileSystems for scanning:.................................................. 192 13.3.3 Configuring Folders for scanning: ......................................................... 193 13.3.4 Configuring Snapshot Folder to be excluded:....................................... 194 13.3.5 Configuring in Cluster Environment ..................................................... 194 13.3.6 Configuring Cluster FileSystems for scanning: .................................... 195 13.3.7 Configuring Cluster Folders for scanning: ........................................... 196

13.4 Agent Configuration Matrix ......................................................................... 196 14.............................................................................................................. 197 Integration with Systemwalker Resource Coordinator ..................... 197

14.1 Introduction.................................................................................................... 199 14.2 Settings required on the Softek Storage Manager machine ....................... 200

14.2.1 Configuration for Event Definition file.................................................. 200 14.2.2 Configuration for HOSTNAME-IPADDRESS ..................................... 201

14.3 Configuration for Event Log Output ........................................................... 201 15.............................................................................................................. 203 Logs ......................................................................................................... 203

15.1 Logging in Windows ...................................................................................... 205 15.1.1 Event Logging .......................................................................................... 205 15.1.2 Trace Logging........................................................................................... 205

15.2 Logging in Unix .............................................................................................. 207 15.2.1 Syslog Logging ......................................................................................... 207 15.2.2 Trace Logging........................................................................................... 207

15.3 Default values for configurable parameters ................................................ 208

ix

15.4 Rotation Mechanism...................................................................................... 209 15.5 Investigation material .................................................................................... 209 15.6 Sample initialization and configuration files ............................................... 210

Glossary................................................................................................... 213

x

Figures Figure2 .1 Softek Storage Manager Console ................................................................................... 13 Figure2. 2 Show Statement Toolbar................................................................................................. 14 Figure2. 3 Command Toolbar .......................................................................................................... 15 Figure2. 4 Visualizer Window ......................................................................................................... 15 Figure2. 5 Detailer Window and Tabs ............................................................................................. 17 Figure3 .1 Select SSM Server Dialog box ....................................................................................... 27 Figure3. 2 Administrator Identification/Signon Dialog Box............................................................ 28 Figure3. 3 Configuring Administrators............................................................................................ 29 Figure3. 4 Administrators Dialog Box............................................................................................. 29 Figure3. 5 Schedule Tab for Servers................................................................................................ 31 Figure3. 6 Options: Storage Data Tab.............................................................................................. 31 Figure3. 7 Show Menu .................................................................................................................... 32 Figure3. 8 Show Statement.............................................................................................................. 32 Figure3. 9 Options: Storage Data Tab.............................................................................................. 34 Figure3. 10 Set File System Capacity Using the Details Tab for Servers........................................ 35 Figure3. 11 Column Configurator.................................................................................................... 35 Figure3 .12 Setting a Rule ............................................................................................................... 36 Figure3 .13 Defining a Condition .................................................................................................... 37 Figure3 .14 Column Configurator ................................................................................................... 37 Figure3. 15 Visualizer Context Menu.............................................................................................. 38 Figure3. 16 Highlighted Storage Capacity Row .............................................................................. 38 Figure3. 17 Rules Display ............................................................................................................... 38 Figure4. 1 Files Display................................................................................................................... 45 Figure4. 2 Files Display-VisualizerStatus Bar ................................................................................. 47 Figure4. 3 File Commands Menu .................................................................................................... 49 Figure4. 4 File Command: Delete Dialog Box ................................................................................ 50 Figure4. 5File Command: Archive Dialog Box............................................................................... 50 Figure4. 6 File Command: Archive and Delete ............................................................................... 51 Figure4. 7 Export File from View Dialog Box ................................................................................ 52 Figure4. 8 Verify Selected Servers................................................................................................... 53 Figure4.9 Folders Display ............................................................................................................... 53 Figure4.10 Folders Display- Visualizer Status Bar.......................................................................... 55 Figure 4.11 Folders Display............................................................................................................. 56 Figure 4.12 Folder Commands Menu .............................................................................................. 57 Figure 4.13 Folder Command: Archive Dialog Box....................................................................... 58 Figure 4.14 Export Folders from View Dialog Box......................................................................... 59 Figure 4 .15 Verify Selected Servers................................................................................................ 60 Figure 4.16 Update Folder Capacity................................................................................................ 60 Figure4 .17 File Systems Filter Example......................................................................................... 62 Figure4 .18 File Systems Visualizer and Detailer............................................................................ 62 Figure 4.19 Select display option .................................................................................................... 63 Figure4 .20 Details Tab for a File System ....................................................................................... 64 Figure4. 21 File System Commands Menu...................................................................................... 65 Figure4. 22 Export File from View Dialog Box .............................................................................. 65 Figure4 .23 Verify Selected Servers................................................................................................. 67 Figure4 .24 Servers Visualizer and Detailer .................................................................................... 68 Figure4 .25 Server Filters ................................................................................................................ 68 Figure4 .26 Schedule Tab for Servers.............................................................................................. 70 Figure4 .27 Server Commands Context Menu................................................................................. 71 Figure4 .28 Export File From View Dialog Box ............................................................................. 71 Figure4 .29 Refresh Capacity Data Screen ...................................................................................... 72 Figure4 .30 Capacity and File Data Status Screen........................................................................... 73 Figure4 .31 Visualizer Tab for Databases ........................................................................................ 74 Figure4 .32 Details Tab for a Database............................................................................................ 75

xi

Figure4 .33 Schedule Tab for a Database ........................................................................................ 76 Figure4. 34 Database Commands Context Menu ............................................................................ 77 Figure4. 35 Refresh Database Data Screen...................................................................................... 77 Figure4. 36 Capacity and File Data Status Screen........................................................................... 78 Figure4. 37 Server Tab for a Database............................................................................................. 79 Figure4. 38 Visualizer Tab for Tablespaces .................................................................................... 80 Figure4. 39 Details Tab for a Tablespace......................................................................................... 81 Figure4. 40 DSI Information in the tablespace details tab............................................................... 82 Figure4. 41 Database file type filter ................................................................................................ 82 Figure4 .42 Visualizer tab for Data files .......................................................................................... 83 Figure4 .43 Visualizer tab for Control files ..................................................................................... 83 Figure4 .44 Visualizer tab for Log files ........................................................................................... 84 Figure4 .45 Details tab for a Microsoft SQL Data file..................................................................... 85 Figure4 .46 Details tab for an Oracle Data file ................................................................................ 85 Figure4 .47 Details tab for a Symfoware Data file .......................................................................... 85 Figure4 .48 Details tab for an Oracle Control file ........................................................................... 86 Figure4 .49 Details tab for a Symfoware Control file...................................................................... 86 Figure4 .50 Details tab for a Microsoft SQL Log file...................................................................... 86 Figure4 .51 Details tab for an Oracle Log file ................................................................................. 86 Figure4 .52 Details tab for a Symfoware Log file ........................................................................... 87 Figure5. 1 Actions Sets Visualizer and Detailer .............................................................................. 92 Figure5. 2 Server Action Sets Detailer Tab...................................................................................... 93 Figure5. 3 Database Action Sets Detailer Tab ................................................................................. 95 Figure5. 4 Assignments Tab for Action Sets.................................................................................... 95 Figure5 .5 Actions Tab for Server Action Sets................................................................................. 97 Figure5 .6 Actions Tab for Database Action Sets ............................................................................ 97 Figure5. 7 Define Export Results Parameters Dialog Box .............................................................. 99 Figure5. 8 Database Action Sets – Database type filter ................................................................. 101 Figure5. 9 Database Action Sets – Action on filter........................................................................ 101 Figure5 .10 DSI Action Sets .......................................................................................................... 102 Figure5. 11 Preview Action Results for Files: Select Server Tab .................................................. 103 Figure5 .12 Preview Action Results for Folders: Select Server Tab .............................................. 103 Figure5 .13 Preview Action Results for Files: Results Tab............................................................ 104 Figure5 .14 Preview Action Results for Folders: Results Tab ....................................................... 105 Figure5.15 Schedule Tab for Servers............................................................................................. 106 Figure5.16 Refresh Menu .............................................................................................................. 107 Figure6. 1 Logs Visualizer and Detailer .........................................................................................111 Figure6. 2 Logs Details Tab............................................................................................................112 Figure6 .3 Options: Storage Data Tab.............................................................................................113 Figure7 .1 Groups Visualizer and Detailer......................................................................................117 Figure7. 2 Details Tab for Groups ..................................................................................................118 Figure7. 3 Members Tab for Server Groups ...................................................................................119 Figure7. 4 Members Tab for DB Server Groups.............................................................................119 Figure7 .5 Subscribers Tab for Groups .......................................................................................... 120 Figure7. 6 Assignments Tab for Server Action Sets ...................................................................... 121 Figure7. 7Assignments Tab for Database Action Sets ................................................................... 122 Figure7. 8 Schedule Tab for Servers.............................................................................................. 123 Figure8. 1 Custom Commands Dialog........................................................................................... 128 Figure8 .2 Custom Command Contexts Dialog............................................................................. 129 Figure8. 3 Invoking a Custom Command from the Commands Menu.......................................... 131 Figure8. 4 Select a Custom Command .......................................................................................... 132 Figure8. 5 Define Export Results Parameters Dialog .................................................................... 133 Figure8. 6 Custom Command - Windows Archive Using Info-Zip ............................................... 136 Figure8. 7 Custom Command Context .......................................................................................... 137 Figure8. 8 Custom Command - Archive with Zip (Unix).............................................................. 138 Figure8. 9 Command Context - Archive with Zip (Unix).............................................................. 139

xii

Figure8. 10 Cleaning Up Archive Folders ..................................................................................... 140 Figure9 .1 Configuring Administrators.......................................................................................... 147 Figure9 .2 Administrators Dialog .................................................................................................. 147 Figure9 .3 Administrator Dialog.................................................................................................... 148 Figure9. 4 Server Tab for a Database............................................................................................. 149 Figure9 .5 Options Storage Data Tab............................................................................................. 149 Fugure9. 6 Options System Tab..................................................................................................... 150 Figure9. 7 Options Reporter Tab ................................................................................................... 153 Figure9. 8 Options DB Server Tab ................................................................................................ 154 Figure10. 1 Archive Servers .......................................................................................................... 160 Figure10. 2 Archive Servers .......................................................................................................... 161 Figure10. 3 System Properties ....................................................................................................... 162 Figure10. 4 Environment Variables ............................................................................................... 163 Figure10. 5 Environment Variables - Path ..................................................................................... 164 Figure10. 6 Edit System Variable .................................................................................................. 165 Figure12 1 Locating Process Monitor ........................................................................................... 174 Figure12. 2 Softek Process Monitor Dialog Box........................................................................... 174 Figure12. 3 Process Configuration Dialog Box............................................................................. 175 Figure 13.1 AgentConfigurator Dialog Box .................................................................................. 179 Figure 13.2 FileSystem tab ............................................................................................................ 180 Figure 13.3 Filesystem Configuration ......................................................................................... 181 Figure 13.4 Add Filesystem Information ....................................................................................... 181 Figure 13.5 AgentConfigurator Before Save ................................................................................. 182 Figure 13.6 Agent Configurator After Save................................................................................... 182 Figure 13.7 Edit Filesystem Information ....................................................................................... 183 Figure 13.8 Adding Exclude Snapshot Folder ............................................................................... 184 Figure 13.9 Add Folder Information............................................................................................ 185 Figure 13.10 Browse For Folder.................................................................................................. 186 Figure 13.11 Adding Folder Name with Path .............................................................................. 186 Figure 13.12 Agent Configurator Before Save ............................................................................ 187 Figure 13.13 Agent Configurator After Save................................................................................. 187 Figure 13.14 Edit Folder Information............................................................................................ 188 Figure 13.15 Modifying Folder Name using Edit Option............................................................. 188 Figure 13.16 Confirmation Dialog................................................................................................ 189 Figure 13.17 Cluster Agent Configurator ..................................................................................... 190 Figure 14.1 Interaction between SSM and Resource Coordinator............................................... 199

xiii

The Softek Storage Manager Console

1

2

Section 1 The Softek Storage Manager Console

3

4

1

Introduction

• 1.1 Overview 7

• 1.2 Collecting File Information 8

• 1.3 Reports 8

• 1.4 Action Sets Processing and Automation 8

• 1.5 Remote File System Scanning 9

5

6

This chapter introduces Softek Storage Manager, Fujitsu Softek’s innovative solution to the challenge of storage management.

1.1 Overview Softek Storage Manager provides comprehensive space management functions, and melds them with state of the art ‘Policy Management’ and ‘Task Automation.’

Softek Storage Manager solves the complex tasks of storage management by treating storage as a universal commodity, regardless of differences in operating systems or hardware environments.

1.1.1 Managing Storage Resources with Softek Storage Manager Storage resource management is a very fast growing segment of the software market. Softek Storage Manager is a product designed to aid Storage Administrators and enterprises better manage their storage resources on the network. Combined with Softek’s other storage resource management products, Storage Manager will help provide a compelling value proposition for business enterprises. It simplifies storage management and reduces the need for further hardware acquisitions, thus addressing two major cost items to your company.

Storage Manager monitors and manages the storage associated with specified servers in your SAN. Softek Storage Manager enables you to manage space utilization for the following resources:

• Files

• Folders

• File Systems

• Servers

• Databases, Tablespaces, Database files and DSI’s

The file systems and files are from the point of view of the server’s operating system. This view is what the Storage Administrator typically deals with.

Space Management tasks are those executed to:

• Analyze storage availability.

• Analyze storage capacity, folder and file usage.

• Devise techniques to use storage more efficiently.

To help Storage Administrators perform effective space management, Softek Storage Manager:

• Collects file information from managed servers.

• Generates space management reports to help Storage Administrators understand their storage resources and how they are being used.

• Provides the Storage Administrator with methods to describe conditions as well as actions to perform to help automate certain storage management tasks.

7

1.2 Collecting File Information Space Agents perform data collection on managed servers. This data will include items such as:

• File System Information

• Amounts of free and used space

• Folder Information

• File Information

• File name

• Creation date

• Last accessed date

• Backup indicator

Collected data is sent back to the Storage Management Server (SMS), where it is stored in an SQL Server 2000 database.

Softek Storage Manager Space Agent software is supported on Windows, Solaris, AIX, HP-UX and Linux, operating systems. For more information on Space Agents, the collector and databases, see Chapter 11: Space Agents, Data Collector and Database.

!

CAUTION: Fujitsu Softek recommends that you back up the Softek Storage Manager database regularly by using the MS SQL Server backup procedure. For more information on backing up a database, refer to the MS SQL Server 2000 documentation.

1.3 Reports Softek Storage Manager provides the customer with many reports about file systems, folders and files. Users can see at a glance the utilization of storage, stagnant files, capacity planning projections, files of certain types, etc. An interactive Graphical User Interface (GUI) is provided to support ‘ad hoc’ reports that can ‘slice and dice’ the data in about any form imaginable.

For more information on reports, see Softek Storage Manager Reports User Guide 2.3 (ML- 145030).

1.4 Action Sets Processing and Automation An interactive user interface, known as the Softek Storage Manager Console, allows Storage Administrators to specify the method to manage their storage. After the action sets have been defined, and operation starts, action set processing checks the file system and file tables to see if any information matches the conditions specified in the action set. If a match occurs, the specified action set will be communicated to the ‘Automation’ function which will cause the action to execute.

8

The action set conditions will generate SQL requests to the database. The resultant query output will be a list of file systems, files, folders, tablespaces, database files or DSI’s that meet the query. This list is then used as a parameter for the Automation function. Some of the actions supported include:

• Delete files

• Archive and delete files

• Archive folders

• Send an alert

• Export the results of an action set to a file

• Send to Event Log. (For Capacity Update, Folder Capacity Update and Database Configuration Update)

• Execute a custom command.

Some actions, such as deleting files, take place on the managed server under control of the Space Agent. Other actions, such as a message sent to the Storage Administrator and a message sent to event log , will be performed from the Softek Storage Management Server.

1.5 Remote File System Scanning Softek Storage Manager uses remote file system scanning to scan one of several file systems on a remote server where a Space Agent is not installed. From one Space Agent, it is possible to scan file systems from one or many file servers.

For information about remote file system scanning, see Chapter 12: Scanning Remote File Systems.

9

10

2

Key Features

• 2.1 Toolbars and Windows 13

• 2.2 Application Window 14

• 2.3 Launch Bar 18

11

12

2.1 Toolbars and Windows Figure2 .1 Softek Storage Manager Console

Application Window

Launch Bar

Command Toolbar

Detailer Tabs

Visualizer Window

Detailer Window

Show Statement Toolbar

Each view within the Softek Storage Manager Console includes the following sections:

Application Window • Show Statement Toolbar: You build a Show Statement to display different storage resources

in your storage enterprise: files, folders, file systems, servers. For more information on building a Show statement, see 3.6 Building a Show Statement.

• Command Toolbar: The Command Toolbar allows you to select, filter and execute commands on column rows.

• Visualizer Window: The Visualizer window provides views of storage resources in row format. It paints the storage picture in numeric values and graphical images, where appropriate.

NOTE

• To customize column values and graphics, use the Column Configurator. To display the Column Configurator, right-click in any area of the Visualizer.

• To “drill down” to the next row level, double-click an object in the Visualizer. For example, if you double-click a server, a list of file systems on that server appears. If you double-click a file system, a list of the 100 largest files or folders belonging to that file system appears.

• Detailer Window: The Detailer window contains tabs that provide detailed information and options for objects displayed in the Visualizer.

13

Launch Bar The Space Optimizer section of the Launch Bar includes the following icons:

• Storage

• Action Sets

• Logs

• Groups

• Reports

2.2 Application Window 2.2.1 Show Statement Toolbar

You use the controls on the Show Statement Toolbar to describe what kinds of objects should be shown in the Visualizer.

As shown in figure: Show Statement Toolbar, the Show Statement controls let you create a natural language query to display the following objects in the Visualizer: files, folders, file systems, servers, databases, tablespaces or database files.

Figure2. 2 Show Statement Toolbar

History Arrows

Use the History arrows to step through previous show statements that were created during this session. Click on the large blue arrows backward or forward through previous Show statements created during this session.

The statements display in the finder. You must click the GO button to re-execute the query and update the Visualizer.

Favorites Use the Favorites feature to record your most useful Show Statements (queries), and preserve them after exiting the application. The next time you enter the Softek Storage Manager Console, you can click the Favorites down-arrow to display the list of favorite queries. Favorites can record up to 50 Show Statements.

► To record a favorite:

1. Click the yellow star icon to record the current query as a favorite (the query must have been executed).

2. Select an entry from the favorites list to display the query in the Finder. You must click GO to re-execute the query, and update the Visualizer.

14

► To remove a favorite:

1. Click the arrow next to the Favorites icon, and select Delete Favorite(s).

2. Select the Favorites you wish to remove from the pop-up window.

Show Objects Click the Show down arrow to select the type of object to be displayed in the Visualizer. You can show files, folders, file systems, servers, databases, tablespaces or database files.

Add Filter You use the Add Filter button to add new filters to determine the type of information displayed in the Visualizer. The type of filters available vary, depending on the type of object selected.

Click the Add Filter button ( ) to add additional filters to the Show Statement query.

Go Button You must click the Go button to execute a Show Statement query. The contents of the Visualizer are grayed-out until the go button is pressed, executing the Show Statement.

2.2.2 Command Toolbar The Command toolbar contains controls for executing commands on storage resources, as well as selecting and filtering objects in the Visualizer display. Different commands are available, depending on the type of object you are viewing.

Figure2. 3 Command Toolbar

The Command toolbar lets you:

• Execute commands on objects displayed in the Visualizer.

• Hide selected rows from the Visualizer display.

• Hide non-selected rows from the Visualizer display.

• Reveal all rows that were hidden by previous Hide commands.

2.2.3 Visualizer Window Use the Visualizer window to view and analyze all the storage and space elements across your enterprise. As shown in figure: 2.4 Visualizer Window, the Visualizer paints the storage picture in numeric values and graphical images, where appropriate.

Figure2. 4 Visualizer Window

15

The Visualizer gives you an integrated view of storage objects and space elements, so you can scan and analyze the entire storage environment across operating platforms.

The Visualizer:

• Tells you how much space is used or available on each file system, and displays each system’s total storage capacity.

• Provides detailed information about files and directories across operating systems.

• Provides detailed information about Servers across the enterprise.

• Can be fully customized using the Column Configurator. For information, see figure3.11 : Column Configurator.

Manipulating the Display You can manipulate the Visualizer display to customize, rearrange or sort column data:

• Drag header borders to resize a column.

NOTE

In some columns both text and graphics may display together, for example numbers with bars. In these cases, hold down the CTRL key while you drag the column header to resize both the text and graphic portion of the display. When you release the CTRL key and continue to drag the header, the size of the text portion will remain fixed.

• Drag the header titles to reorder columns.

• Single-click to sort the column. Repeating the clicks toggles the sequence from ascending to descending. The Sort triangle is displayed on the last sorted column, pointing in the direction of the sort.

• To customize individual columns, right-click in the header to display a menu, and then select Column Configurator. For information about using the Column Configurator, see figure3

16

10: Column Configurator.

2.2.4 Detailer Window and Tabs The Detailer window and tabs show details about the object that was last selected in the Visualizer. When multiple items are selected, the Detailer displays information about the first item that was clicked.

Figure2. 5 Detailer Window and Tabs

Detailer Tabs Detailer

Window

Resizing the Detailer

To resize the Detailer window, drag the splitter control that separates the Detailer and the Visualizer.

17

2.3 Launch Bar

You can access the following Space Optimizer functions from the Launch Bar: • Storage • Action Sets • Logs • Groups • Reports To access Softek Storage Management Space Optimizer functions, select the appropriate application icon from the Space Optimizer section of the Launch Bar. Storage, Action Sets, Logs and Groups functions are described in detail in other chapters in this book. For Reports information, see the Softek Storage Manager Reports User Guide 2.3 (ML-145030). Accessing Additional Installed Applications Click the Applications button to display the icons for any additional Softek products that have been installed with Softek Storage Manager.

18

2.3.1 Storage Function

The Storage function enables you to view, filter, and manage storage resources across the enterprise, including files, folders, file systems, servers, server groups and databases. For more information about Storage functions, see Chapter 4: Managing Storage Resources.

2.3.2 Action Sets Function

The Action Sets function allows you to define and test rules for performing automated actions (Action Sets). For more information about Action Sets, see Chapter 5: Creating Action Sets.

2.3.3 Logs Function

The Logs function allows you to view log entries generated by the execution of an Action Set. For information about using the Logs tab, see Chapter 6: Viewing Action Logs.

2.3.4 Groups Function

You can manage servers and database servers more efficiently by assigning them to groups. Using groups allows easy consolidation of server data / database server data for reporting purposes and e-mail alerts. For more information on Groups, see Chapter 7: Managing Groups.

2.3.5 Reports Function

Softek Storage Manager Reports provide you with highly specialized and organized data. Using Softek Storage Manager, you can generate real-time reports. For more information on the Softek Storage Manager’s reporting capabilities, see the Softek Storage Manager Reports User Guide 2.3 (ML-145030).

19

20

Getting Started

21

22

Section 2 Getting Started

23

24

3

Getting Started

• 3.1 Getting Started Overview 27

• 3.2 Launching the Storage Manager Console 27

• 3.3 Configuring an Administrator 29

• 3.4 Setting Up a Server Data Collection Schedule 30

• 3.5 Configuring System Options 31

• 3.6 Building a Show Statement 32

• 3.7 Setting a Default Threshold for Server File System Capacity 34

• 3.8 Setting File System Capacity Threshold for a Selected Server 34

• 3.9 Customizing Column Displays 35

• 3.10 Rule Example 37

25

26

3.1 Getting Started Overview This chapter briefly outlines how to get started using the Softek Storage Manager Console, including the preliminary steps that need to be undertaken the first time you launch Softek Storage Manager following installation. These steps include:

• Configuring Administrators

• Setting up a Data Collection Schedule for Servers

• Configuring System Options

• Building a Show Statement

• Setting a Threshold for File System Capacity

• Setting a Threshold for Servers

• Customizing the information display

3.2 Launching the Storage Manager Console ► To launch the Storage Manager Console:

• Click on Start>Programs>SOFTEK Storage Manager>Storage Manager (Read Write).

Everytime you start Softek Storage Manager, a screen requests server information as shown in figure: Select SSMServer Dialog.

Figure3 .1 Select SSM Server Dialog box

The Select SSMServer Dialog has following controls.

Dropdown Edit Control: You can enter the Softek Storage Manager Server name in the text box to connect to the particular server. There is a limit of a maximum of 10 servers that can be added in the dropdown list. If more than ten servers are added, then the server that was added first will be removed from the list.

OK: When user clicks the OK button the console will try to connect to the Softek Storage Manager Server mentioned in the Dropdown Edit control.

Cancel: When user clicks on the Cancel button the Select SSMServer Dialog will be closed.

Clear: When user clicks the Clear button, the text entered in the Dropdown control will be cleared. If there is no text entered in the Dropdown control the Clear button will be disabled.

The first time you start Softek Storage Manager, after successful connection with the Softek Storage Server, a screen requests user information, as shown in figure: Administrator Identification/Signon Dialog Box. Enter either the user’s first name or last name, or both.

27

Figure3. 2 Administrator Identification/Signon Dialog Box

28

3.2.1 Operating Modes Softek Storage Manager can operate in either read-write or read-only mode. A start-up option that was specified during installation provides Softek Storage Manager console icons that operate in either mode. Only one console is allowed read-write access at any time. Once the console is started in a particular mode, it remains in that mode until shut down.

The Softek Storage Management Server installs with the Read-Write Storage Manager Console application. A read-only version of the Storage Manager Console can be installed on other Windows 2000 or Windows 2003 machines for use by the Storage Administrator.

3.3 Configuring an Administrator To start, you need to configure at least one Softek Storage Manager Administrator. You are automatically prompted to configure an administrator at first startup of the Softek Storage Manager console.

► To configure an Administrator:

1. From the Configuration Menu, select Administrators as shown in figure: Configuring Administrators. An administrator must be defined before he or she can be assigned to a server.

Figure3. 3 Configuring Administrators

2. A dialog box that shows all administrators defined to the system will appear as shown in figure: Administrators Dialog Box. From this dialog box, you can add, edit and delete an administrator, or set the administrator as a default.

Figure3. 4 Administrators Dialog Box

29

3.4 Setting Up a Server Data Collection Schedule This section describes how to set up a schedule to collect server data to be used by Softek Storage Manager.

!

CAUTION: The following procedure will override the server’s active action set schedule, if any.

► To set up a server data collection schedule:

1. Create a Show Statement to show servers.

2. Select a server in the Visualizer.

3. Click the Schedule tab in the Detailer to change the data collection schedule for the highlighted server, as shown in figure3.5: Schedule Tab for Servers.

4. Select the time(s) of day, week or month you would like to collect file data , folder data or File System Capacity information (up to four times a day/week/month). The values for “Day Of Week” range from “Sunday” to “Saturday”. The values for “Day Of Month” are from 1-31 and “Last” (last day of the month).

You must select and change the data collection schedules for servers one at a time—you cannot do multiple selections on groups of servers.

NOTE

If the value set in [Date(monthly unit)] does not exist in that month, it will be ignored. For example, when "31" is set, as the 31st day does not exist in the months 2,4,6,9,11 , this will be ignored.

5. Select or Enter the intervals for collecting file system capacity information, from every 15 minutes, to every 1440 minutes (24 hours), starting at the base date time specified. Select or Enter the intervals for collecting folder data information, from every 1 hours, to every 96 hours, starting at the base date time specified. Select or Enter the intervals for collecting file data information, from every 1 day, to every 90 days, starting at the base date time specified.

30

Figure3. 5 Schedule Tab for Servers

3.5 Configuring System Options Many Softek Storage Manager settings can be set and modified by selecting Options from the Configuration Menu. The Options dialog box allows you to select and set system, storage collection and reporting preferences. The dialog box contains four tabs: Storage Data, System, Reporter and DB Server.

Figure3. 6 Options: Storage Data Tab

31

For detailed information about setting system options, see Chapter 9: Configuring Administrators and Setting System Options.

3.6 Building a Show Statement You build a Show Statement in order to view storage resources in the Visualizer. The type of Show Statement you build filters the resulting display.

► To build a Show Statement:

1. Click on the Show icon to select a starting point.

2. From the Show Menu, select the object type to be displayed in the Visualizer: files, folders, file systems, servers, databases, tablespaces or database files.

Figure3. 7 Show Menu

3. Click the control for each part of the Show Statement to display a context menu of other

options, and choose the options you want. A scroll bar appears on the right of drop-down boxes whenever there are too many entries to display in the available space.

Figure3. 8 Show Statement

32

NOTE

When building a Show Statement, an asterisk (*) can be used as a wild card.

4. Click the Add button to add another filter control. The new filter appears after the existing filter, and a context menu for the new filter opens.

5. Select options for the new filter from the pop-up menu, or enter in your desired configurations in the text box that appears. The text box may only appear for certain options.

6. Click the Go button. The Visualizer window is updated to show the result of the Show Statement.

NOTE

When the Visualizer is grayed-out, this means the Show Statement query has not been executed. Click Go to execute the most recent Show Statement.

33

3.7 Setting a Default Threshold for Server File System Capacity You set a default capacity threshold for file systems using the Storage Data tab on the Options dialog box.

► To set a threshold for file system capacity using the Options dialog box: 1. From the Configuration Menu, select Options. The Options: Storage Data tab appears.

Figure3. 9 Options: Storage Data Tab

2. In the File System Capacity area, select a numeric value for the file system capacity threshold.

3.8 Setting File System Capacity Threshold for a Selected Server

You can set a file system capacity threshold for a selected server on the Details tab for servers. Setting a server threshold on the Details tab overrides the default setting specified on the Options - Storage Data tab.

► To set file system capacity for a selected server:

1. Create a Show Statement to show servers.

2. Use the control on the Details tab for Servers, as shown in the following figure: Set File System Capacity Using the Details Tab for Servers.

34

Figure3. 10 Set File System Capacity Using the Details Tab for Servers

File system capacity control

3.9 Customizing Column Displays You use the Column Configurator to customize the way columns are displayed in the Visualizer. To sort columns, simply click a column header.

3.9.1 Using the Column Configurator The Column Configurator enables you to customize the way columns are displayed in the Visualizer. For example, you could customize the display so that large files are displayed in the color red.

► To use the Column Configurator: 1. Right-click a column name in the display, and choose Column Configurator. The Column

Configurator dialog box appears. Figure3. 11 Column Configurator

35

2. Select a Column Name to highlight that row in the Column Configurator.

3. Select your desired display options in the lower portion of the dialog box. Different display options will be available, depending on the type of Column Name chosen.

4. Click OK.

Values for the columns you selected will be displayed as requested, in the Visualizer.

3.9.2 Showing and Hiding Columns in the Visualizer Use the Column Configurator to show or hide the columns that appear in the Visualizer.

► To show and hide columns in the Visualizer:

1. Right-click a column name in the Visualizer display, and choose Column Configurator. The Column Configurator dialog box appears as shown in figure: Column Configurator.

2. In the Show column, check the Show box next to the column names you would like shown in the Visualizer. Un-check column names to hide them from the Visualizer display. If the Show box is not checked, then that column will not appear in the Visualizer display.

3. Click OK.

3.9.3 Setting Rules for Display Colors Use this procedure to set rules that determine which color will be used for storage objects in the Visualizer displays. This can be done, for example, to highlight servers that are over a certain capacity, if threshold capacities are being approached, etc.

► To set rules for display colors:

1. Right-click a column name in a Visualizer display, and choose Column Configurator. The Column Configurator dialog box appears as shown in figure3 10: Column Configurator.

2. In the scrolling list box, highlight the column name for which the rule is to be set.

3. In the bottom half of the Column Configurator, check Highlight If (column name) and then click No Rule Defined.

Figure3 .12 Setting a Rule

4. In the menu that appears, define the condition to be met for this column, and then click OK.

36

Figure3 .13 Defining a Condition

5. Click the color block next to Then Set Color To. The Color dialog box opens. Click a color or define a custom color, and then click OK. The column you selected will be displayed in the specified color when the condition is met. For example, for file threshold, you could set a rule so that all files allocated with more than 2 GB are displayed in red, as shown in figure3. 14: Column Configurator.

Figure3 .14 Column Configurator

3.10 Rule Example Following is an example of how to set a rule for highlighting files that have a large Allocated Size:

► To set a rule for highlighting files that have a large Allocated Size: 1. Create a Show Statement to show files.

2. Right-click a column and select Column Configurator.

37

Figure3. 15 Visualizer Context Menu

3. Highlight the Storage Capacity row in the Column Configurator. Figure3. 16 Highlighted Storage Capacity Row

4. In the lower portion of the Column Configurator window, click the controls and set Units to Megabytes, Display as Bar in Frame, and Storage Capacity Is Greater than 100 MB. Set the highlight color to red, as shown in the next example.

Figure3. 17 Rules Display

5. Click OK to return to the File display. Note that files larger than 100 MB are now highlighted with red graphical bars showing their relative size. By clicking on the Name column in the Visualizer, you can sort the files in ascending or descending order.

38

Managing Storage

39

40

Section 3 Managing Storage

41

42

4

Managing Storage Resources

• 4.1 Accessing the Storage Function 45

• 4.2 Viewing and Filtering Files 45

• 4.3 Managing Files with File Commands 49

• 4.4 Viewing and Filtering Folders 53

• 4.5 Managing Folders with Folder Commands 57

• 4.6 Viewing and Filtering File Systems 61

• 4.7 Managing File Systems with File System Commands 64

• 4.8 Viewing and Setting Options for Servers 67

• 4.9 Scheduling Server Data Collection 70

• 4.10 Managing Servers with Server Commands 71

• 4.11 Managing Database Utilization 73

• 4.12 Scheduling Database Data Collection 76

• 4.13 Managing Databases with Database Commands 77

• 4.14 Viewing Server Information and Selecting an Administrator 79

• 4.15Viewing Tablespace Information 80

• 4.16 Viewing Tablespace Details 81

• 4.17 Viewing DSI Information for Symfoware 81

• 4.18 Viewing Database Files 82

• 4.19 Viewing Database Files Details 85

43

44

The Storage icon provides the starting point for managing space utilization problems. The storage function allows you to view and manage storage resources across the network, including files, folders, file systems, databases, tablespaces and database files.

4.1 Accessing the Storage Function

► To access the Storage function: • Select the Storage icon from the Space Optimizer section of the

Launch Bar.

4.2 Viewing and Filtering Files The Visualizer for files and Detailer tabs provide information about files across the network.

Figure4. 1 Files Display

Visualizer for files

Detailer for Files

► To view and filter files:

1. Build a Show statement for files as described in 3.6 Building a Show Statement. The default number of files displayed is 100 largest files. You can display the following types of file views:

− Bigger than: Enter a numeric value for file size, and enter a file unit type (KB, MB, GB).

45

− Of type: Specify the file extensions to be displayed, separating entries with a

comma or semicolon. Do not enter a leading period. Press ENTER when you are finished adding file extensions.

NOTE

Some operating systems are case sensitive.

− Named: Enter the file names to be displayed, separating entries with a comma or

semicolon. You can use a trailing asterisk (*) as a wild card. Press ENTER when you are finished adding file names.

− Accessed in the last, not accessed in the last, newer than, older than, modified in the last, not modified in the last: Select days, weeks or months from the menu.

− Accessed before, created before, modified before: Click the down arrow to display a calendar control, or manually enter the date in the edit box.

2. Click the Go button to initiate the query.

4.2.1 Visualizer for Files The Visualizer organizes file information into the following columns, as shown in Figure4. 1: Files Display:

• Name: The file name.

• Allocated Size: The amount of space this file occupies in the file system.

• Date Last Modified: The date the file was last updated.

• Date Accessed: The date the file was last accessed.

• File Extension: The file extension (for example, .exe).

• Date Created: The date the file was created.

• Server: The server machine that contains the file.

• File System: The file system that contains the file.

• Full Path: The absolute path name of the parent directory.

• File System Type: The type of file system the file is on.

• Read Only?: Indicates whether the file is read-only for everyone except the file owner.

• Apparent Size: The actual number of bytes in the file. This value can be different from the Allocated Size, due to operating system requirements.

• Owner: Displays the owner of the file.

NOTE

Total number of files satisfying the filter condition is displayed on the bar that separates the Visualizer and the Detailer(this is Visualizer status bar), along with the total number of items that are displayed in the view, and the number of items that are selected. Figure 4.2 explains this

46

Figure4. 2 Files Display-VisualizerStatus Bar

The query executed is “100 largest files on all filesystems on all servers”.The following is displayed on the status bar

Visualizer Status Bar

“100 Rows(Total 3996 ) 1 Selected”

This means , the total number of files displayed in the visualizer is 100.The number of files satisfying the filter condition is 3996. One Row is selected in the visualizer.

4.2.2 Details Tab for Files The Details tab for files as shown in Figure4. 1: Files Display provides detailed information about the last file that was selected in the Visualizer:

• Name: Displays the name of the file that was last selected in the Visualizer.

• Server: Displays the name of the server that contains this file.

• Extension: Displays the file’s extension. Mainframe files display an extension of M.

• Owner: Displays the owner of the selected file. Mainframe files do not display a value for Owner.

• Path: Displays the full path of the selected file.

• Allocated size: Displays the actual amount of disk space used by the file.

• Apparent Size: Displays the actual number of bytes in the file. This value can be different from the Allocated Size, due to operating system requirements.

47

• Last Scanned: Displays the date and time that Softek Storage Manager last did a scan for this file.

• Date Created: Displays the date the file was created.

• Date Modified: Displays the date this file was last modified.

• Date Accessed: Displays the date this file was last accessed.

4.2.3 Server Tab for Files The Server tab for files provides server information for the last file that was selected in the Visualizer:

• Name: Displays the file name.

• OS: Displays the operating system that contains the file.

• Administrator: The administrator assigned to the server that contains this file.

• Archive Server: The name of the server that is used for archiving, if any.

• File System Usage: File system usage information for the server that contains this file.

• Server Usage: Usage information for the server that contains this file.

• Set capacity threshold for all file systems on server to: Select the amount of threshold capacity (in percentage terms) desired for all file systems on this server.

• Prevent File Deletion: Check this box to prevent any files from being deleted on this server. This option prevents files from being deleted by Action Sets, custom commands or manual delete commands.

48

4.3 Managing Files with File Commands File commands enable you to delete, archive and perform other actions on files across the storage enterprise. In order to archive files using file commands, a Networker client must be installed on the computer where the space agent is installed. Mainframe files cannot be archived or deleted. For files on mainframe systems, the only valid action is Notify.

NOTE

Fujitsu Softek recommends using custom commands to archive and delete files. For information about using custom commands, refer to Chapter 8: Using Custom Commands.

► To manage files with file commands: 1. On the Finder Toolbar for files, click File Commands to bring up the File Commands

Menu. File commands include:

− Delete

− Archive

− Archive and Delete

− Export View

− Update File Data

− Invoke Custom Command

− Set this Layout as the default Files Layout.

2. Select the commands you wish to execute on the selected files. Figure4. 3 File Commands Menu

4.3.1 Deleting Files Select Delete from the File Commands Menu to bring up the Delete Dialog box, which displays a list of all files selected in the Visualizer. Only files that display a green circle in the Name column can be deleted. Files displaying a red circle cannot be deleted, according to the reason listed in the Error Reason column. Mainframe files cannot be deleted.

49

Figure4. 4 File Command: Delete Dialog Box

4.3.2 Archiving Files Select Archive from the File Commands Menu to bring up the Archive Dialog Box, which displays a list of files selected in the Visualizer. Click Archive to move the data to the archive server. (The archive server is defined on the server Details tab, as described in 4.8.2 Viewing Server Details and Setting Options.) Only files that display a green circle in the Name column can be archived; files displaying a red circle cannot be archived. (Files display a red circle when no archive server has been selected.) Mainframe files cannot be archived.

NOTE

In order to archive files, you must have installed a Networker client on each Space Agent.

Figure4. 5File Command: Archive Dialog Box

50

4.3.3 Archiving and Deleting Files Select Archive and Delete from the File Commands Menu to bring up the Archive and Delete Dialog Box, which displays a list of files selected in the Visualizer. Click Archive and Delete to move the selected data to another storage media on the archive server, and delete all selected files from the system. (You select the archive server on the server Details tab.) Only files that display a green circle in the Name column can be archived and deleted; files displaying a red circle cannot be archived and deleted. (Files display a red circle when no archive server has been selected.) Mainframe files cannot be archived and deleted.

NOTE

Custom commands are the preferred way to archive and delete files, as described in CHAPTR 8 Using Custom Commands. The Archive and Delete command supports archiving only with Networker software. In order to archive and delete files, you must have installed a Networker client on each Space Agent. Customers are responsible for installing and configuring the archiving software, both the server and the client parts.

Figure4. 6 File Command: Archive and Delete

!

CAUTION: Changes to a server’s environment will not be propagated to any service, including Softek Process Monitor, until the server is rebooted. For example, if Networker Monitor is installed without rebooting, the path to the nsarchive program will not be in the PATH environment variable.

4.3.4 Invoking A Custom Command Select Invoke Custom Command from the File Commands Menu to select a custom command and optional custom command context. For more information about using custom commands, see Chapter 8: Using Custom Commands.

4.3.5 Exporting a File View Select Export View from the File Commands Menu to bring up the Export File from View Dialog Box. You use this dialog to export the viewable rows from the Visualizer to an exported file, where it can be viewed or printed.

51

Figure4. 7 Export File from View Dialog Box

The dialog box includes the following areas:

• Save In: Select the drop down box and choose a destination folder for placement of the export file.

• File Name: The name of the exported file.

• Save as type: Select either Comma Separated Values (CSV), or Tab Separated.

• Include Headings as First Row: Select to use the column headings as the first row of the view file.

• Delimiter: Click an option to select a delimiter type.

• Which Rows to Export: Select the rows you wish to export, either All Rows, Only Revealed Rows, or Only Selected Rows.

Click Save to export the selected files.

4.3.6 Updating File Data Select the Update File Data from the File Commands Menu to manually invoke a file data update by the server and Space Agent. This command can cause significant traffic on the network.

The Update File Data command prompts you to confirm the servers to be updated, as shown in figure: Verify Selected Servers. Only the servers that were highlighted in the Visualizer are displayed. In the Verify Selected Servers dialog box, select the servers you wish to update, and click Begin.

52

Figure4. 8 Verify Selected Servers

4.3.7 Setting a Default Layout If you have customized file column displays using the Column Configurator and wish to save that configuration as the default display, select Set this layout as the default File layout from the File Commands Context Menu. Every time you return to the Visualizer display for files, this layout will be the first view for files that is displayed.

NOTE

The default layout does not apply to layouts that have been saved as Favorites.

4.4 Viewing and Filtering Folders The Visualizer for folders and Detailer tabs provide information about folders across the network.

Figure4.9 Folders Display

53

To View and filter folders:

1. Build a Show statement for folders as described in 3.6 Building a Show Statement. The default number of folders displayed is 100 largest folders. You can display the following types of folder views:

− Bigger than: Enter a numeric value for folder size, and enter a folder unit type (KB, MB, GB).

− Named: Enter the folder names to be displayed, separating entries with a comma or semicolon. You can use a trailing asterisk (*) as a wild card. Press ENTER when you are finished adding folder names.

− in folders: Enter the path names to be displayed, separating entries with a comma or semicolon. You can use a trailing asterisk (*) as a wild card. Press ENTER when you are finished adding folder names.

− Accessed in the last, not accessed in the last, newer than, older than, modified in the last, not modified in the last: Select days, weeks or months from the menu.

− Accessed before, created before, modified before: Click the down arrow to display a calendar control, or manually enter the date in the edit box.

2. Click the Go button to initiate the query.

4.4.1 Visualizer for Folders The Visualizer organizes folder information into the following columns, as shown in Figure4.9 : Folders Display:

• Name: The folder name.

• Full Path: The absolute path name of the parent directory

• File System: The file system that contains the folder

• File System Type: The type of file system the folder is on.

• Server: The server machine that contains the folder

• Allocated Size: The amount of space this folder occupies in the file system.

• Apparent Size: The apparent size of the folder in the file system

• Date Last Modified: The date the folder was last updated.

• Date Created: The date the folder was created.

• Read Only? : Indicates whether the folder is read-only for everyone except the folder owner.

• Owner: Owner of the folder

NOTE

Total number of folders satisfying the filter condition is displayed on the bar that separates the Visualizer and the Detailer(this is Visualizer status bar), along with the total number of items that are displayed in the view, and the number of items that are selected. Figure 4.10 explains this

54

Figure4.10 Folders Display- Visualizer Status Bar

Visualizer Status Bar

The query executed is “100 largest folders on all filesystems on all servers”.The following is displayed on the status bar .

“24 Rows(Total 24) 1 Selected”

This means, the total number of folders displayed in the visualizer is 24.The number of folders satisfying the filter condition is 24. One Row is selected in the visualizer.

► Navigation Option:

Once the folder list is displayed on the Visualizer window, you have an option to get down to the sublevels of this hierarchy. You have an option either to view the subfolders directly inside the selected folder or the files inside the selected folder and its sub folders. To avail

55

this option, select a folder right click on it and then in the dropdown list you will have two options: Show Files and Show Folders as shown in the figure below. One option will have a tick mark to its left. This means that at present this rule is running. For example in the figure below, Show Folders is has a tick to its left, which means that double clicking of any folder will display all the sub folders directly inside this folder.

Figure 4.11 Folders Display

4.4.2 Details Tab for Folders The Details tab for folders as shown in Figure 4.8: Folders Display provides detailed information about the last folder that was selected in the Visualizer:

• Name: Displays the name of the folder that was last selected in the Visualizer.

• Server: Displays the name of the server that contains this folder.

• Owner: Displays the owner of the selected folder.

• Path: Displays the full path of the selected folder.

• Allocated size: Displays the actual amount of disk space used by the folder.

• Last Scanned: Displays the date and time that Softek Storage Manager last did a scan for this folder.

• Date Created: Displays the date the folder was created.

• Date Modified: Displays the date this folder was last modified. The date reflects the last addition, deletion or modification of files or folders under this folder.

56

4.4.3 Server Tab for Folders The Server tab for folders provides server information for the last folder that was selected in the Visualizer:

• Name: Displays the folder name.

• OS: Displays the operating system that contains the folder.

• Administrator: The administrator assigned to the server that contains this folder.

• Archive Server: The name of the server that is used for archiving, if any.

• File System Usage: File system usage information for the server that contains this folder.

• Server Usage: Usage information for the server that contains this folder.

• Set capacity threshold for all file systems on server to: Select the amount of threshold capacity (in percentage terms) desired for all file systems on this server.

4.5 Managing Folders with Folder Commands Folder commands enable you to archive and perform other actions on folders across the storage enterprise. In order to archive folders using folder commands, a Networker client must be installed on the computer where the space agent is installed.

NOTE

Initial folder view will show the configured folders list. When any folder filter is specified, it will be applied on all the folders in the SSM Server (depending on the filesystem and server filters).

► To manage folders with folder commands:

1. On the Finder Toolbar for folder, click Folder Commands to bring up the Folder Commands Menu. Folder commands include:

− Archive

− Export View

− Update File Data

− Update Folder capacity

− Invoke Custom Command

− Set this Layout as the default Folders Layout.

2. Select the commands you wish to execute on the selected folders Figure 4.12 Folder Commands Menu

57

4.5.1 Archiving Folders Select Archive from the Folder Commands Menu to bring up the Archive Dialog Box, which displays a list of folder selected in the Visualizer. Click Archive to move the data to the archive server. (The archive server is defined on the server Details tab, as described in 4.8.2 Viewing Server Details and Setting Options.) Only folders that display a green circle in the Name column can be archived; folder displaying a red circle cannot be archived. (Folders display a red circle when no archive server has been selected.).

NOTE

In order to archive folders, you must have installed a NetWorker Edition client on each Space Agent.

Figure 4.13 Folder Command: Archive Dialog Box

58

4.5.2 Exporting a Folder View Select Export View from the Folder Commands Menu to bring up the Export Folder from View Dialog Box. You use this dialog to export the viewable rows from the Visualizer to an exported file, where it can be viewed or printed.

Figure 4.14 Export Folders from View Dialog Box

The dialog box includes the following areas:

• Save In: Select the drop down box and choose a destination folder for placement of the export file.

• File Name: The name of the exported file.

• Save as type: Select either Comma Separated Values (CSV), or Tab Separated.

• Include Headings as First Row: Select to use the column headings as the first row of the view file.

• Delimiter: Click an option to select a delimiter type.

• Which Rows to Export: Select the rows you wish to export, either All Rows, Only Revealed Rows, or Only Selected Rows.

Click Save to export the selected files.

4.5.3 Updating File Data Select the Update File Data from the Folder Commands Menu to manually invoke a file data update by the server and Space Agent. This command can cause significant traffic on the network.

The Update File Data command prompts you to confirm the servers to be updated, as shown in

59

figure: Verify Selected Servers. Only the servers that is selected were highlighted in the Visualizer are displayed. In the Verify Selected Servers dialog box, select the servers you wish to update, and click Begin.

On selected server machine, when [Exclude Other Folder of all local disks from scaning] is checked or ExcludeOtherFolders=1 is set in monitored folder configuration, only the files under the specified folders as monitored folders are scanned. When [Exclude Other Folder of all local disks from scaning] is not checked or ExcludeOtherFolders=0 is set in monitored folder configuration, all files under monitored file systems are scanned. For information about monitored folders and file systems, refer to Chapter13: Configuring Space Agents.

Figure 4 .15 Verify Selected Servers

4.5.4 Updating Folder Capacity Select the Update Folder Capacity from the Folder Commands Menu to manually invoke a folder capacity update by the server and Space Agent.

The Update Folder Capacity command prompts you to confirm the servers to be updated, as shown in figure: Verify Selected Servers. Only the servers that were highlighted in the Visualizer are displayed. In the Verify Selected Servers dialog box, select the servers you wish to update, and click Begin.

Figure 4.16 Update Folder Capacity

60

4.5.5 Invoking a Custom Command Select Invoke Custom Command from the Folder Commands Menu to select a custom command and optional custom command context. For more information about using custom commands, see Chapter 9: Using Custom Commands.

4.5.6 Setting a Default Layout If you have customized folder column displays using the Column Configurator and wish to save that configuration as the default display, select Set this layout as the default Folder layout from the Folder Commands Context Menu. Every time you return to the Visualizer display for folders, this layout will be the first view for folders that is displayed.

NOTE

The default layout does not apply to layouts that have been saved as Favorites.

4.6 Viewing and Filtering File Systems You may be interested in seeing only file systems which meet a certain criteria across your network. You can do this by building a Show Statement that filters out the file systems you do not need.

► To view and filter file systems:

1. Build a Show Statement to display the desired file systems. The default file system filter is all file systems. You can view the following types of file system views:

− all file systems: Displays all Open systems and mainframe servers and volumes.

− file systems named, except those named: Enter the desired file system names. Separate entries with a comma or semicolon. You can use a trailing asterisk (*) as a wildcard. Terminate by pressing ENTER.

− file systems with used space <, used space >, free space <, Free space >: Click the numeric value to get an edit box. Type in the desired value.

− file systems of type: Select the type of file system: EXT2, EXT3, FAT16, FAT32, HFS, JFS, JFS2, LFS, Mainframe, NFS, NTFS, NTFS5, REISERFS, UFS, VXFS, XFS.

61

Figure4 .17 File Systems Filter Example

2. Click the Go button to initiate the query.

4.6.1 Viewing File Systems in the Visualizer Figure4 .18 File Systems Visualizer and Detailer

62

The Visualizer for file systems, as shown in figure: File Systems Visualizer and Detailer, includes logical volume information for all computers and mainframe volumes in the system:

• Name: The file system name.

• % Used: The percentage of the file system’s total storage capacity that has been used.

• Used Space: The total amount of space used by this file system.

• Capacity: The total amount of space on the file system that can be used.

• Server: The name of the server that contains the file system.

• Threshold%: The threshold (in percentage terms) that has been set for this file system.

• Type: The type of file system.

Double-click a File System to Display 100 Largest Files

You can double-click a file system to display a list of the 100 largest files on that file system. The Show Statement in the Visualizer will be updated to correctly reflect what is being shown.

► Navigation Option:

Once the file system list is displayed on the Visualizer window, you have an option to get down to the sublevels of this hierarchy. You have an option either to view the folders that are monitored in the selected file system or all the files inside the selected file system. To avail this option, select a file system right click on it and then in the dropdown list you will have two options: Show Files and Show Folders as shown in the figure below. One option will have a tick mark to its left. This means that at present this rule is running. For example in the figure below, Show Folders has a tick to its left, which means that double clicking of any file system will display all the monitored folders inside this file system.

Figure 4.19 Select display option

63

4.6.2 Viewing Details for a File System Figure4 .20 Details Tab for a File System

The Details tab for file systems contains detailed information about last file system that was selected in the Visualizer:

• File System Name: Displays the name of the last file system selected in the Visualizer.

• OS: Displays the operating system that contains the file system.

• Numerics and bar graph: Provides numeric ratio, percentage and graphical views of file system capacity.

• Capacity: Displays the total capacity of the file system.

• Used Space: Displays the amount of space that has been used on this file system.

• Threshold: Displays the capacity threshold that has been set for this file system.

• Capacity last updated: Displays the last date and time Softek Storage Manager did a capacity scan.

• Files data last scanned: Displays the last date and time Softek Storage Manager did a scan for files.

• File System Discovered: Displays the date and time Softek Storage Manager started monitoring this file system.

• Server Name: Displays the name of the server that contains the files system.

• Administrator: Displays the administrator assigned to this file system.

• Type: Displays the file system type.

4.7 Managing File Systems with File System Commands You use file system commands to manage file systems. You can use commands to:

• Export a file system view

• Update file system data

• Update capacity data for a file system

• Set this layout for file systems as the default view

• Update Folder Capacity

• Invoke a Custom Command

64

► To manage file systems with file system commands:

1. From the File System Commands Menu, select a command.

Figure4. 21 File System Commands Menu

2. Specify the file system command as described in the following sections.

4.7.1 Exporting a View Selecting Export View in the File System Commands menu will bring up the Export File from View dialog box.

Figure4. 22 Export File from View Dialog Box

The Export File From View dialog box is used to send the selected information to another destination, where it can be viewed or printed in another format: for example, a spreadsheet or text editor. The Export File From View dialog box comprises the following areas:

• Destination Path: The folder you would like to export the contents of the Visualizer to.

• File Name: The name of the exported file.

• Save as type: Select either Comma Separated Values (CSV), or Tab Separated. Ensure that the file extension in the File Name field is correct for this type.

• Include Headings as First Row: Select to use the column headings as the first row of the

65

view file.

• Delimiter: Click an option to select a delimiter type, either a comma or tab. This will affect the way your data appears.

• Which Rows to Export: Select the rows you wish to export, either All Rows, Only Revealed Rows, or Only Selected Rows.

Click Save to export the selected files.

66

4.7.2 Updating File Data The Update File Data command allows you to manually request that the server and space agent perform the same file data update as would be performed according to your schedule.

Selecting Update File Data may cause significant traffic on your network, and you will be asked to confirm which servers you wish to update, as shown in figure: Updating Server Capacity Data. Only the servers you highlighted in the Visualizer will be displayed. In the Verify Selected Servers window, select the servers you wish to update and click Begin.

Figure4 .23 Verify Selected Servers

4.7.3 Updating Folder Capacity Select the Update Folder Capacity from the File System Commands Menu to manually invoke a folder capacity update by the server and Space Agent.

The Update Folder Capacity command prompts you to confirm the servers to be updated, as shown in figure: Verify Selected Servers. Only the servers that were highlighted in the Visualizer are displayed. In the Verify Selected Servers dialog box, select the servers you wish to update, and click Begin.

4.7.4 Updating Capacity Data Select Update Capacity Data to refresh server capacity information. For detailed information about this command, see 4.10.4 Updating Server Capacity Data.

4.7.5 Invoke a Custom Command Select this command to choose a custom command to be invoked from the Custom Commands dialog. For information about custom commands, refer to Chapter 8: Using Custom Commands.

4.7.6 Setting a Default Layout If you have customized file system column displays using the Column Configurator and wish to save that configuration as the default display, select Set this layout as the default File Systems layout from the File Systems Commands menu. Every time you return to the Visualizer display for file systems, this default will be the first view for file systems that is displayed.

4.8 Viewing and Setting Options for Servers The Visualizer for servers and Detailer tabs for servers enable you to do the following:

• Display and filter servers across the network

• Set capacity thresholds for file systems

67

• Manage server data collection schedules

• Assign an Action Set to a server, or change the assigned Action Set. Figure4 .24 Servers Visualizer and Detailer

► To filter and manage servers:

1. Build a Show Statement to display servers in the Visualizer. Figure4 .25 Server Filters

You can display the following types of servers:

• servers named: Press ENTER or click outside the selection box to close the selection box.

• servers with current action set, with assigned action set: Click a selection from the list of action set names.

• servers with used space >, servers with used space <, servers with free space >, servers with free space <: Click on the numeric value to get an edit box and type in the desired value. Click on the units value to get a dropdown menu and choose between %, MB or GB.

• servers with OS type: Click the filter and then click an operating system type from the drop-down menu. Multiple types may be selected.

• servers with Administrator: Click on the filter and then select from the popup display of administrators known to the system.

68

NOTE

A scrollbar appears on the right of drop-down boxes whenever there are too many entries to display in the available space.

2. Click the Go button to initiate the server query.

4.8.1 Viewing Servers in the Visualizer The Visualizer for servers, as seen in figure: refer to “Figure4. 15 Servers Visualizer and Detailer”, provides the following information:

• Name: The server name.

• File System Over Threshold%: The threshold (in percentage terms) that has been set for this server.

• % Capacity Used: The percentage of the server’s total storage capacity that has been used.

• Storage Capacity: The total amount of space on the server that can be used.

• Used Capacity: The total amount of space used by this server.

• Threshold%: The threshold (in percentage terms) that has been set for this server.

• Operating System: The type of operating system working on this server.

Double-click a Server to Display File Systems You can double-click a server in the Visualizer to display the file systems on that server. The Show Statement will be updated to correctly reflect what is being shown.

4.8.2 Viewing Server Details and Setting Options The Details tab provides detailed information about the selected server. You use this tab to set capacity thresholds for file systems:

• Name: The name of the server that was last selected in the Visualizer.

• OS: The operating system of the server.

• Administrator: Select or change the administrator assigned to this server.

• Archive Server: Displays the name of the Archive server that is used for archiving, if any.

• File System Usage: The amount of space that has been used for file systems on this server, expressed in absolute, percentage and graphical terms.

• Server Usage: Displays usage information for the server.

• Prevent File Deletion: Check this box to prevent any files from being deleted on this server. This option prevents files from being deleted by Action Sets, custom commands or manual delete commands.

• Set capacity threshold for all file systems on server to: Select the amount of threshold capacity (in percentage terms) desired for all file systems on this server.

69

4.9 Scheduling Server Data Collection Use the Schedule tab for servers to view and set the data collection schedule for the selected server.

Figure4 .26 Schedule Tab for Servers

The Schedule tab for servers contains the following fields:

• Name: The name of the selected server.

• OS: The operating system of the server.

• Administrator: Select or change the administrator assigned to this server.

• Override Action Set Schedule for this Server: If no Action Set is active for the server, then this becomes the collection schedule for this server.

• Collection Type - Times: Specify the number of times per day/week/month that file,Folders,FileSystem data will be collected for this server (up to 4 times per day/week/month). Use the boxes that appear to set specific collection times.

• Collection Type - Frequency: Select or Enter an interval for collecting file system capacity information, from every 15 minutes to every 1440 minutes (24 hours), starting at the base date time specified. Select or Enter the intervals for collecting folder data information, from every 1 hours to every 96 hours, starting at the base date time specified. Select or Enter the intervals for collecting file data information, from every 1 day to every 90 days, starting at the base date time specified.

• Active Action Set Summary: Displays information about the action set that is active for this server.

• Change Active Action Set: Click an option to change the action set that is active for this server, or select None to switch to no action set for this server.

70

4.10 Managing Servers with Server Commands You use server commands to perform the following actions on servers:

• Export a server view to a file

• Update data for files on a server

• Update folder capacity data

• Update server capacity data

• View pending server updates

• Set the current column configuration as the default servers layout.

► To use server commands to manage servers:

1. Click on Server Commands to bring up the figure: Exporting a Server View. Figure4 .27 Server Commands Context Menu

2. Select the commands you wish to execute on the selected servers.

4.10.1 Exporting a Server View Selecting Export View in the Server Commands context menu will bring up the figure: Export File From View Dialog Box.

Figure4 .28 Export File From View Dialog Box

71

The Export File From View dialog box is used to export the currently revealed rows of the Visualizer to another file, where it can be viewed or printed in another format; such as a spreadsheet or text editor. The dialog box includes the following areas:

• Save In: Select the drop down box and choose a destination folder for placement of the export file.

• File Name: The name of the exported file.

• Save as type: Select either Comma Separated Values (.csv), or as a text file (.txt). Ensure that the file extension in the File Name field is correct.

• Include Headings as First Row: Select to use the column headings as the first row of the view file.

• Delimiter: Click an option to select a delimiter type, either comma or tab.

• Which Rows to Export: Select the rows you wish to export, either All Rows, Only Revealed Rows, or Only Selected Rows.

Click Save to export the selected files.

4.10.2 Updating File Data Use the Update File Data command as described in 4.3.6 Updating File Data.

4.10.3 Updating Folder Capacity Select the Update Folder Capacity from the Server Commands Menu to manually invoke a folder capacity update by the server and Space Agent.

The Update Folder Capacity command prompts you to confirm the servers to be updated, as shown in figure: Verify Selected Servers. Only the servers that were highlighted in the Visualizer are displayed. In the Verify Selected Servers dialog box, select the servers you wish to update, and click Begin.

4.10.4 Updating Server Capacity Data Select Update Capacity Data to refresh server capacity information.

► To update capacity data:

1. Select Update Capacity Data from the Server commands context menu. The Refresh Capacity Data screen appears.

Figure4 .29 Refresh Capacity Data Screen

2. Click Begin. The Capacity and File Data Status screen appears.

72

Figure4 .30 Capacity and File Data Status Screen

4.10.5 Viewing Pending Server Capacity Updates From the Server Commands Context Menu, select View Pending Updates to view the status of commands to refresh server capacity information. The status will appear as displayed in Figure4. 30: Capacity and File Data Status Screen.

4.10.6 Setting a Default Layout If you have customized column displays using the Column Configurator and wish to save that configuration as the default display, select Set this layout as the default Servers layout from the Server Commands Menu. Every time you return to the Visualizer display for servers, this default will be the first view for servers that are displayed.

4.11 Managing Database Utilization The Database Manager allows the user to view and manage database utilization across the network. Softek Storage Manager manages space utilization within databases, providing two levels of space management:

• Space in individual databases

• Space in the tablespaces that comprise the database

Softek Storage Manager also manages space utilization in database data files, log files and control files.

NOTE

The Oracle client must be installed on the Storage Management Server in order for users to see Oracle database information. Some basic configuration must have been done during installation. For information see the Softek Storage Manager Installation Guide 2.3 (ML-1445028).

NOTE

For Symfoware databases, the DSI space utilization within the tablespaces can be viewed in the Tablespace View of the Softek Storage Manager Console.

4.11.1 Creating a Database Action Set For information about creating an Action Set for a database, see 5.8 Previewing Action Results.

73

4.11.2 Viewing Database Information in the Visualizer The Visualizer for databases displays all databases known to the system. Databases can be filtered by database names, instance names and database server names.

Figure4 .31 Visualizer Tab for Databases

The Visualizer provides the following information for each database:

• Name: The name of the database.

• Instance: The name of the Instance, to which the database belongs.

NOTE

In case of Microsoft SQL and Symfoware databases, the default instance will be displayed as “<default>”

• Database Server: The name Softek Storage Manager uses for the managed database server. This can be different from the actual server name.

• Tablespaces Over Threshold: The number of tablespaces in the database that exceed the specified threshold. This threshold is defined once for all tablespaces in the database in the Details panel for the database.

• Total Size: Total size of the database.

• Used: The amount of database space used by tablespaces.

• Free: The amount of free tablespaces in the database.

• Other: The amount of space used by files other than tablespaces: for example, system files.

• % Capacity Used: The percentage of tablespaces space that is already used.

• Threshold%: Indicates the percentage of the storage threshold that has been used.

• Type: Indicates the type of database server.

NOTE

If any column information is not available for a particular row in the visualizer, the column value for that row will be blank.

74

4.11.3 Viewing Database Details You use the Details tab for a database to view detailed information about database space utilization.

Figure4 .32 Details Tab for a Database

The Details tab for a database provides the following information and options:

• Name: The name of this database, according to its database server.

• Global Name: The full name of the database, which uniquely identifies it from any other database.

• Instance: The name of the instance, to which the database belongs.

• Database Server: The name Softek Storage Manager uses for the server where the database is located. This can be a name that is different than the actual database server name.

• Database Type: Supported database engines, such as Oracle 8i, Oracle 9i.

• Database Version: The database engine version.

• Administrator: The name of the administrator assigned to this database.

• Tablespace Usage: Indicates tablespace usage statistics for the database, in absolute, percentage and graphical displays.

• Database Usage: Indicates the percentage of database capacity that has been used, in absolute and graphical displays.

• Creation Date: The date this database was created.

• Data Collected: Displays the date and time that data was last collected for the database.

• Uses archive log: Indicates whether the database archives redo logs. The log location is displayed in the Active Log Files area on this tab. This is a read-only status field for information purposes—it cannot be modified from this screen.

• Set Capacity Threshold for all Tablespaces on Database to: Select a threshold for all tablespaces on the database.

NOTE

Any information which is not available will be displayed as “-NA-“

75

4.12 Scheduling Database Data Collection You use the Schedule tab to schedule the collection of configuration data for a database.

Figure4 .33 Schedule Tab for a Database

View or specify information on the Schedule tab:

• Global Name: The full name of the database, which uniquely identifies it from any other database.

• Administrator: The name of the database administrator.

• Server Type: The type of server where the database is located.

• Server Version: The server version where the database is located.

• Active Action Set Summary: Displays the collection interval for the database.

• Change Active Action Set: Change the Action Set that is active for this database.

76

4.13 Managing Databases with Database Commands You use database command – Database Update for updating database information:

► To use the database update command:

1. Click on Database Commands. Figure4. 34 Database Commands Context Menu

2. Select the Database Update command to execute on the selected databases.

3. The Refresh Database Data screen appears. Only the unique database servers that were highlighted in the Visualizer are displayed. Select the database servers you wish to update, and click Begin.

Figure4. 35 Refresh Database Data Screen

77

4. The Command Status screen appears. Figure4. 36 Capacity and File Data Status Screen

78

4.14 Viewing Server Information and Selecting an Administrator

You use the Server tab to view information about the server that contains the database, and select a database administrator.

Figure4. 37 Server Tab for a Database

View information or select options on the Server tab:

• Server Name: The name Softek Storage Manager uses for the server containing the database.

• Administrator: Select an administrator for the database server.

• Server Type: The type of server where the database is located.

• Server Version: The server version where the database is located.

• Time of Collection: The date and time the database information was last collected.

79

4.15Viewing Tablespace Information The Visualizer for Tablespaces displays all the tablespaces for a selected database. Tablespaces can be filtered by tablespace names, database names, instance names and database server names.

Figure4. 38 Visualizer Tab for Tablespaces

► To view tablespace information for a database, build a Show Statement to display tablespaces for a database.

The Visualizer provides the following information for each tablespace:

• Name: The tablespace name.

• Database: The name that Softek Storage Manager uses for the database that contains the tablespace.

• Instance: The name of the instance to which the tablespace belongs.

• Database Server: The name that Softek Storage Manager uses for the server that contains the database.

• Used Space: The space of the tablespace allocated to database objects.

• Capacity: The capacity of the tablespace.

• % Used: The percentage of the tablespace capacity that has been used.

• Threshold%: The tablespaces whose percent used is over this threshold will be shown in red.

• Type: Displays the type of database that contains the tablespace.

• Version: Displays the database version that contains the tablespace.

80

4.16 Viewing Tablespace Details Figure4. 39 Details Tab for a Tablespace

The Details tab for a tablespace provides detailed information about tablespace space utilization:

• Name: The name of the tablespace.

• Read Only: Indicates whether the tablespace is in read only mode.

• Default: Indicates whether this is a default tablespace for data objects.

• System: Indicates whether the tablespace is a SYSTEM tablespace.

• User Defined: Indicates whether this is a user-defined tablespace.

• Online: Indicates whether the tablespace is online.

• Temporary: Indicates whether the tablespace is temporary.

• Administrator: Indicates the administrator assigned to the database where the tablespace is located.

• Tablespace Usage: Indicates the percentage of the tablespace capacity that has been used.

• Database: Indicates the name of the database where the tablespace is located.

• Instance: The name of the instance to which the tablespace belongs.

• Database Server: The name that Softek Storage Manager uses for the server that contains the tablespace.

• Database Server Type: Indicates the type of database server where the tablespace is located.

• Log Group: The Log group that the tablespace is using.

• Date Collected: Indicates the last time data was collected for the tablespace.

NOTE

The detailer view shown in the figure above is displayed for Oracle and Microsoft SQL tablespaces. If the tablespace selected in the Visualizer belongs to a Symfoware database, the DSI usage for that tablespace is also displayed in the detailer in addition to the information shown in the figure above. For more information on this refer section 4.17.

4.17 Viewing DSI Information for Symfoware

The DSI information is shown in the Details Tab of the Tablespace View. The information is shown only when the user clicks on a Symfoware tablespace in the Visualizer.

81

Figure4. 40 DSI Information in the tablespace details tab

In case of Symfoware tablespaces, additional information related to DSI’s is displayed in the details tab.

Set capacity threshold for all DSI’s on Tablespace to: Select a threshold for all DSI’s on the tablespace.

DSI Usage: Indicates DSI usage statistics for the DSI, in absolute, percentage and graphical displays.

An empty circle before the DSI name indicates it’s a “Static” DSI, while a dark circle before a DSI name indicates it’s a “Dynamic” DSI.

A “*” after the DSI usage indicates the DSI is allocated on multiple tablespaces.

4.18 Viewing Database Files Softek Storage Manager displays space utilization of 3 types of database files

Data files

Control files

Log files (Transaction log files and Archive log files)

To view information about a particular type of database file, choose the appropriate database file type filter as shown in the figure below.

Figure4. 41 Database file type filter

All 3 types of database files can be filtered by database names, instance names and database server names. In addition data files can also be filtered by tablespace name.

The following files are monitored by Database Manager.

File type Microsoft SQL Oracle Symfoware

Data files .mdf, .ndf .dbf Database space files

Control files -NA- .ctl DIR_FILE1, DIR_FILE2, DIR_FILE

Log files .ldf Redo log files Archive log files

82

NOTE

In order to monitor the space usage of Oracle redo log files, the Oracle database to be monitored should be configured with the ‘SYS’ user in the ‘DB Server’ tab of the ‘Options’ dialog. The redo log files can be monitored only as SYS user with SYSDBA or SYSOPER role. To enable to connect as SYSDBA or SYSOPER roles, the parameter ‘O7_DICTIONARY_ACCESSIBILITY’ should be set to ‘TRUE’ in the init.ora file of the Oracle database. The database has to be restarted after setting this parameter. Setting of this parameter allows to login as SYS user with SYSDBA permissions to collect the redo log files information. Please refer the Oracle database security guide for the security issues related to setting of this parameter. Please refer the Installation guide, Appendix C3 for steps to set the above parameter.

The Visualizer for database files displays all files for a selected database.

► To view database file information: 1. Build a Show Statement to display database files. All database files of selected type are

displayed for the tablespaces, databases, instances or database servers you choose in the filters.

Figure4 .42 Visualizer tab for Data files

Figure4 .43 Visualizer tab for Control files

83

Figure4 .44 Visualizer tab for Log files

The Visualizer provides the following database file information:

• Name: The name of the database file.

• Tablespace: The name of the tablespace associated with the database file.

NOTE

The tablespace name will not be displayed in case of control files, Oracle log files and Microsoft SQL log files.

NOTE

In case of Symfoware log files, each log file can be associated with more than one tablespace. In this case a comma separated list of tablespaces will be shown in the visualizer in the format <database-name>.<tablespace-name>

• Database: The name of the database associated with the database file.

NOTE

The database name will not be displayed in case of Symfoware control files and log files.

• Instance: The name of the instance to which the database file belongs.

• Database Server: The name of the database server associated with the database file.

• Used Space: The space used by the database file.

• Allocated Size: The space allocated by the database in the database file.

• Date Created: The date the database file was created.

84

• Date Last Modified: The date and time the database file was last modified.

• Full Path: The full path of the database.

• File Extension: The file extension.

• Read Only: Indicates whether the file is read only.

• Type: The type of database server to which the database file belongs.

4.19 Viewing Database Files Details

The Details tab for a database file provides detailed information about the last file that was selected in the Visualizer.

Figure4 .45 Details tab for a Microsoft SQL Data file

Figure4 .46 Details tab for an Oracle Data file

Figure4 .47 Details tab for a Symfoware Data file

85

Figure4 .48 Details tab for an Oracle Control file

Figure4 .49 Details tab for a Symfoware Control file

Figure4 .50 Details tab for a Microsoft SQL Log file

Figure4 .51 Details tab for an Oracle Log file

86

Figure4 .52 Details tab for a Symfoware Log file

The Details tab for a database file provides the following information and options:

• Database File Name: The fully-qualified path of the database file.

• Type of File: The type of database file – DB Data file, DB Control file, DB Log file or DB Archive Log file.

• System, Needs Recovery, Read Only, Online or Auto extensible indicate the properties of the database file.

• Instance: The name of the instance to which the database file belongs.

• Log Group: The log group to which the database file belongs.

NOTE

The log group name will not be displayed in case of Microsoft SQL database files and Oracle control files.

• Database: The name of the database associated with the database file.

• Tablespace(s): The name of the tablespace(s) associated with the database file.

NOTE

In case of Symfoware log files, each log file can be associated with more than one tablespace. In this case a list of tablespaces is shown in the detailer in the format <database-name>.<tablespace-name>

• Used Space: The actual size of the database file.

• Allocated Space: The space allocated by the database in the database file.

87

• Maximum Size: The maximum size of the database file. This value may be different than the allocated space size.

• Increment: If the file is auto extensible, this is the increment by which the file would be expanded when “allocated” needs to get bigger than “size.”

• Date Created: The date and time the database file was created.

• Online: The date and time the database file went online.

• Date Collected: Indicates the date and time data were first collected for the database file.

• Date Last Modified: Indicates the date and time when the database file was last modified.

88

5

Creating Action Sets

• 5.1 Accessing the Action Sets Function 91

• 5.2 Using Action Sets to Manage Servers 91

• 5.3 Creating an Action Set 92

• 5.4 Setting up a Data Collection Schedule for an Action Set 93

• 5.5 Assigning an Action Set 95

• 5.6 Defining Actions for an Action Set 96

• 5.7 Defining Parameters for an Action Set Export File 102

• 5.8 Previewing Action Results 102

• 5.9 Overriding an Action Set for a Server 106

• 5.10 Refresh the list of servers on Action Set – Assignments Tab 107

89

90

Action Sets provide an automated way to manage space utilization across the network. You can create Action Sets that will automatically delete and archive files or issue alerts whenever capacity conditions are met. You can apply an Action Set to a server, a group of servers, a database server or a group of database servers. Action Sets can automatically do all of the following:

• Manage files by automatically deleting files, archiving files and archiving folders on designated servers or server groups.

• Issue automatic email alerts whenever capacity conditions are met.

• Manage space utilization on databases, tablespaces, database files and DSI’s (only in case of Symfoware DB servers).

5.1 Accessing the Action Sets Function

► To access the Action Sets function: • Open the Action Sets icon from the Space Optimizer section of

the Launch Bar.

5.2 Using Action Sets to Manage Servers You can create Action Sets that will automatically perform any of the following actions on servers or server groups:

• Delete files

• Archive files

• Archive folders

• Archive and delete files

• Notify the server’s administrator or group’s administrator about storage conditions

• Export action set results to a file

• Send the message to event log if threshold limit is crossed for File Systems, Folders, Databases, Tablespaces, Database files or DSI’s

• Execute custom commands.

For database servers, the only valid actions are Notify, Export and Event Logging.

All changes are local, in memory, until you click the Save & Deploy button. Then, the database is updated. Actions are not saved until you click Save & Deploy.

NOTE

You always have the option to override an Action Set that has been assigned to a server or individual server within a group assigned to the Action Set. For details about how to override an Action Set for an individual server, see 5.9 Overriding an Action Set for a Server.

91

When do Action Sets take effect? You set options to determine whether an Action Set is implemented when file system storage capacity is updated, or when file data are updated. You set the timing options for each action set on the Details tab for Action Sets, or on the Schedule tab in the Servers display. For more information about the Details tab for Action Sets, see 5.4 Setting up a Data Collection Schedule for an Action Set.

File system capacity is updated frequently, at intervals typically ranging from 15 minutes to 1440minutes (24 hours). When file system capacity information is updated, information about each file system’s used space and free space is updated, but information about specific files is not updated.

5.3 Creating an Action Set To create a new Action Set and assign it to servers, you use the three tabs of the Detailer for Action Sets:

• Details

• Assignments

• Actions Figure5. 1 Actions Sets Visualizer and Detailer

To create an Action Set:

92

1. From the Action Sets toolbar, select New Action Set.

2. Select Server or Database to indicate whether the Action Set is being created for a server or database. An untitled Action Set appears, highlighted in the Visualizer.

3. On the Details tab, provide a name and specify attributes for the Action Set as described in 5.3 Setting up a Data Collection Schedule for an Action Set.

4. On the Assignments tab, assign the Action Set to servers as described in 5.5 Assigning an Action Set.

5. On the Actions tab, set up the actions that the Action Set will automatically execute as described in 5.6 Defining Actions for an Action Set.

5.4 Setting up a Data Collection Schedule for an Action Set For Server Action Sets, use the controls on the Details tab to name the Action Set and set up a data collection schedule for the files and file systems that are assigned to the Action Set.

Figure5. 2 Server Action Sets Detailer Tab

• Action Set: Enter a name for the new Action Set.

• Action Set Execution: Select Enabled or Disabled to enable or disable this particular Action Set on all servers it is attached to. This option acts as a global “on/off” toggle switch for this action set.

NOTE

An action set must be both Active (on the Assignments tab) and Enabled to execute and perform actions.

93

TIP

The Enabled/Disabled option can be used to skip the evaluation of a particular rule. This can be particularly useful while new rules are being developed and tested.

• File System Capacity Collection Type : Specify the way in which file system information should be collected

• Time : When this option is checked, then specify the number of times per day/week/month (up to four times a day/week/month) and at what times every day/week/month file system information should be collected. The values for “Day Of Week” range from “Sunday” to “Saturday”.The values for “Day Of Month” are from 1-31 and “Last” (last day of the month).You can also disable the schedule for collection of file system information.

• Frequency: When this option is checked select or enter the intervals for collecting file system capacity information, from every 15 minutes, to every 1440 minutes (24 hours), starting at the base date time specified.”Every 15 minutes” is selected by default for Capacity Update.

• Folder Capacity Collection Type: Specify the way folder information should be collected .

• Time : When this option is checked, then specify the number of times per day/week/month (up to four times a day/week/month) and at what times every day/week/month folder information should be collected. The values for “Day Of Week” range from “Sunday” to “Saturday”.The values for “Day Of Month” are from 1-31 and “Last” (last day of the month).You can also disable the schedule for collection of folder information. The “disable” option is selected by default for folders.

• Frequency: When this option is checked select or enter the intervals for collecting folder data information from every 1 hours to every 96 hours, starting at the base date time specified.

• File Data Collection Type: Specify the way file information should be collected

• Time : When this option is checked, then specify the number of times per day/week/month (up to four times a day/week/month) and at what times every day/week/month file information should be collected. The values for “Day Of Week” range from “Sunday” to “Saturday”.The values for “Day Of Month” are from 1-31 and “Last” (last day of the month).You can also disable the schedule for collection of file information. The option “1 time per day” is selected by default for files.

• Frequency: When this option is checked Select or enter the intervals for collecting file data information, from every 1 day to every 90 days, starting at the base date time specified.

• Notes: Enter free-form notes about this action set.

94

For Database Action Sets, use the controls on the Details tab to name the Action Set and set the Action set state to enabled or disabled.

NOTE

A schedule cannot be set for a Database Action Set. Database Action Sets are executed depending on the Data Collection Interval for a database server, which is set from the ‘DB Server’ tab of the ‘Options’ dialog, in the ‘Configuration’ menu.

Figure5. 3 Database Action Sets Detailer Tab

• Action Set: Enter a name for the new Action Set.

• Action Set Execution: Select Enabled or Disabled to enable or disable this particular Action Set on all servers it is attached to. This option acts as a global “on/off” toggle switch for this action set.

• Notes: Enter free-form notes about this action set.

5.5 Assigning an Action Set Use the Assignments tab for Action Sets to assign servers, server groups, database servers and database server groups to an Action Set. Select objects from the lists on the left, and use the Add/Remove buttons to add them to the assignments list on the right.

Figure5. 4 Assignments Tab for Action Sets

95

• Active Action Set: Displays the action set that is currently active for this server, server group,

database server or database server group.

NOTE

Only one Action Set can be active at a time for a server, server group, database server or database server group.

• Set as Active: Check this option to make the action set active for this server, server group,

database server or database server group.

NOTE

More than one Action Set can be assigned to a server, but a server or group can have only one Action Set as the active action set at any particular point in time. An Action Set can be active for multiple servers. An action set must be both active and enabled (on the Details tab for Action Sets) to execute and perform actions.

5.6 Defining Actions for an Action Set Use the Actions tab for Action Sets to set rules for the actions that will be taken automatically. You can specify actions to take place when file system capacity information is updated, or when file information is updated, or folder capacity information is updated.

NOTE

Use the red (x) button to delete the selected action. A selected action displays a highlighted blue bar on the left side.

Available actions vary, depending on whether you are selecting actions for a server or database action set:

• Perform these actions at Capacity update: Select actions in this area to be performed when capacity information is updated for the server.

• Perform these actions at File data update: Select actions in this area to be performed when file data is updated for the server.

• Perform these actions at Folder capacity update: Select actions in this area to be performed when folder capacity is updated for the server.

• Perform these actions at Database configuration update: Select actions in this area to be performed when database data is updated for the database server.

NOTE

File system capacity is updated frequently, at intervals typically ranging from 15 minutes to 1440 minutes ( 24 hours). At Capacity update time, information about each file system’s used space and free space is updated, but information about specific files is not.

96

Figure5 .5 Actions Tab for Server Action Sets

Figure5 .6 Actions Tab for Database Action Sets

97

5.6.1 Perform these actions at capacity/database data update

Select actions in this section to be performed automatically at file system capacity update. Use the blue plus sign (+) controls to add additional file systems or additional actions to be performed on those file systems. The available actions vary, depending on the type of action set.

• On all file systems: From the drop-down arrow list, select filters to indicate the file systems you are assigning the action set to. You can add filters to further refine the conditions that must be met for this action set to be performed.

• Notify/Export: Select an action or custom command from the drop-down list.

Notify/Export generates an email alert and/or event log alert and/or exports results of the action set to a file, when rule conditions are met, without taking any action on the files themselves. The Send alert box must be checked for the email notification to take place.The Send to Event Log box must be checked for the event log notification to take place.

For information about custom commands, please refer to Chapter 8: Using Custom Commands. Custom Commands are not applicable for Database Action Sets.

NOTE

For a Database Action Set, both the administrator of the database and the default administrator will be notified about the execution of the Action Set. The database administrator is defined on the Options Dialog – DB Server tab for a database. Until a database administrator is defined, the default administrator is notified.

• Untitled: Type over this field to name the action. Naming each action within an action set

can help interpret the log following an action set execution.

• Action is disabled: Select enabled or disabled in order to activate or deactivate this action within the action set. This option is useful when testing action sets—you can toggle on and off individual actions within the rule.

• Export Results: Check this box if you want to export the results of the action set to a file. Each Action Set can have its own export definition. The action results are exported in XML, CSV or HTML format, and it is stored on the SMS server.

• Send to Event Log: Check this box if you want to send a message to event log when filesystem capacity or tablespace capacity crosses the threshold limit set in the rule condition. “Send to Event Log” is also applicable for other rule conditions apart from threshold.

• Parms: Click this button to provide a path name and specify an export style sheet on the Define Export Results Parameters dialog box. If the export directory name is blank and style sheet fields is not selected, Softek Storage Manager exports the results in XML format. The export file is created in the path InstallDrive\ServerName, where InstallDrive is the drive on which Softek Storage Manager is installed and ServerName is the Server for which the action is executed.

NOTE

This path name is accessible only from the machine where the Action Set is processed. It must be manually entered.

98

Figure5. 7 Define Export Results Parameters Dialog Box

• Send alert: Select this option to send alerts to the identified subscribers, in the groups that a server belongs to, if any. If there are no subscribers, the alert is sent to the server’s administrator. Softek Storage Manager sends alerts once every 12 hours for a space problem on a single application server. If the alert has been sent once in the intervening 12 hours it will not be sent again

!

CAUTION: Modifying an individual action within an action set will not disable the entire action set. However, the individual action you are modifying will be automatically disabled.

5.6.2 Perform these actions at File data update: The available actions vary, depending on the type of Action Set.

• On all file systems: From the drop-down arrow list, select filters to indicate the file systems you are assigning the action set to. You can add filters to further refine the conditions that must be met for this action set to be performed.

• Notify/Export: Select an action or custom command from the drop-down list.

Notify/Export generates an email alert and/or event log alert and/or exports results of the action set to a file, when rule conditions are met, without taking any action on the files themselves. The Send alert box must be checked for the email notification to take place.The Send to Event Log box must be checked for the event log notification to take place.

Selecting Archive files archives the files satisfying the rule condition.

Selecting Delete files deletes the files satisfying the rule condition.

Selecting Archive and Delete files archives and deletes the files satisfying the rule condition.

For information about custom commands, please refer to Chapter 8: Using Custom Commands.

• Select Directories: Select which directory or directories will be affected by this rule.

NOTE

Directories must be followed by an asterisk (*) in order to include subdirectory files in the action set. Directories without an asterisk will result in an exact match on the directory name. Only forward slashes (/) can be used to separate directories in a path.

• Files with these attributes: Select the types of files to be included in this rule.

99

• Untitled: Type over this field to name the action. Naming each action within an action set can help interpret the log following an action set execution.

• Action is disabled: Select enabled or disabled in order to activate or deactivate this action within the action set. This option is useful when testing action sets—you can toggle on and off individual actions within the rule.

• Export Results: Export the results of this action to an export file.

• Send alert: Select this option to send alerts to the identified subscribers, in the groups that a server belongs to, if any. If there are no subscribers, the alert is sent to the server’s administrator. The notify mail is sent only once in every 12 hours. If the mail has been sent once in the intervening 12 hours it will not be sent again.

• Preview Action Results: Click on the Preview Action Results button to display the Preview Action Set Results dialog box. This field does not apply to Database Action Sets.

5.6.3 Perform these actions at Folder capacity update: The available actions vary, depending on the type of Action Set.

• On all file systems: From the drop-down arrow list, select filters to indicate the file systems you are assigning the action set to. You can add filters to further refine the conditions that must be met for this action set to be performed.

• Notify/Export: Select an action or Custom Command from the drop-down list.

Notify/Export generates an email alert and/or event log alert and/or exports results of the action set to a folder, when rule conditions are met, without taking any action on the folders themselves. The Send alert box must be checked for the email notification to take place.The Send to Event Log box must be checked for the event log notification to take place.

Selecting Archive folders archives the folders satisfying the rule condition.

For information about custom commands, please refer to Chapter 8: Using Custom Commands.

• Folder with these attributes: Select the types of folders to be included in this rule.

• Untitled: Type over this field to name the action. Naming each action within an action set can help interpret the log following an action set execution.

• Action is disabled: Select enabled or disabled in order to activate or deactivate this action within the action set. This option is useful when testing action sets—you can toggle on and off individual actions within the rule.

• Export Results: Export the results of this action to an export file.

• Send alert: Select this option to send alerts to the identified subscribers, in the groups that a server belongs to, if any. If there are no subscribers, the alert is sent to the server’s administrator. The notify mail is sent only once in every 12 hours. If the mail has been sent once in the intervening 12 hours it will not be sent again.

• Send to Event Log: Check this box if you want to send a message to event log when folder capacity crosses the threshold limit or when rule conditions are met. “Send to Event Log” is also applicable for other rule conditions apart from threshold.

• Preview Action Results: Click on the Preview Action Results button to display the Preview Action Set Results dialog box. This field does not apply to Database Action Sets.

100

5.6.4 Perform these actions at Database Configuration update: Select the type of databases on which the Action set will apply from the drop down menu

“On Databases of Type”. Select “All” if the Action set is to be applied to all available database types.

Figure5. 8 Database Action Sets – Database type filter

The available actions vary, depending on the type of Action set. To create an Action set on

tablespaces or database files, select the type of action from the “Action on” drop down box. Figure5. 9 Database Action Sets – Action on filter

NOTE

One segment of an action set can be used to set actions on either tablespaces or database files. In order to set actions on both tablespaces and database files in the same action set, add another segment to the action set by clicking on the blue plus (+) sign and choosing the appropriate action type.

• On all tablespaces: From the drop-down arrow list, select filters to indicate the tablespaces you are assigning the action set to. You can add filters to further refine the conditions that must be met for this action set to be performed.

• On all files: From the drop-down arrow list, select filters to indicate the database files you are assigning the action set to. You can add filters to further refine the conditions that must be met for this action set to be performed.

• Notify/Export: Selecting Notify/Export causes an email alert and/or event log alert to be generated and/or exports results to a file, if the rule conditions are met. The Send alert box must be checked for the notification to take place.The Send to Event Log box must be checked for the event log notification to take place.

NOTE

For a Database Action Set, only Notify/Export is available.

• Untitled: Type over this field to name the action. Naming each action within an action set can help interpret the log following an action set execution.

• Action is disabled: Select enabled or disabled in order to activate or deactivate this action within the action set. This option is useful when testing action sets—you can toggle on and off individual actions within the rule.

• Export Results: Export the results of this action to an export file.

101

• Send alert: Select this option to send alerts to the identified subscribers, in the groups that a server belongs to, if any. If there are no subscribers, the alert is sent to the server’s administrator. The notify mail is sent only once in every 12 hours. If the mail has been sent once in the intervening 12 hours it will not be sent again.

• Send to Event Log: Check this box if you want to send a message to event log when tablespace capacity crosses the threshold limit or when rule conditions are met. “Send to Event Log” is also applicable for other rule conditions apart from threshold.

NOTE

If the selected database type is “Symfoware”, actions can be set on DSI’s in addition to actions on tablespaces. By default the DSI attribute filter will be <Disable>.In this case the action will be executed on a tablespace. If the action has to be executed on a DSI you can select the filter options from DSI Attribute window. After selecting a DSI attribute filter, if you want to execute an action on a tablespace delete all the DSI attribute filters for the action rule. After deletion the default DSI attribute filter i.e <Disable> will be displayed

Figure5 .10 DSI Action Sets

NOTE

Actions can be set on Data files, Control files and Log files.

5.7 Defining Parameters for an Action Set Export File You can export the results of an Action Set to an export file. You define parameters for the export file in the Define Results Parameters dialog box as shown in figure5.7: Define Export Results Parameters Dialog Box. You access the dialog box by clicking Parms from the Actions tab for Action Sets.

• Export Directory Name: Enter a directory name for the exported file. This path name is accessible only from the machine where the Action Set is processed. You must manually enter the directory path name. If the export directory name is blank and style sheet fields is not selected, Softek Storage Manager exports the results in XML format. The export file is created in the path InstallDrive\ServerName, where InstallDrive is the drive on which Softek Storage Manager is installed and ServerName is the Server for which the action is executed.

• Export Style Sheet: Select a style sheet for the exported file.

• Edit Custom Command/Custom Command Context: Click this button to invoke a custom command following an Action Set Export as described in 8.8 Invoking a Custom Command Following an Action Set Export.

5.8 Previewing Action Results When you check Preview Action Results when executing an action set, the Preview Action Results screen appears. This screen displays the results of an Action Set Execution in test

102

mode. If no server has previously been selected, the Select Server tab appears on top.

Figure5. 11 Preview Action Results for Files: Select Server Tab

Figure5 .12 Preview Action Results for Folders: Select Server Tab

103

► To preview an action result: • Select a server, and click GO.

When a query is complete, the Results tab appears.

Figure5 .13 Preview Action Results for Files: Results Tab

104

Figure5 .14 Preview Action Results for Folders: Results Tab

NOTE

The Preview Action results screen is not available for Database Action Sets.

105

5.9 Overriding an Action Set for a Server You can override an Action Set for a server. You can also override an Action Set for an individual server within a group that has been assigned to an Action Set. By overriding an Action Set for a server within a group, you can keep the server as a member a group, but not have it be subject to the group’s Action Set. By doing so, you can allow a server to be a member of multiple groups, but still point to only one Action Set.

► To override an Action Set for a server: 1. Create a Show Statement to display servers in the Visualizer, and then select the server.

2. Select the Schedule tab. Figure5.15 Schedule Tab for Servers

3. In the Server Override Schedule area, check Override Action Set for this Server.

Checking this option will override any Action Set that is active for this server. If the server is a member of a group, this option will override any Action Set that the group is assigned to, for this server.

NOTE

Database Action Sets cannot be overridden.

106

5.10 Refresh the list of servers on Action Set – Assignments Tab

The list of Servers is displayed on Action Set – Assignments Tab , for assigning the servers to an action set. In case of database action sets list of database servers is listed on Action Set – Assignments tab.

Whenever a new agent machine gets connected to SSM Server, the server list on assignments tab does not contain the newly added server. Similarly when a new database server is added the newly added database server is not listed in database server list on assignments tab.

To get the server list and database server list on action set assignments tab , a new menu item “Refresh” is added on SSM console. Refresh menu item will be enabled only when Action Sets Tab is active. For all other tabs the Refresh menu item will be disabled.

Figure5.16 Refresh Menu

To Refresh the list of servers and Database servers on assignments tab :

1. From the View Menu, Click Refresh .

2. If action sets assignment tab is already the active window, then click on any name in Server s/Database servers list on the assignments tab.The new servers/database servers will be shown on the servers/Database servers list.

3. If action sets assignment tab is not active, then click on assignments tab. The new servers/database servers will be shown on the servers/Database servers list on assignment tab.

107

108

6

Viewing Action Logs

• 6.1 Viewing Logs 111

• 6.2 The Visualizer for Logs 111

• 6.3 Detailer for Logs 112

• 6.4 Setting Log Data Retention Options 113

109

110

The Logs tab allows you to view log entries generated by the execution of an Action Set and Command history.

6.1 Viewing Logs

► To view Logs:

• Click the Logs icon in the Space Optimizer section of the Launch Bar. The application window for logs appears.

Figure6. 1 Logs Visualizer and Detailer

6.2 The Visualizer for Logs The following fields are shown in the Visualizer for Logs:

• Execution Date/Time: The date and time this Action Set or Command executed.

• Server: The name of the server affected by this Action Set or Command.

• Action: The action or command that was executed on this server.

• Completion Status: Indicates whether the Action Set or Command is completed.

• Trigger: Indicates the catalyst for the Action Set or Command execution (for example, File Data Update). For Commands trigger field is shown as ‘Schedule’ for scheduled commands and for the commands executed manually trigger filed is shown as ‘Command’.

• Initiator: Indicates the Action Set name or Administrator that implemented this action or command. For Commands executed from ‘Server Override Schedule’,Initiator is blank.

• Rule Name: The name of the action set rule (set in the Actions tab for Action Sets) for this log entry. For Commands Rule Name is not applicable.

111

6.3 Detailer for Logs Figure6. 2 Logs Details Tab

The appearance of the Details tab for logs varies with the type of action that has been logged. In figure: Logs Details Tab, the screen provides log information for an Action Set:

• Execution Date/Time: The date and time this Action Set or Command executed.

• Server: The name of the server affected by this Action Set or Command.

• Action: The action or command that was executed on this server.

• Trigger: Indicates the catalyst for the Action Set or Command execution (for example, File Data Update). For Commands trigger field is shown as ‘Schedule’ for scheduled commands and for the commands executed manually trigger filed is shown as ‘Command’.

• Initiator: Indicates the Action Set name or Administrator that implemented this action or command. For Commands executed from ‘Server Override Schedule’, Initiator is blank.

• Action Set: This area displays the Action Set name, rule name, and filters for the Action Set. For Commands associated with action set this area is not displayed, since Action rule name and filter description are not valid for Commands.

• Full path and file name: Displays the full path and name of the file that was affected by the Action Set.

• Status: Indicates whether the Action Set or Command successfully completed.

112

6.4 Setting Log Data Retention Options You use the Options: Storage Data tab to set the number of days to retain log information.

Figure6 .3 Options: Storage Data Tab

In the Days - Command and Action Set Execution History area, specify the number of days to retain a history and log of commands executed by Softek Storage Manager.

113

114

7

Managing Groups

• 7.1 Overview 117

• 7.2 Defining a New Group 118

• 7.3 Configuring a Group 118

• 7.4 Managing Group Members 119

• 7.5 Managing Group Subscribers 120

• 7.6 Assigning an Action Set to a Group 121

• 7.7 Overriding an Action Set for a Server Within a Group 122

115

116

A Storage Administrator can be responsible for managing files, folders and databases created by thousands of users and hundreds of applications. Softek Storage Manager enables you to manage these storage objects more efficiently by organizing them into server groups and database server groups (DB Server Groups).

7.1 Overview Server Group : A server group is a collection of servers that can be treated in the same

way, helping you manage them more easily. An example of a server group would be: My Important Servers. You can use server groups to manage servers by consolidating storage resources into manageable chunks. Using server groups reduces your workload by letting you modify storage attributes in one place; those changes are then automatically propagated to multiple volumes or servers. To take advantage of the grouping feature, you create a server group using the Groups tab, and then assign an Action Set to the server group. By default, servers added to a server group inherit the action set of the server group, so they will all behave the same way in terms of automated actions and data collection times. A server group can contain servers, or it can contain other server groups.

DB Server Group : A DB Server group is a collection of database servers that can be treated in the same way, helping you manage them more easily. An example of a DB Server group would be: My Important Database Servers. To take advantage of the grouping feature, you create a DB Server group using the Groups tab, and then assign an Action Set to the DB Server group. By default, database servers added to a DB Server group inherit the action set of the DB Server group, so they will all behave the same way in terms of automated actions and data collection times. A DB Server group can contain database servers, or it can contain other DB Server groups.

Figure7 .1 Groups Visualizer and Detailer

Some of the advantages of using groups in Softek Storage Manager include the following:

• You can set up action sets to act on groups, rather than one server or database server at a time. Setting up action sets on a group level saves time and effort.

• Using groups allows easy consolidation of data for reporting purposes and e-mail alerts.

117

7.2 Defining a New Group ► To define a new group:

1. From the Groups toolbar, select New Group.

2. Select “Server” or “Database” to create a Server Group or a DB Server Group. 3. Use the controls on the Details tab to name the new group and assign it to an administrator.

4. Use the controls on the Members tab to add and remove members of a group.

5. Use the controls on the Subscribers tab to add or delete subscribers.

7.3 Configuring a Group Use the Details tab for groups to define a new group, assign the group to an administrator, and view details about the group.

Figure7. 2 Details Tab for Groups

• Name: Enter the name of the group.

NOTE

Softek Storage Manager reports can display the following special characters used in group names: ! @ # $ % * ( )

• Administrator: Select the name of an administrator to assign to the group.

• Notes: Enter free-form notes about this group.

• Members: Lists the members of this group (group members are selected on the Members tab).

• Alert: The alert box is checked if the subscriber is set up to receive an alert (The alert option is set on the Subscribers tab).

• Subscribers: Lists the subscribers to this group (subscribers are assigned to a group on the Subscribers tab).

118

7.4 Managing Group Members Use the Members tab to add or remove individual servers or Database servers as members of a group.

Figure7. 3 Members Tab for Server Groups

Server Groups :

• Show: Groups/Servers: Select an option, Groups or Servers, to display a list of server groups or servers defined to Softek Storage Manager. Use the Add/Remove buttons to add or remove the server groups or servers to the list of group members on the right.

NOTE

Only groups that do not contain other groups are selectable.

• Group Members: Lists the members of this group. You can add servers or other server

groups from the list on the left.

Figure7. 4 Members Tab for DB Server Groups

DB Server Groups :

Show: Groups/DB Servers: Select an option, Groups or DB Servers, to display a list of DB Server groups or database servers defined to Softek Storage Manager. Use the Add/Remove buttons to add or remove the DB Server groups or database servers to the list of group members on the right.

119

NOTE

Only groups that do not contain other groups are selectable.

Group Members: Lists the members of this group. You can add Database servers or other

DB Server groups from the list on the left.

7.5 Managing Group Subscribers Use the Subscribers tab to add or remove subscribers for a group.

Figure7 .5 Subscribers Tab for Groups

• Administrators: Displays a list of administrators defined to Softek Storage Manager. Use the Add/Remove buttons to add or remove administrators from the list of subscribers on the right.

• Alert: Check this box to send an alert to this subscriber whenever the alert condition is met.

NOTE

The group’s administrator does not automatically receive an alert. To receive alerts, the group’s administrator must be added to the group as a subscriber.

• Subscribers: Displays a list of subscribers to this group. Use the Add/Remove buttons to

add or remove administrators from this list.

120

7.6 Assigning an Action Set to a Group

7.6.1 Assigning Server Action Sets Use the Assignments tab to assign an Action Set to a server group in order to manage the servers within the server group more efficiently. The changes that result from the Action Set are automatically propagated to all of the servers within the server group that is assigned to that Action Set.

Figure7. 6 Assignments Tab for Server Action Sets

!

CAUTION: If the Action Set assigned to a Server Group is changed, or if new servers are added to the server group, the Storage Administrator must re-assign the Action Set to the Server Group for the changes to take effect.

► To assign an Action Set to a Server group:

1. Add the Server group name to an action set using the Assignments tab for Action Sets.

2. Check the Set as Active option to make the action set active for this server group.

121

7.6.2 Assigning Database Action Sets Use the Assignments tab to assign an Action Set to a DB Server group in order to manage the database servers within the DB Server group more efficiently. The changes that result from the Action Set are automatically propagated to all of the database servers within the DB Server group that is assigned to that Action Set.

Figure7. 7Assignments Tab for Database Action Sets

!

CAUTION: If the Action Set assigned to a DB Server Group is changed, or if new database servers are added to the DB Server Group, the Storage Administrator must re-assign the Action Set to the DB Server Group for the changes to take effect.

► To assign an Action Set to a DB Server group:

1. Add the DB Server group name to an action set using the Assignments tab for Action Sets.

2. Check the Set as Active option to make the action set active for this DB Server group.

7.7 Overriding an Action Set for a Server Within a Group

This is applicable only for server groups. Sometimes, you might want to override the group action set for an individual server within the group. This allows you to keep a server as a member a group, but not have it be subject to the group’s action set. It also allows for a server to be a member of multiple groups, but still point to only one action set.

► To override an action set for a server within a group:

1. Create a Show Statement to display the desired server in the Visualizer, and then select the server.

2. Select the Schedule tab for the selected server.

122

Figure7. 8 Schedule Tab for Servers

3. In the Server Override Schedule area, check Override Action Set for this Server.

Checking this option will override any action set that is active for this server.

123

124

8

Using Custom Commands

• 8.1 Remote versus Local Custom Commands 127

• 8.2 Defining a Custom Command 127

• 8.3 Defining an Optional Custom Command Context 129

• 8.4 Using a System-defined Custom Command 130

• 8.5 Rules and Guidelines for Using Custom Commands 130

• 8.6 Invoking a Custom Command Interactively 131

• 8.7 Invoking a Custom Command through a Server Action Set 132

• 8.8 Invoking a Custom Command Following an Action Set Export 133

• 8.9 Custom Command Parameters 133

• 8.10 Usage Example: Custom Command 135

125

126

Softek Storage Manager allows you to create a custom command line that executes actions such as FTP, archive and backup. Custom commands are the preferred way to archive files. Custom commands can execute remotely on application servers through a space agent, or locally, on the Storage Management Server itself.

Custom commands enable you to set up custom integration with third party tools, such as reporting, backup and compression tools. Once you define a custom command in Softek Storage Manager, you can invoke it from the Softek Storage Manager console in several different ways:

• as part of an Action Set (Capacity Update and File Data Update actions)

• following an Action Set export function

• interactively, from the Commands Menu for files file systems and folders in the Visualizer

NOTE

The read-only Softek Storage Manager Console cannot execute custom commands.

8.1 Remote versus Local Custom Commands There are two kinds of custom commands:

• Remote Custom Command: The custom command is executed by a space agent for execution on a remote server.

!

CAUTION: A Space Agent must be running on a remote server in order for a custom command to execute on the remote server.

• Local Custom Command (also called Export with Custom Command): The custom

command executes after data has been exported through an Action Set export function. Local custom commands run on the Storage Management Server itself.

8.2 Defining a Custom Command You define a custom command on the Custom Commands dialog. For a list of parameters, see 8.9 Custom Command Parameters.

► To define a custom command: 1. Select Custom Commands from the Configuration Menu. The Custom Commands

dialog appears.

2. Select New Command.

127

Figure8. 1 Custom Commands Dialog

3. Enter information on the dialog:

− Name: Provide a name that Softek Storage Manager will use for this custom command.

− Command: Enter the command line with any variables to be substituted. For substitution rules and the list of available variables, see 8.9 Custom Command Parameter.

− Type: Select the type of custom command from the drop-down list, or click New Type to enter a new command type.

− Comment: Enter optional comments regarding the command.

− Max Objects: (Optional.)Enter a value to limit the number of objects passed to a custom command in the ObjectList variables. The Tivoli Storage Manager client is an example of a custom command that needs to have Max Objects specified, because it will not accept more than 20 file names on the command line. If a Tivoli Storage Manager archive command is invoked on more than 20 files, several custom commands will be executed on the server, each of them having 20 files or less. ObjectList variables themselves are limited in length, and can also cause a custom command invocation to be split.

− Max Running Time: (Required.) Select a maximum amount of running time for the custom command, in seconds. If the command runs longer than its maximum running time, it will be aborted.

4. Click Add/Update to add the command to the Command Name List.

128

!

CAUTION: A custom command must be able to process Unicode command-line arguments if the command is to receive non-ANSI file names.

5. To remove a command, highlight the command name in the Command Name List, and

click Remove.

6. Click OK to save your changes and close the dialog.

8.3 Defining an Optional Custom Command Context When defining a custom command, you have the option to set up a custom command context. This context provides the host name and some of the parameters that will be used when executing the custom command. The custom command context “remembers” associated parameters that can be attached to a custom command later on.

► To define a custom command context:

1. From the Configuration Menu, select Custom Command Contexts. Figure8 .2 Custom Command Contexts Dialog

2. Enter information in the dialog box:

• Name: Enter the name Softek Storage Manager will use for the custom command.

• Type: Select the type of command that is being created from the drop-down menu (archive, backup, ftp, etc.). To enter a new command type, click New Type, and enter the command type in the text box that opens.

129

• Hostname/IP: Enter a TCP/IP hostname or a discrete IP address.

NOTE

This field is limited to 256 characters.

− Comment: Enter optional comments describing the custom command.

− User1 – 4: Fields for optional use.

NOTE

The fields on the Custom Command Context dialog are used as parameters when specifying commands in the Custom Commands dialog. For more information, see 8.9 Custom Command Parameters.

3. Click Add/Update to add the custom command context to the list at the bottom of the

screen.

4. To remove a command, highlight the command in the list and click Remove.

8.4 Using a System-defined Custom Command Softek Storage Manager provides system-defined custom commands to archive files through Networker, Veritas Netbackup and Tivoli Storage Manager. You can use a system-defined custom command to archive files through Veritas Netbackup, for example, without having to define a new custom command.

When using a system-provided custom command, you must define a custom command context so that the archive custom command will know where to find its archive server. (You specify the archive server in the Host Name/IP field of the Custom Command Context dialog.)

NOTE

Customers are responsible for installing and configuring third party archiving software, both the server and the client parts. In particular, customers should ensure that the path to the third party client command-line program is in the System Path.

The following commands are included when Softek Storage Manager is installed:

• Archive for Networker.

• Archive for Veritas NetBackup

• Archive for Tivoli TSM.

8.5 Rules and Guidelines for Using Custom Commands Be aware of the following rules and guidelines when using custom commands:

NOTE

A custom command runs in background mode. On Windows, it runs in a Service environment.

• A custom command should not try to open windows on the screen.

• A custom command should not be written to interact with a user, because the user might not be available when the command runs.

130

• A custom command should terminate within its maximum running time.

• A custom command and delete will delete files only if the command returns an exit code of zero.

• Only one local custom command can run on the Storage Management Server at a time. However, several Action Set Exports (with or without a custom command) can be executed while a local custom command is being carried out. The exporting and the execution of the local custom command are done asynchronously.

• Fujitsu Softek recommends that you use the system-defined custom commands as examples for writing your own command. This is especially recommended for UNIX, where variable substitution can be difficult.

• Any UNIX custom command that needs to specify the ObjectList variable on the command line has to start with eval

and protect any variable to be substituted (except the UnixObjectList variable) that may contain spaces with both a quote and an escaped quote, as in "\"$Variable\"". See the following example: eval nsrarchive -s "\"$ContextHostName\"" -T "\"SSM_$UserName_$ActionSetName_ $ActionSetRule_${CurrentDate}$CurrentTime\"" -y $UnixObjectList

8.5.1 Expected Return Code A custom command returns zero as its exit code when it successfully completes. Anything other than zero will be interpreted as an error by Softek Storage Manager.

NOTE

A custom command will delete files only if the command returns an exit code of zero.

8.6 Invoking a Custom Command Interactively You can invoke a custom command interactively from the File Commands Menu, File System Commands Menu or Folder Commands Menu.

Figure8. 3 Invoking a Custom Command from the Commands Menu

► To invoke a custom command interactively: 1. From the Commands Menu for files ,file systems or folders, select Invoke Custom

Command. The Select a Custom Command screen appears.

131

Figure8. 4 Select a Custom Command

2. Select a custom command from the commands list, and optionally, select a custom command context from the contexts list.

3. Check the Delete files(s) after command executes box, if desired. The check box is not present for filesystems and folder Custom Commands.

4. When you are satisfied with your selections, click OK.

8.7 Invoking a Custom Command through a Server Action Set You can invoke a custom command, or invoke a custom command and delete files, as actions for a server Action Set. A server Action Set can execute a custom command as actions as follows:

• A custom command action can be invoked in the Capacity Update section for file systems.

• A custom command or a custom command and delete files action can be invoked in the File Data Update section for files.

• A custom command can be invoked in the Folder Capacity Update Section for folders.

When you invoke a custom command using an Action Set, you can attach an optional custom command context as described in 8.3 Defining an Optional Custom Command Context.

132

8.8 Invoking a Custom Command Following an Action Set Export

You can create an Action Set that will automatically invoke a custom command following an Action Set Export function. The custom command is executed after the Action Set finishes its export activity.

► To invoke a custom command automatically following an Action Set export: 1. Starting at the Actions tab for Action Sets, check Export results for an action, and then

click Parms. The Define Export Results Parameters dialog appears. Figure8. 5 Define Export Results Parameters Dialog

2. Click Select. The Select a Custom Command dialog appears as shown on Figure8 4.

3. Select a custom command and optional context, and click OK. The custom command and custom command context are displayed in Define Export Results Parameters dialog.

4. Click OK to save your selections and close the dialog.

The custom command executes after the Action Set exports the action results to a file.

8.9 Custom Command Parameters The following is the list of variables that will be supplied to custom commands through their environment.

NOTE

Microsoft Windows custom commands use Windows shell variable substitution syntax (%Variable%); UNIX uses Bourne Shell variable substitution syntax ($Variable or ${Variable}).

Custom commands support the following variable substitutions:

• ActionSetName: The name of the Action Set that issued the custom command. This variable is only defined if the custom command is the result of an action set action or of an Export with custom command.

• ActionSetRule: The name of the Action Set rule that issued the custom command. This variable is only defined if the custom command is the result of an Action Set action, or an Export with custom command.

• ContextComment: The 'Comment' field of the context. This variable is defined only if the command was issued with a context.

• ContextHostName: The 'Host Name' field of the context. This variable is defined only if the command was issued with a context.

133

• ContextName: The name of the context. This variable is defined only if the command was issued with a context.

• ContextUser1: 'User 1' field of the context. This variable is defined only if the command was issued with a context.

• ContextUser2: 'User 2' field of the context. This variable is defined only if the command was issued with a context.

• ContextUser3: 'User 3' field of the context. This variable is defined only if the command was issued with a context.

• ContextUser4: 'User 4' field of the context. This variable is defined only if the command was issued with a context.

• CurrentDate: Current date when command is issued. If a command is split, all commands should have the same CurrentDate. Format: YYYYMMDD. February 1, 2003 would be formatted as 20030201.

• CurrentTime: Current time when command was issued. If a command is split, all commands should have the same time. If a command is split, all resulting commands will have the same CurrentTime. Format: HHMMSS. 11:01:02PM would be formatted as 230102.

• CustomCommandType: 'Type' field of the custom command.

• ExportedFile: Absolute path name of the file generated by the Export. This variable is defined only if the custom command is the result of an Export with custom command.

• ObjectList: List of objects to be acted upon, formatted for Windows or Unix. The total size of the expanded ObjectList will never exceed 16KB.

Custom Command Source Type of Objects in the List

• File Commands Menu. • File Data Update Action. • File Data Update Export with

Custom Command.

File names

• File System Commands Menu. • Capacity Update Action. • Capacity Update Export with

Custom Command. •

File System names

• Folder Commands Menu • Folder Capacity Update Action • Folder Capacity Update Export

with Custom Command

Folder Names

If the custom command is to be executed on a Windows computer:

− Object names are within double quotes and are separated by a space character.

− Slashes (/) are replaced by backslashes (\).

If the custom command is to be executed on a Unix server:

− Object names are within double quotes and are separated by a space character.

− Double quotes ("), grave accents (`), dollar signs ($) and backslashes (\) present in object names will be escaped with a backslash (\).

− These conventions are compatible with the Bourne shell (see built-in archive commands for examples of use).

134

For an export with custom command, the format is the same as the UnformattedObjectList.

• PartNumber: When a command is split in several parts (too many objects), the number of the current part.

• Server: The name of the server to which the objects in the ObjectList variables belong.

• TotalParts: When a command is split in several parts (too many objects), the total number of parts.

• UnformattedObjectList: The unformatted list of objects used for display purposes.

- Object names are within double quotes and are separated by a space character.

- Double quotes (") present in object names will be replaced with an underscore (_).

• UserName: The name of the user who issued the custom command. This variable is defined only if the custom command was issued interactively.

8.10 Usage Example: Custom Command The following example demonstrates how to use a Custom Command to emulate the function of an Archiving program (such as Networker). Examples are included for both Windows and Unix.

8.10.1 Objective For the purposes of this example, the freely available Zip program Info-Zip (www.info-zip.org) is used as part of a custom command to archive files to a user-defined archive server.

When this custom command is invoked on a set of files, a zip file is generated containing the selected set of files. The zip file is automatically assigned a name indicating the date and time at which the zip file was created, as well as the name of the server where the custom command was invoked: Server_YYYYMMDDHHMMSS.zip. For example, if the command were invoked on the server Cerberus on January 2, 2003 at 11:04:05PM, the resulting archive would be named Cerberus_20030102230405.zip.

This custom command may be used exactly for the same purposes as the Archive and the Archive and Delete file command actions. That is, in order to free space on a server without permanently deleting files, this custom command may be invoked (using the Invoke Custom Command and Delete Files function) to archive specific files before deleting them.

135

8.10.2 Windows Archive Using Info-Zip Figure8. 6 Custom Command - Windows Archive Using Info-Zip

To create a Windows Zip archive, you need to define a custom command with the following command line:

zip %ContextUser1%\%Server%_%CurrentDate%%CurrentTime%.zip %ObjectList%

This command has to be invoked with a context to run properly, since it depends on the ContextUser1 variable to specify the location where the zip archives are to be stored. Following is a command context that can be used with the previous command.

136

Figure8. 7 Custom Command Context

NOTE

Note that the Type field of the context has to match with the Type field of the custom command.

This context can be applied on all servers that will archive their files to \\qt45\ArchivedFiles. You must define another context for servers that should archive their files elsewhere.

137

8.10.3 UNIX Archive Using Info-Zip Figure8. 8 Custom Command - Archive with Zip (Unix)

To create a UNIX Zip archive, you need to define a custom command with the following command line:

eval zip "\"${ContextUser1}/${Server}_${CurrentDate}${Currenttime}.zip\"" $ObjectList

This command has to be invoked with a context to run properly, since it depends on the ContextUser1 variable to specify the location where the zip archives are to be stored. Following is a command context that can be used with the previous command.

138

Figure8. 9 Command Context - Archive with Zip (Unix)

NOTE

Note that the Type field of the context has to match with the Type field of the custom command.

This context can be applied on all computers where the archive folder is mounted as /nfs/ tdmfsuna/archived_files. You must define another context for servers that should archive their files elsewhere.

139

8.10.4 Cleaning Up Archive Folders The next logical step, provided that the servers where the archive zip files are stored have a Softek Storage Manager Space Agent installed, is to use those servers’ Action Set to ensure that old zip files are deleted.

To that end, an action rule group can be added to the Action Set's File Data Update segment. The following example will delete zip files older than 30 days.

Figure8. 10 Cleaning Up Archive Folders

140

System Administration

141

142

Section 4 System Administration

143

144

9

Configuring Administrators and Setting System Options

• 9.1 Configuring an Administrator 147

• 9.2 Adding or Editing an Administrator 148

• 9.3 Creating a Default Administrator 148

• 9.4 Administering a Database 149

• 9.5 Configuring System Options 149

145

146

9.1 Configuring an Administrator You must configure at least one Softek Storage Manager Administrator. You are automatically prompted to configure an administrator at the first startup of the Softek Storage Manager console.

► To configure an Administrator:

1. From the Configuration Menu, select Administrators as shown in figure: Configuring Administrators. An administrator must be defined before he or she can be assigned to a server.

Figure9 .1 Configuring Administrators

2. A dialog box that shows all administrators defined to the system appears as shown in figure9.2 : Administrators Dialog. From this dialog, you can add, edit and delete an administrator, or set the administrator as a default.

Figure9 .2 Administrators Dialog

147

9.2 Adding or Editing an Administrator ► To add or edit an administrator:

1. From the Administrators dialog as shown in figure9 2: Administrators Dialog, click New. The Administrator dialog appears.

Figure9 .3 Administrator Dialog

2. Enter an e-mail address in the E-Mail Addresses field—this address will be used for sending alert e-mail messages as a result of an Action Set execution.

NOTE

Softek Storage Manager sends alerts only once every 12 hours for a space problem on a single application server. No alert is sent if it was already issued during the previous 12 hours. The 12 hour time will be calculated with respect to the start time of the command for which the mail is sent, and not the PREVIOUS mail sent time.

3. To edit an administrator, select the administrator you wish to modify and click Edit from

the Administrators list, or double-click on a name in the list. Enter the new information in the Administrator Configuration dialog box.

9.3 Creating a Default Administrator You can set up one or more default administrators in Softek Storage Manager. Default administrators receive all e-mail notifications sent by the Action Set engine in addition to the administrator assigned to the Action Set.

► To create a default administrator: 1. From the figure9 2: Administrators Dialog, select an administrator.

2. Click Make Default.

148

9.4 Administering a Database Each database has an assigned administrator. You assign an administrator to a database on the Server tab as shown in Figure9 4 Server Tab for a Database.

Figure9. 4 Server Tab for a Database

9.4.1 Administrator Notifications about Action Set Executions Whenever a database is affected as the result of an Action Set, the assigned database administrator and the default administrator is notified.

For information about creating a Database Action Set, see 5.8 Previewing Action Results.

9.5 Configuring System Options Many Softek Storage Manager settings can be set and modified by selecting Options from the Configuration Menu. The Options dialog allows you to select and set system, storage collection and reporting preferences. The dialog contains four tabs: Storage Data, System, Reporter and DB Server.

9.5.1 Options: Storage Data Tab The Options dialog box allows you to select and set storage collection, system and reporting preferences. The Storage Data tab allows you to set file system capacity and data retention options for Softek Storage Manager.

Figure9 .5 Options Storage Data Tab

149

The Storage Data tab contains the following areas:

• File System Capacity: Select a percentage value for file system capacity.

• Data Retention area: Use this area to set values for how long you want to keep historical information in the database, to be available for reports, trending, research and accounting purposes.

− Days - Historical Data: Specify the number of days to retain file system and server capacity information in the database for reporting purposes. This number indicates how long this information will be available for Softek Storage Manager trending and other historical reports.

− Days - Command and Action Set Execution History: Specify the number of days to retain a history and log of commands executed by Softek Storage Manager. This includes any command that has been executed by:

- a space agent

- the Data Collector

- Action Sets

− Days - Archived File Input Data: Specify the number of days that archived files in the Archived directory will be kept. Files in the Archived directory will be deleted after the specified number of days. These files are normally used only by the Mainframe Space Agent.

9.5.2 Options: System Tab The System tab in the Options dialog box allows you to set system-wide options for Softek Storage Manager, including reporting options.

Fugure9. 6 Options System Tab

150

This tab includes the following sections:

• E-Mail Alert Notification

− E-Mail Sender: Enter the e-mail address for the sender who will issue alerts.

− SMTP Server of Sender: Enter the domain name of the SMTP server that will send alerts.

− Email Format: Select the mail format. Text/HTML. The default option is HTML.

− Email Size (Number of items in one mail): Enter the maximum mail size in terms of number of items to be notified. Default is 1000. Maximum limit is 999999999. If the e-mail content crosses the value, e-mail will be split into multiple parts.

The Number of items is:

− Number of File systems: For Capacity Update Mails

− Number of Tablespaces: For Database Configuration Update Mails

− Number of Files: For File Data Update Mails

− Number of Folders: For Folder Capacity Update mails.

• Tools:

− Trace Level: Enter the desired level of tracing for the Softek Storage Manager Console, from No Logging to Log Everything. Normal is the standard tracing level, which traces exceptional conditions; Log Everything traces the entire processing flow, and should be used only under the supervision of Fujitsu Softek Customer support. Log files are written to the same directory that the Softek Storage Manager executable file, somod.exe, resides in. Up to 10 log files are created, and then re-used.

151

− SQL Timeout: Select a timeout value for the amount of time a query can run in the SQL Server. The time-out value can be set to allow long-running queries to complete.

152

9.5.3 Options: Reporter Tab The Reporter tab allows you to set preferences for launching and configuring reports by Softek Storage Manager.

Figure9. 7 Options Reporter Tab

The Reporter tab contains the following sections:

• Report Run Time: Select a time for generating daily reports. The default run time is 4:00 a.m.

• Reports URL: Specify a web site URL for the automatically generated reports. This field provides the HTML address needed for displaying Softek Storage Manage reports. Use the following format: http://<Network Computer Name>/Softek_Storage_Manager/index.asp

• File Type: In this section, you can add or delete types of files that will be reported in the Accumulative Files Report. By default, the types of files included in the Accumulative Files Report are .jpg, .mp3, .avi and .mpg. For more information on the Accumulative Files Report, see the Softek Storage Manager Reports User Guide (ML-145030).

In some operating systems, the file extension is case-sensitive.

► To include additional file types in the Accumulative Files Report:

• Type the file extension into the file the text box on the left, and click Add.

► To a delete a file type from the Accumulative Files Report:

• Highlight the file type in the list on the right, and click Delete.

153

9.5.4 Options: DB Server Tab The DB Server tab allows you to set options for managing a database server.

Figure9. 8 Options DB Server Tab

Enter the following information on the DB Server tab:

• Name: The name of the Database Server that is to be managed by Softek Storage Manager.

- Oracle – In case of Oracle enter the service name of the Oracle Database Server, which is created on the client machine. For creating the service name or installing Oracle Client refer the Softek Storage Manager Installation Guide Version 2.3, Section D .

- Microsoft SQL Server – In case of Microsoft SQL Server enter the hostname of the machine where the SQL Server is installed.

- NOTE

If multiple instances of Microsoft SQL server exist on a machine, the

named instances are referred by <hostname>\<instance-name>. For monitoring a named instance of Microsoft SQL enter <hostname>\<instance-name> in the Name field of the DB Server tab.

- Symfoware – In case of Symfoware Database Server, enter the system DSN name

which is created for the Symfoware DB Agent Instance. For creating the system DSN refer Symfoware Server Enterprise Edition: Start Guide

154

NOTE

• Symfoware DB Agent is installed in a separate instance on the machine where the Symfoware database server, which is to be monitored, is installed. The name used for this instance is taken as an input from the user during installation of Symfoware DB Agent. This same Instance name should be used while creating the DSN in order to monitor the Symfoware database server.

• When monitoring Symfoware Databases, in case the <default> instance is not being used, the following message will be output to the Event Log. There is no need for corrective action to be taken in this case:

“qdg02250u: 'rdbprt' command cannot be executed because RDB II is inactive.”

• If Archive Log is not being used by the monitored RDB instance, the following message will be output to the Event Log. There is no need for corrective action to be taken in this case:

"qdg02358u: Archive Log operation has not been initialized (system name: RDB System Name)."

• Administrator: The administrator assigned to the database server.

• Type: The database server type. Supported types include Oracle, Microsoft SQL Server, and Symfoware Database Server.

• Data Collection Interval: Select an interval, in minutes, to determine how frequently Softek Storage Manager will collect information from the database server.

• OS Authentication: Check this box if you want to use the password and identifier of the Softek Storage Management Server when communicating with the managed database.

• User Name: Specify a user name, if you want to specify a user name that is different from the Storage Management Server user name.

• Password: Specify a password, if you want to use a password that is different from the Storage Management Server password.

After the setting, when you click OK or Apply button，database scan is performed. Added Database is shown in “show database” screen.

NOTE

• In case of Symfoware Database Server, the server operating environment file

must be properly configured. The Value for MAX_CONNECT_TCP in the server operating environment file, should be greater then 0 in order to accept remote connections. For configuring the Server Operating Environment file refer Symfoware Server Enterprise Edition, RDB Operations Guide

• The Symfoware Agent must be installed on the same server where Symfoware Database server is installed. The Symfoware DB Agent must be running on that server as a service. Without Symfoware DB Agent, no information for the Symfoware Database can be collected.

• The Symfoware Client must be installed on the same server where Softek Storage Manager Server is installed.

155

156

10

Configuring Archive Servers

• 10.1 Introduction 159

• 10.2 About NetWorker 159

• 10.3 Configuring Archive Servers with NetWorker 161

• 10.4 Configuring Veritas Netbackup 162

• 10.5 Configuring Archive Servers with Tivoli for Windows Servers 162

• 10.6 Setting the System Variable Path to Find the DSMC Command 164

• 10.7 Configuring Archive Servers with Tivoli on Unix Servers 165

157

158

10.1 Introduction You can perform archiving in Softek Storage Manager using Archive and Archive and Delete commands, as well as custom commands. The following software can be installed on certain Softek Storage Manager machines to archive files:

• NetWorker

!

CAUTION: Do NOT install the NetWorker application on the Softek Storage Management Server. Also, NetWorker and Windows Services for UNIX must NOT be installed on the same machine.

• Veritas NetBackup

• Tivoli

To archive files with Veritas and Tivoli, you MUST use custom commands. All servers on which you will perform backups MUST have the NetWorker, Veritas, or Tivoli client installed in order for the archiving feature to work.

For more information on archiving, please refer to Chapter 4: Managing Storage Resources and Chapter8: Using Custom Commands.

10.2 About NetWorker NetWorker allows you to back up and recover data across your entire network. In order to ensure that Softek Storage Manager’s Archive and Archive-Delete commands work properly, you must install NetWorker on the Archive Server and on the machines where the Space Agents are installed. Doing so allows the necessary communication between the Softek Storage Management Server, the Archive Server, and Space Agents.

To function properly:

• The NetWorker Server must be installed on the computer that is to be used as the Archive Server.

• The NetWorker Client must be installed on all Unix Space Agents machines that require archiving capabilities.

You must then create and configure NetWorker devices and NetWorker clients, as well as configure Softek Storage Management Server to use NetWorker.

For instructions on installing and configuring NetWorker, please refer to the NetWorker documentation.

159

10.2.1 Configuring the Networker Server The NetWorker Server needs to be previously configured to allow backups from the SYSTEM (Windows) or root (UNIX) account on the client. This is because the Space Agent process runs under the SYSTEM (or root) account by default.

► To configure the NetWorker Server:

1. Open NetWorker Administrator, and connect to the backup server.

2. Select Client Operations / Manage Clients from list of options.

3. Right-click the client you wish to configure, and select Edit.

4. Go to the Preferences tab.

5. Add SYSTEM (or root) to the Archive Users field (or another user if the Softek Process Monitor service is configured to run under another user).

10.2.2 Configuring NetWorker for UNIX Space Agents In order to ensure that Softek Storage Manager’s archiving and archive deletion commands work properly with NetWorker, you must configure your NetWorker Clients. Doing so enables the necessary communication between Softek Storage Manager Space Agents, NetWorker Clients, and the server machines for both Softek Storage Manager and NetWorker.

► To allow NetWorker to work with a UNIX Space Agent:

• Create a soft link in either /usr/bin or /usr/sbin by entering the following command on a NetWorker Client: ln -s <path to installed nsrarchive> /usr/bin/nsrarchive

10.2.3 Configuring Archive Servers with NetWorker In order to archive files with NetWorker, you must configure Archive Servers using the Configuration menu.

► To configure Archive Servers:

1. Launch the Softek Storage Manager Console by selecting Start> Programs> Softek Storage Manager> Storage Manager Console (Read/Write)

2. From the main menu, click Configuration> Archive Servers. The Archive Servers dialog box appears. Type in the name of your NetWorker server. Click Add.

Figure10. 1 Archive Servers

160

3. Use the Console to build a Show statement displaying All Servers.

4. In the Visualizer, select the server that contains the files to be archived.

5. In the Details tab, click Archive Servers. From the drop-down box that appears, select the name of your NetWorker Archive server.

6. Repeat the above-mentioned steps for each server listed in the Visualizer that will archive files using NetWorker.

7. Select the file(s) to be archived. From the File Commands menu, select Archive, Archive and Delete, or Invoke Custom Command to archive the files.

10.3 Configuring Archive Servers with NetWorker In order to archive files with NetWorker, you must first configure Archive Servers using the Configuration menu.

► To configure Archive Servers: 1. Launch the Softek Storage Manager Console by selecting

Start> Programs> Softek Storage Manager> Storage Manager Console (Read/Write)

2. From the main menu, click Configuration> Archive Servers. The Archive Servers dialog box appears. Type in the name of your NetWorker server. Click Add.

Figure10. 2 Archive Servers

3. Use the Console to build a Show statement displaying All Servers. For more information on building Show statements, refer to Chapter 4: Managing Storage Resources.

4. In the Visualizer, select the server on which the files you want to archive are located.

5. In the Details tab, click Archive Servers. From the drop-down box that appears, select the name of your NetWorker Archive server.

6. Repeat the above-mentioned steps for each server listed in the Visualizer that will archive files using NetWorker.

7. Select the file(s) to be archived. From the File Commands menu, select Archive, Archive and Delete, or Invoke Custom Command to archive the files. Please refer to Chapter 4: Managing Storage Resources and Chapter 8: Using Custom Commands.

161

10.4 Configuring Veritas Netbackup ► To allow Veritas Netbackup to work with a UNIX Space Agent:

• Create a soft link in either /usr/bin or /usr/sbin by entering the following command on a Veritas Netbackup client:

• ln -s <path to installed bpbackup> /usr/bin/bpbackup

10.5 Configuring Archive Servers with Tivoli for Windows Servers

The following procedure must be undertaken on the Storage Manager Windows Space Agent machines, in order to enable archiving with the dsmc command when using the Tivoli software.

Tivoli TSM must have the following two parameters configured in the Environment Variables for Windows 2000.

► To configure Tivoli TSM on Windows 2000 Space Agent Machines:

1. Open System Properties (Control Panel -> System): Figure10. 3 System Properties

2. Click Advanced, and Environmental Variables.

3. Click New under System variables.

162

Figure10. 4 Environment Variables

4. Create the following variable: DSM_DIR C:\Program Files\Tivoli\TSM\baclient

Click Ok.

5. Click New again from the Environment Variables panel, and create the following variable: DSM_CONFIG C:\Program Files\Tivoli\TSM\baclient\dsm.opt

Click Ok.

NOTE

If Tivoli TSM is installed in a different path other than the default, enter the appropriate path for each of the aforementioned variables.

163

10.6 Setting the System Variable Path to Find the DSMC Command

On Windows servers, you must configure the Path system variable so that it can find the DSMC command.

► To set the system variable path to find the DSMC command:

1. Open the Environmental Variables panel and select the system variable Path. Figure10. 5 Environment Variables - Path

2. Click Edit and view the full list of paths set for the server. Go to the end of the list and add the path to the DSMC command followed by a semi colon. Do not put any spaces between the previous path and the path to the DSMC command. Ensure that the previous command is ended with a semi colon.

The typical path to the DSMC Command as set in the default installation of a Tivoli TSM client is as follows: C:\PROGRA~1\Tivoli\TSM\baclient;

164

Figure10. 6 Edit System Variable

3. Click OK when you have entered the full path correctly, followed by a semi colon. Then click OK in the Environmental Variables window.

NOTE

When you add a new string to the path variable, you must reboot the server for the changes to take place. Softek Storage Manager cannot launch the Tivoli Archive command until the server is rebooted.

10.7 Configuring Archive Servers with Tivoli on Unix Servers When using Tivoli software, you must perform the following procedure on Unix servers in order to enable archiving with the dsmc command.

► To configure archive servers with Tivoli TSM on Unix servers:

• Issue the following commands, depending on the type of shell:

For the Korn Shell (ksh) use the following commands:

export DSM_CONFIG=/opt/tivoli/tsm/client/ba/bin/dsm.opt

export DSM_DIR=/opt/tivoli/tsm/client/ba/bin

For the C Shell (csh) use the following commands: setenv DSM_CONFIG /opt/tivoli/tsm/client/ba/bin/dsm.opt

setenv DSM_DIR /opt/tivoli/tsm/client/ba/bin

If Tivoli is installed in a path different to the default then choose the path to the file dsm.opt and the directory of baclient for the aforementioned variables.

NOTE

The following line must be added to the dsm.sys file on Unix Servers: “PASSWORDACCESS GENERATE” This line is automatically added to the dsm.opt file during the installation and configuration of a Tivoli Windows clients, but it must be manually added to the dsm.sys file for Tivoli Unix client. For a further explanation of this please refer to the installation guide for Tivoli Storage Manager clients.

165

10.7.1 Example of a Unix dsm.sys file: ************************************************************************

* Tivoli Storage Manager *

* *

* Sample Client System Options file for AIX and SunOS (dsm.sys.smp) *

************************************************************************

* This file contains the minimum options required to get started

* using TSM. Copy dsm.sys.smp to dsm.sys. In the dsm.sys file,

* enter the appropriate values for each option listed below and

* remove the leading asterisk (*) for each one.

* If your client node communicates with multiple TSM servers, be

* sure to add a stanza, beginning with the SERVERNAME option, for

* each additional server.

************************************************************************

SErvername absinthe

COMMmethod TCPip

TCPPort 1500

TCPServeraddress absinthe

PASSWORDACCESS GENERATE

166

11

Space Agents, Data Collector and Database

• 11.1 Space Agents Definition and Purpose 169

• 11.2 Space Agent Functions 169

• 11.3 Backing Up the Database 170

167

168

11.1 Space Agents Definition and Purpose Softek Storage Manager Space Agents monitor and manage the storage associated with specified servers. Softek Storage Manager Space Agents manage servers, file systems, folders and files.

The storage administrator will manage the file systems and files from the server operating system’s point of view. Storage management tasks deal with understanding what storage is available, how the storage and files are being used, and how to effectively utilize storage.

The Storage Manager application:

• collects file system , folder and file information from managed servers;

• generates space management reports to help the storage administrator understand the storage resources and how they are being used;

• provides the storage administrator with methods to describe conditions and actions that help automate some storage management tasks.

Space agents are programs installed with the Storage Manager to collect information about file systems from storage devices and/or servers on the SAN. The information collected includes:

• Hardware and software configuration

• OS types and file systems

11.2 Space Agent Functions 11.2.1 Space Agent Data Collection

Space agents perform data collection on managed servers. For file systems, the data will include items such as file system information, total amount of space, and amount of free space.

For folders, the data includes items like folder name, folder size, creation date, and accessed date.

For files, the data includes items like file name, creation date, and last accessed date.

11.2.2 Data Collector The Storage Manager Collector is a program that takes all data collected by the Space Agents from the servers, and transfers them to the appropriate tables in the Storage Manager database.

The Collector runs only on the Storage Management Server.

11.2.3 Operations Softek Storage Manager Space Agents operate on the Storage Management Server as follows:

• Agents are installed on client machines and then connect to the Storage Management Server, relaying information on files and file systems. Softek Storage Manager supports up to 10,000 file systems.

169

11.3 Backing Up the Database Fujitsu Softek recommends that you back up the Softek Storage Manager database regularly by using the MS SQL Server backup procedure. For more information on backing up a database, refer to the MS SQL Server 2000 documentation.

170

12

Scanning Remote File Systems

• 12.1 Overview 173

• 12.2 Scanning Remote File Systems with a UNIX Space Agent 173

• 12.3 Scanning Remote File Systems with a Windows Space Agent 174

171

172

12.1 Overview Softek Storage Manager allows a Windows Space Agent to remotely scan shared files systems, where the installation of a Softek Storage Manager Space Agent is not possible or desired.

To remotely scan a Network File System (NFS), you must first install and configure Microsoft Windows Services for UNIX on a Windows Space Agent machine, and then configure the Windows Space Agent machine. To do this, please follow the procedure described in “12.3 Remotely Scanning Network File Systems with a Windows Space Agent”.

NOTE

In order to allow remote file system scanning, the Windows Space Agent needs to have access rights to the relevant file system(s).

12.2 Scanning Remote File Systems with a UNIX Space Agent By default, NFS file systems are not scanned by the Softek Storage Manager UNIX Space Agent.

To enable remote scanning of an NFS file system, you must enter the corresponding mount points, of the NFS file systems that you want to scan, in the Softek Storage Manager Unix Space Agent configuration file:

1. On your Softek Storage Manager UNIX Space Agent machine, open the /opt/SSM/SpaceAgent/config/SpaceAgent.cfg file.

2. Add the following entry to the SpaceAgent.cfg file: NFS=</mount_point>

(Where 'mount_point' represents a valid mount point on the local system.)

Example Following is an example of a SpaceAgent.cfg file with mount point entries for '/home/jeff/' and '/home/dev' added:

SMS_NAME = 192.168.1.63

SMS_PORT = 3222

LOG_LEVEL = 0

NFS=/home/jeff

NFS=/home/dev

173

12.3 Scanning Remote File Systems with a Windows Space Agent

The following two procedures MUST be followed in order to configure Windows Space Agent machines to remotely scan Windows or UNIX file systems:

1. Add Remote File Systems path names using Agent Configurator. For details please refer to Chapter 13: Agent Configurator.

2. Configure Softek Storage Manager applications with the Softek Process Monitor Configurator.

The Softek Process Monitor Configurator is a program that allows you to configure Softek Storage Manager applications. The Softek Process Monitor launches and monitors the Softek Storage Manager Services, such as the Data Collector, Windows Space Agent, and the Action Set Engine. By default, the applications launched by the Softek Process Monitor run under the local system account.

To allow remote file system scanning, the Windows Space Agent needs to have access rights to the file system you wish to remotely scan. In order to do this, the Windows Space Agent needs to be launched under a specific account that exists on the Windows Space Agent itself, and on every file system it needs to scan.

12.3.1 Configuring Applications with Softek Process Monitor Configurator

The Softek Process Monitor Configurator is used to select an account that launches an application managed by a Softek Process Monitor. The Softek Process Monitor is used to start non-service applications, such as the Data Collector and Space Agents, in a service environment. Currently, this feature is used for remote file system scanning, which allows the Space Agent to access shared drives.

► To configure your applications with Softek Process Monitor Configurator:

1. On the Windows Space Agent machine with which you want to remotely scan a file system, stop the Softek Process Monitor Service by navigating to the Control Panel>Administrative Tools> Services.

2. Right-click Softek Process Monitor and select Stop Service.

3. Launch the Softek Process Monitor Configurator by selecting Start> Programs> Softek Storage Manager> Process Monitor Configurator.

Figure12 1 Locating Process Monitor

The Softek Process Monitor dialog box appears. Figure12. 2 Softek Process Monitor Dialog Box

174

4. Double-click SSM-Agent to bring up the Process Configuration dialog box.

Figure12. 3 Process Configuration Dialog Box

a. Edit the following fields:

− User name: Select a user from the list of accounts on the local machine.

NOTE

The user name must be an account that exists and has administrative privileges, on both the local machine where the Softek Storage Manager Space Agent has been installed, and on the file servers you wish to remotely scan. If the user name account does not exist on both the Softek Storage Manager Space Agent machine and the remote file server, no remote scanning will be possible.

− Domain: Enter a period (.) as shown in figure: Process Configuration Dialog Box.

This will ensure that the local account database is used.

− Password: Enter the password of the account specified in the User name field.

− Confirm password: Re-enter the password of the account specified in the User name field.

b. Click OK.

5. Save the Softek Process Monitor configuration.

6. Restart the Softek Process Monitor Services by performing the following steps:

a. Go to Start>Control Panel>Administrative Tools>Services.

b. Right-click Softek Process Monitor and select Restart Service.

175

176

13

Configuring Space Agents

• 13.1 Introduction 179

• 13.2 Space Agent Configuration for Windows 179

• 13.3 Space Agent Configuration for UNIX 191

177

178

13.1 Introduction The Softek Space Agents may be configured to collect information only for specified file systems and folders, on managed servers. You may specify a list of file systems for which information need to be collected including remote file systems. You may also specify a list of folders for which information need to be collected by a Space Agent.

Space Agent collects

• information regarding some server attributes and selected File Systems attributes during Capacity update.

• additionally, information regarding specified folders’ attributes will be collected during Folder Capacity update

• additionally, information regarding specified files’ attributes will be collected during File Data update.

13.2 Space Agent Configuration for Windows 13.2.1 Overview

The Softek Space Agent Configurator is used for specifying the folders and file systems for which the Space Agent need to collect information on managed Windows Servers.

In the Agent Configurator, you can specify the list of file systems for which information needs to be collected Filesystems tab. You can specify the list of folders for which information needs to be collected in Folders tab.

The Agent Configurator will be installed along with Windows Space Agent. To Launch Agent Configurator go to Start >Programs > Softek Storage Manager > Space Agent Configurator

Following is the Softek Space Agent Configurator dialog Figure 13.1 AgentConfigurator Dialog Box

179

13.2.2 FileSystem Tab You can specify the file systems for which information need to be collected by Space Agent in this tab. By default, Sapce Agent will collect information for all local filesystems. The check box Scan All Local Filesystems is checked by default.

You can specify additional file systems for scanning (like NAS file systems) or limit the information collection to specific file systems only by entering the full path of the file systems in this tab.

If you uncheck the box Scan All Local Filesystems, then Space Agent will collect information only for the file systems listed in the FleSystem tab.

You can exclude a folder from scanning by checking the Exclude Snapshot Folder option and specifying the path of the folder that needs to be skipped in the Snapshot Folder Name text box.

► To add a File System to be monitored:

1. Double Click on any blank row in Agent Configurator (File System tab) window shown in Figure 13.2

Figure 13.2 FileSystem tab

Filesystem Configuration Dialog box is displayed as shown in below Figure 13.3.

180

Figure 13.3 Filesystem Configuration

2. Enter the Filesystem name to be monitored.

Figure 13.4 Add Filesystem Information

3. Click OK button in the Filesystem configuration dialog box.

4. The newly added Filesystem information will be listed in SSM Agent Configurator window.

181

Figure 13.5 AgentConfigurator Before Save

The ‘*’ before the File system name indicates that the information has not yet been saved.

5. Click File > Save to save this information. Figure 13.6 Agent Configurator After Save

182

► To edit a File System to be monitored:

You can edit file system information which has been already added in the Agent Configurator dialog by double clicking on the filesystem to be edited or selecting that required Filesystem and then click on Configuration > Edit option.

Figure 13.7 Edit Filesystem Information

You can clear the selected entries by pressing delete key or using Configuration > Clear menu option.

Configuration > Select All menu option enables you to select all the entries in the list.

!

CAUTION: The condition, where no (valid) filesystems are specified in the list and “Scan All Local Filesystems” option is unchecked, is an invalid configuration. In this configuration, SSM will not update data for this Space Agent.

► To add a Folder to be excluded from monitoring:

You can specify the snapshot folder in a filesystem which can be excluded from monitoring by checking the Exclude Snapshot Folder option and specifying the path of the snapshot folder to be excluded in the Snapshot Folder Name text box.

183

Figure 13.8 Adding Exclude Snapshot Folder

The snapshot folder ‘D:\Snapshot’ will be skipped when executing a Folder Capacity Update or a File Data Update.

13.2.3 Folder Tab You can specify the list of folders in the Folder tab for which information need to be collected during Folder Capacity Update by Space Agent and to be listed in Folder view of Softek Storage Manager Console. By default, Sapce Agent will collect information for all top level folders of selected filesystems (specified in FileSystem tab). The check box Scan All top level Folders is ‘on’ by default.

The information collected for these folders will be displayed in Folder View of Softek Storage Manager Console.

If you uncheck the box Scan All top level Folders, then Space Agent will collect information (and then can be listed in Console’s Folder view) only for the folders listed in the Folder tab during Folder Capacity update.

If you check the box Exclude other folders of all local disks from scanning, then Space Agent will not collect information for files & folders which does not belong to the listed folders & their subfolders, by limiting it’s scanning to the listed folders & their subfolders only.

NOTE

When Scan all top level folders option is checked, then other option Exclude other folders of all local disks from scanning is disabled. Checking Exclude other folders of all local disks from scanning limits Space Agent to collect information of files & folders belonging to the Specified folders and their subfolders only, during File Data Update. Otherwise, Space Agent collects information for all the files and folders in the specified file systems.

184

► To add a folder to the folder list to be monitored:

1. Double Click on any blank row in Agent Configurator (Folder tab) window shown in Figure 13.1 (after unchecking the box Scan All top level Folders)

Folder Configuration Dialog box is displayed as shown in Figure 13.9. Figure 13.9 Add Folder Information

2. Click on the Browse button to select the folder to be monitored.

A new dialog for choosing the folder will be displayed as shown in Figure 13.10.

185

Figure 13.10 Browse For Folder

3. Browse and select the folder to be monitored. On Click of “OK” the “Browse For Folder” dialog will close and the full path of the selected folder will be displayed in the “Folder Path” as shown in Figure 13.11.

Alternately, you can type the entire path of the folder in the “Folder Path”. Figure 13.11 Adding Folder Name with Path

4. Click OK button in the “Folder Configuration” dialog box.

5. The newly added folder information will be listed in SSM Agent Configurator window.

186

Figure 13.12 Agent Configurator Before Save

The ‘*’ before the folder path indicates that the information has not yet been saved.

5. Click File > Save to save this information. Figure 13.13 Agent Configurator After Save

187

► To edit a folder in the folder list to be monitored:

1. You can edit information of a folder which has been already added in the Folder tab Agent Configurator window. To do this you can either double click on the folder to be edited or you can select that required folder path and then click on Configuration > Edit option.

Figure 13.14 Edit Folder Information

The Folder Configuration dialog box will be displayed with the selected folder path as shown in the figure below.

Figure 13.15 Modifying Folder Name using Edit Option

188

2. To change the Folder Path you can either edit the folder path or you can use the browse button to the select the required folder. You can clear the selected entries by pressing delete key or using Configuration > Clear menu option.

A confirmation dialog will appear for clear action as given below. Figure 13.16 Confirmation Dialog

Configuration > Select All menu option enables you to select all the entries in the list.

189

13.2.4 Configuring in Windows Cluster environment In a cluster environment the Agent Configurator provided is as shown in the figure :

Figure 13.17 Cluster Agent Configurator

In addition to the above options and operations provided, an option “Scan All Cluster Filesystems” is provided in the Filesystems tab of the Agent Configurator.

In order to scan the entire cluster Filesystems select the option “Scan All Cluster Filesystems” and click on File > Save. When this option is set, the scanning will be done for the all the cluster filesystems.

When “Scan all Cluster Filesystems” is unchecked, scanning will be done only for the cluster Filesystems which are configured in the Space Agent Configurator.

NOTE

This option is used for Folder Capacity Update, File System Capacity Update and File Data Update. By default the option “Scan All Cluster Filesystems” is selected.“Scan All Cluster Filesystems” checkbox will be available only in the cluster environment. “Scan All Top level Folders” and “Exclude other folders of all local disks from scanning” options will be common for both Local and Cluster Space Agents.

190

13.3 Space Agent Configuration for UNIX Softek Storage Manager provides for configuring the folders and file systems that need to be monitored for Unix Space Agents too. The options for the Filesystems and folders are set in the Space Agent Configuration file. This file is provided along with the UNIX Space Agent.

An Agent Configuration file called AgentConfiguration.cfg is used for specifying the folders and file systems for which the Space Agent need to collect information on managed UNIX Servers.

In the Agent Configuration file, you can specify the list of file systems & folders for which information needs to be collected.

13.3.1 UNIX Agent Configuration File. You can specify the file systems and folders for which information need to be collected by Space Agent and the Snapshot folder to be excluded from monitoring by editing the AgentConfiguration.cfg file.

On your Softek Storage Manager Unix Space Agent machine, the AgentConfiguration.cfg file is present in /opt/SSM/SpaceAgent/config folder.

The AgentConfigurator.cfg file will be created during installation with the following default values.

######################################

# Agent Configurator List for SpaceAgent

#

# Hash indicates comments

#

#Syntax:

#

# FOLDER=(<absolute-path-of-folder>)

# FILESYSTEM=<mount-point>

#

########################################

ScanAllTopLevelFolders = 1

ExcludeOtherFolders = 0

ScanAllLocalFileSystems = 1

SnapshotFolderName=/home/user1/snapshot

The table below lists all the default configuration parameters and their values. The default value also indicates the value which will be assumed in the absence of the parameter in the configuration file.

191

Configuration Option Description Default

Value

ScanAllTopLevelFolders When enabled, this option will ensure that during a folder capacity update, information regarding all the top level folders in all the specified file systems will be collected by

city update. The allowed values are

Spacee Agent. When disabled, only the information for the specified folders will be collected during folder capa0 (disable) and 1 (enable).

1

ExcludeOtherFolders

date

canned. However, folder capacity update

0 When set, this option ensures that during a file data update, only the configured folders will be scanned. The allowed values are 0 (disable) and 1 (enable). When the value is zero, during file data upall folders & files of selected filesystems will be swill not be affected by this flag. During folder capacity update only the configured folders will be scanned always.

ScanAllLocalFileSystems

1

1 When enabled, this option will ensure that all the local Filesystems will be scanned. When disabled only the specified file systems will be scanned. The allowed values are 0 (disable) and(enable).

SnapshotFolderName n the snapshot folder with the absolute

r can be configured to

Not cable

Mentiopath that needs to be excluded from monitoring. Only one snapshot foldebe excluded.

appli

FOLDER= the folders with the absolute path that tored. applicable

Mention need to be included to be moni

Not

Repeat line for each folder.

FILESYSTEM= Mention the mount-point that needs to be included in scanning. Repeat line for each file system.

Not applicable

13.1. NIX Space Agent machine, open the

2. Add the following entry to the AgentConfiguration.cfg file:

FILESYSTEM=<mount_point>

(Where ' mount_point' represents a path where a local or NFS Filesystem is mounted.)

3.2 Configuring FileSystems for scanning: On your Softek Storage Manager U

/opt/SSM/SpaceAgent/config/AgentConfiguration.cfg file.

192

Example Following is an example of a AgentConfiguration.cfg file with mount point entries for '/export/home' and '/home/dev' added:

ScanAllTopLevelFolders = 1

ExcludeOtherFolders = 0

ScanAllLocalFileSystems = 0

FILESYSTEM=/export/home

FILESYSTEM=/home/dev

NOTE

When the option ScanAllLocalFileSystems is enabled, Space Agent will collect information for all supported local file systems (it will not collect information for NFS file systems). You need to specify the NFS filesystems for which the Space Agent need to collect information as separate lines for each file system in the configuration file (as FILESYSTEM=<mount_point>). The condition where no (valid) filesystems are specified in the Filesystem list and “Scan All Local Filesystems” option is disabled is an invalid configuration. In this configuration, SSM will not update data for this Space Agent.

13.3.3 Configuring Folders for scanning: 1. On your Softek Storage Manager UNIX Space Agent machine, open the

/opt/SSM/SpaceAgent/config/AgentConfiguration.cfg file.

2. Add the following entry to the AgentConfiguration.cfg file: FOLDER=(<folder_path>)

(Where 'folder_path' represents a valid folder path on the local system or a NFS filesystem)

Example Following is an example of a AgentConfiguration.cfg file with folder entries for '/export/home/unix' and '/home/dev/source’ added:

ScanAllTopLevelFolders = 0

ExcludeOtherFolders = 0

ScanAllLocalFileSystems = 1

FOLDER=(/export/home/unix)

FOLDER=(/home/dev/source)

NOTE

When ScanAllTopLevelFolders is disabled and no folders are configured, then during a Folder Capacity Update no folders will be scanned. When ExcludeOtherFolders is enabled and no folders are configured, then during a File Data Update no folders will be scanned. When ScanAllTopLevelFolders = 1, then the option ExcludeOtherFolders will be ignored.

193

13.3.4 Configuring Snapshot Folder to be excluded: 1. On your Softek Storage Manager UNIX Space Agent machine, open the

/opt/SSM/SpaceAgent/config/AgentConfiguration.cfg file.

2. Add the following entry to the AgentConfiguration.cfg file: SnapshotFolderName=(<snapshot_folder_path>)

(Where 'snapshot_folder_path' represents a valid snapshot folder path to be excluded from monitoring on the local system or a NFS filesystem)

Example Following is an example of a AgentConfiguration.cfg file with folder entries for '/export/home/unix' and '/home/dev/source’ added:

ScanAllTopLevelFolders = 0

ExcludeOtherFolders = 0

ScanAllLocalFileSystems = 1

FOLDER=(/export/home/unix)

FOLDER=(/home/dev/source)

13.3.5 Configuring in Cluster Environment In addition to the above options and operations provided, an option “Scan All Cluster Filesystems” can be set in the AgentConfiguration.cfg file for monitoring Cluster Filesystems and folders (in PrimeCluster environment on Solaris).

The AgentConfiguration.cfg file is a sample format of the file for cluster system: ######################################

# Agent Configurator List for SpaceAgent

#

# Hash indicates comments

#

#Syntax:

#

# FOLDER=(<absolute-path-of-folder>)

# CLUSTERFOLDER=(<absolute-path-of-folder>)

# FILESYSTEM=<mount-point>

# CLUSTERFILESYSTEM=<mount-point>

########################################

ScanAllTopLevelFolders = 1

ExcludeOtherFolders = 0

ScanAllLocalFileSystems = 1

ScanAllClusterFileSystems = 0

194

The table below lists the additional configuration parameters that are provided for Cluster:

Configuration Option Description Default Value

ScanAllClusterFileSystems When set, this option will ensure that all the cluster Filesystems will be scanned. The allowed values are 0 (disable) and 1 (enable).

1

CLUSTERFOLDER= Mention the cluster folders with the absolute path that need to be included to be monitored. Repeat for each cluster folder.

Not applicable

CLUSTERFILESYSTEM= Mention the mount-point that needs to be included in scanning. Repeat for each cluster file system.

Not applicable

13.3.6 Configuring Cluster FileSystems for scanning:

1. On your Softek Storage Manager UNIX Space Agent machine, open the

/opt/SSM/SpaceAgent/config/AgentConfiguration.cfg file.

2. Add the following entry to the AgentConfiguration.cfg file:

CLUSTERFILESYSTEM=<mount_point>

(Where ' mount_point' represents a path where a cluster Filesystem is mounted.)

Example Following is an example of a AgentConfiguration.cfg file with mount point entries for '/cluster1' and '/cluster2’ are added:

ScanAllTopLevelFolders = 1

ExcludeOtherFolders = 0

ScanAllLocalFileSystems = 1

ScanAllClusterFileSystems = 0

CLUSTERFILESYSTEM=/cluster1

CLUSTERFILESYSTEM=/cluster2

NOTE

When “Scan all Cluster Filesystems” is disabled and no cluster filesystems are specified in the Agent Configuration.cfg file, then no cluster filesystems will be scanned. In this configuration, SSM Console will display the last scanned cluster filesystems.

195

13.3.7 Configuring Cluster Folders for scanning: 1. On your Softek Storage Manager UNIX Space Agent machine, open the

/opt/SSM/SpaceAgent/config/AgentConfiguration.cfg file.

2. Add the following entry to the AgentConfiguration.cfg file: CLUSTERFOLDER=(<folder_path>)

(Where 'folder_path' represents a valid folder path on the cluster filesystem)

Example Following is an example of a AgentConfiguration.cfg file with folder entries for '/cluster1/unix' and '/ cluster1/source’ added:

ScanAllTopLevelFolders = 1

ExcludeOtherFolders = 0

ScanAllLocalFileSystems = 1

ScanAllClusterFileSystems = 0

CLUSTERFOLDER=(/cluster1/unix)

CLUSTERFOLDER=(/cluster1/source)

13.4 Agent Configuration Matrix

Below is a Matrix to explain significance of the flags “ScanAllTopLevelFolders” and

“ExcludeOtherFolders”.

ExcludeOtherFolders -Enabled ExcludeOtherFolders -Disabled

ScanAllTopLevelFolders –Enabled

This case is not possible When a folder capacity update command is issued, all the top level folders will be scanned. When a file data update command is issued, all the configured file systems will be scanned for file data.

ScanAllTopLevelFolders –Disabled

When a folder capacity update command is issued, only the configured folders will be scanned. When a file data update command is issued, only the configured folders will be scanned for file data. .

When a folder capacity update command is issued, only the configured folders will be scanned. When a file data update command is issued, all the configured file systems will be scanned for file data.

196

14

Integration with Systemwalker Resource Coordinator

• 14.1 Introduction 199

• 14.2 Settings required on the Softek Storage Manager machine 200

• 14.3 Configuration for Event Log Output 201

197

198

14.1 Introduction Systemwalker Resource Coordinator (also known as Resource Coordinator) is a product which aims to centrally co-ordinate IT resources across the enterprise. Now in conjunction with Softek Storage Manager, Resource Coordinator can also monitor storage resources within an enterprise.

Softek Storage Manager monitors storage resources based on threshold values defined for the respective storage resources. In case Softek Storage Manager detects that the threshold value defined for the storage resource has been crossed, it raises an event which is output in the Windows Event Log.

Resource Coordinator can now monitor the above events and accordingly alert the Administrator using Resource Coordinator. This is done as shown in the figure below.

Figure 14.1 Interaction between SSM and Resource Coordinator

RC-Manager

RC-Agent

SSM-Server

Event Log

Application Server / Database Server

SSM-Agent

Threshold Crossed

Space Information Event Output

Monitor Event

Notify Event

Database

RC Client

RC-Agent

SSM Console

RC : Resource Coordinator, SSM : Softek Storage Manager

[*1] Depending on whether RC Agent can be installed on a machine

along with SSM Agent the behavior is as specified in below table

Function If Installed If not installed

A warning appears in the event area of the RC screen Y Y

A warning appears in the event area of the RC screen Y Y

Display icon of Administrative Server on RC screen Y N

Y;Yes

N:No

Please refer to the “Systemwalker Resource Coordinator Installation Guide” for the list of supported OS.

199

The Administrator on being alerted can investigate for further by details by being able to launch the Softek Storage Manager console from within the Resource Coordinator console

In order for Resource Coordinator to integrate smoothly with Softek Storage Manager the following needs to be done: Install the Softek Storage Manager Read only console on the Resource Coordinator Client

machine.

Install the Resource Coordinator Agent on the Softek Storage Manager server machine.

On the server eligible for space monitoring, ensure that either the Softek Storage Manager Space Agent or Softek Storage Manager Symfoware DB Agent is installed. In order to be able to open the Softek Storage Manager Console from Resource Coordinator Client console ensure that Resource Coordinator Agent is also installed on this machine.

Resource Coordinator Agent should be installed on the Monitored Host.

14.2 Settings required on the Softek Storage Manager machine In order for Resource Coordinator to integrate smoothly with Softek Storage Manager the following needs to be done:

For Resource Coordinxator to monitor the events raised by Softek Storage Manager, a definition of which events Resource Coordinator will monitor needs to be specified. This is done using an Event Definition file. Please refer to section 14.2.1 Configuration of Event Definition file

Resource Coordinator monitors the storage resources using their IP Addresses. The event raised by Softek Storage Manager contains the IP Address of the storage resource. However in some cases the storage resource may have more than one network interface. In order for Softek Storage Manager to correctly determine which IP Address is recognized by the Resource Coordinator, the HOSTNAME-IPADDRESS should be specified in Softek Storage Manager. The above is specified in the INI file provided by Softek Storage Manager. Please refer to section 14.2.2 Configuration for HOSTNAME-IPADDRESS.

To ensure that Softek Storage Manager raises the event when a threshold value for a storage resource is exceeded, please refer to section 14.2.3 Configuration for Event Log. Output.

14.2.1 Configuration for Event Definition file For Resource Coordinator to analyze the event log output by Softek Storage Manager, Event definition file (XML trap definition) should be copied to the Resource Coordinator's trap XML storage directory. The XML trap definition file can be located in the following location:

“<Softek Storage Manager Installation CD>\File For RC\1_3_6_1_4_1_211_4_1_3_21_2_101.xml”.

The trap XML directories for Resource Coordinator agent and Resource Coordinator manager are specified below.

Resource Coordinator Agent: Windows (Set Directory for Resource Coordinator)\Agent\etc\snmpth

Resource Coordinator Manager: Solaris /etc/opt/FJSVssmgr/current/snmpth Windows (Set Directory fir Resource Coordinator)\manager\etc\san\engine\snmpth

200

14.2.2 Configuration for HOSTNAME-IPADDRESS SSM uses hostnames to identify the machines where as Resource Coordinator uses IP Address. SSM has to convert the hostname to IP Address before it posts a message for that machine into event log so that Resource Coordinator can identify the machine for which the event log message is posted.. SSM uses the hostname to get the IP Address of the machine. If a machine has multiple IP Addresses, the IP Address got by SSM could be different from the IP Address used by Resource Coordinator. In order to resolve this multiple IP Address problem, an entry should be made in the Server Configuration file under HOSTNAME-IPADDRESS section as shown.

[HostName-IPAddress] MyComputer1.domain.com = 123.125.117.118 MyComputer2.domain.com = 123.125.117.120

The Server Configuration file can be located at the following location:

<SSM Installation Directory>\Storage Manager\Space Manager\SSMServer.ini.

Following steps are followed by SSM while converting hostname to IP Address,

1) SSM looks up the SSMServer.ini file for HostName-IPAddress pair.

2) If the hostname is found then SSM uses the corresponding IP Address for that host.

3) If the hostname is not found in the INI file then SSM looks up the local ‘hosts’ file for IP Address.

4) If it is not found in ‘hosts’ file then the IP Address is requested from DNS server and IP Address returned by the DNS server is used by SSM.

5) If DNS does not return the IP Address then ‘’ (blank) is used in place of IP Address.

NOTE

• In case the IP Address of the host cannot be resolved, Resource Coordinator will change the colour of the icon which corresponds to Softek Storage Manager Server.

Even in this case it is possible to invoke the Softek Storage Manger Console from the event which has been logged in the Resource Coordinator Event screen.

• Entry in the INI file has to be made for those hosts which satisfy one of the following conditions:

• The host has multiple IP Addresses. • The host can not be identified by its hostname in the network. i.e. if “ping

<hostname>” from SSM Server machine fails saying “Unknown host <hostname>”. Please use the IP Address used by Resource Coordinator.

14.3 Configuration for Event Log Output For generating Windows Event Log follow these steps:

Steps for creating Filesystem Threshold cross Event Log message:

1. Create a Server Action Set (refer to “Creating Action Sets, Chapter 5”).

2. Go to “Actions” Tab.

201

3. In Capacity update segment specify some threshold filter for the Action Rule. Threshold filter is filter associated with space usage.

4. Select “Send To Event Log” option for the Action Rule.

Steps for creating Tablespaces Threshold cross Event Log message:

1. Create a Database Action Set (refer to “Creating Action Sets”).

2. In the Actions tab, select “Tablespaces” as a target for “Actions On”.

3. In Database Configuration Update segment specify some threshold Filter condition for the Action Rule. Threshold filter is filter associated with space usage.

4. Select “Send To Event Log” option for the Action Rule.

Whenever that Action Set is executed and there are Filesystems or tablespaces that satisfy that Action Set, an event log entry of type “Warning” is created.

To control the frequency of event log generation user can specify the interval (in minutes) in the configuration file. For e.g.:

[EventLog] LoggingFrequency = 60

Once an event log entry is created for a particular server, the next event log entry will be created after the interval specified in configuration file has elapsed. Even if that particular action rule has executed in between no event will be created.

202

15

Logs

• 15.1 Logging in Windows 205

• 15.2 Logging in Unix 207

• 15.3 Default values for configurable parameters 208

• 15.4 Rotation Mechanism 209

• 15.5 Investigation material 209

• 15.6 Sample initialization and configuration files 210

203

204

15.1 Logging in Windows The logging mechanism enables the user to obtain the trace of the execution of the various components in SSM. The log files generated as a result of enabling the tracing facility allows the user to observe the execution steps of a module thus facilitating debugging in case of problems.

15.1.1 Event Logging It is often necessary to inform the user or the administrator of specific events during the execution of a component. This may not be very specific to the internals of the component execution, but would serve as information, warnings or errors related to the general component execution. General information, warning or errors during trace logging will be informed to the user or the administrator in the Windows event log. An example of such an event would be the absence of the initialization file in which the user is allowed to set trace log related parameters. When the absence of the initialization file is detected by any module which uses the parameters for tracing, this information is written into the event log before proceeding with default values for the parameters.

15.1.2 Trace Logging Trace log files are created by individual SSM components. These log files contain the trace of program steps during the execution of a component. This enables the user to identify possible error locations during component execution. The user can configure the trace level, the size of each trace log containing the trace information and the location where these logs shall be stored.

Initialization files for configuring log parameters There are three initialization files available - SSMServer.ini, SSMAgent.ini and SSMSymfoAgent.ini. The location of the initialization files are as follows –

• [SSM Installation Path]/SSMServer.ini • [SSM Installation Path]/SSMAgent.ini • [SSM Installation Path]/SSMSymfoAgent.ini

Configuring trace log parameters Initialization files consist of sections and key name - key value combinations. Each section in the initialization file corresponds to each component name whose execution is to be traced. Each key name within the section indicates the configurable parameter to control logging, whose value can be set by the user. An illustration of a section and its contents for the Data Collector module is as follows: [Data Collector] LogLevel=1 LogSize=500 LogPath=C:\SSM\Logs SpcomLogSize=100 This format is repeated for each component whose trace needs to be collected. SSMServer.ini is typically used to configure trace logging parameters for Server side components like Data Collector, Action Set Engine etc. SSMAgent.ini is used to configure trace logging parameters for Space Agent. SSMSymfoAgent.ini is used to configure trace logging parameters for the Symfoware DB Agent component.

205

In case of the Process Monitor component which could reside on the Server side and the Agent side, its trace logging parameters can be set in all the three initialization files. However, in a situation where the server components, agent components and Symfoware DB Agent co-exist on the same machine, the Process Monitor trace log parameters settings in the SSMServer.ini will be considered in priority. In the absence of SSMServer.ini file, the settings will be read from SSMAgent.ini and then SSMSymfoAgent.ini in the order of priority. In the absence of all these files, default values will be considered.

Configuring Log Level Log Level determines the detail of trace of execution that the user would like to capture to help debugging. Log Level can be configured in the initialization file against the LogLevel key name in each section. Log Level is typically set to a value between 0 and 4.The user can switch off logging by setting log level to 0. Setting non-numeric values will result in logging being switched off. Setting invalid or no values for log level will result in default log level being considered.

Configuring Log Size Log Size determines the maximum size of each trace log file being created for a component. Once this size is exceeded, subsequent trace information is captured in a new file. The rotation mechanism ensures that a maximum of 10 trace log files of the specified size are created. Log Size can be configured in the initialization file against the LogSize key name in each section. Log Size is to be specified in kilobytes (KB). Log Size for Spcom trace logs for the Data Collector and the Space Agent components can be configured against the SpcomLogSize key name in the corresponding sections. Setting invalid or no values for log size will result in default log size being considered. Configuring Log Path Log Path determines the destination of the trace logs created during execution. Log Path can be configured in the initialization file against the LogPath key name in each section. The user can set either relative or absolute path. Relative path will be considered relative to the installation location. Log path should be valid and should exist. Invalid or no settings for log path will result in the default path (installation path) being considered.

NOTE • In case of cluster SpaceAgent and cluster Process Monitor, there are separate sections in the respective initialization files. Log files formed will be named ModuleName_CLS_n.log. (E.g. SpaceAgent_CLS_0.log)

• For log parameters changes to be effective, the respective components have to be restarted.

206

15.2 Logging in Unix

15.2.1 Syslog Logging It is often necessary to inform the user or the administrator of specific events during the execution of a component. This may not be very specific to the internals of the component execution, but would serve as information, warnings or errors related to the general component execution. General information, warning or errors during trace logging will be informed to the user or the administrator in the syslog. An example of such an event would be the absence of the configuration file in which the user is allowed to set trace log related parameters. When the absence of the configuration file is detected by any module which uses the parameters for tracing, this information is written into the syslog before proceeding with default values for the parameters. In Solaris, syslog information is captured in /var/adm/messages. In HP-UX, syslog information is captured in /var/adm/syslog/syslog.log In Linux, syslog information is captured in /var/log/messages.

15.2.2 Trace Logging

Trace log files are created by individual SSM components. These log files contain the trace of program steps during the execution of a component. This enables the user to identify possible error locations during component execution. The user can configure the trace level, the size of each trace log containing the trace information and the location where these logs shall be stored.

Configuration files for configuring log parameters There are two configuration files available – SpaceAgent.cfg and SymfoAgent.cfg. The location of the configuration files are as follows –

• /opt/SSM/SpaceAgent/config/SpaceAgent.cfg • /opt/SSM/DBAgent/config/SymfoAgent.cfg

Configuring trace log parameters User configurable parameters to control trace logging are set in the configuration files available in config folders in the location where the component is installed. Configuration files consist of key name – key value pairs. Each key name in the configuration file indicates the configurable parameter to control logging, whose value can be set by the user. An illustration of the contents of the configuration file for the Space Agent module is as follows: LOG_LEVEL=1 LOG_SIZE=500 LOG_PATH=/opt/SSM/SpaceAgent/logs SPCOM_LOG_SIZE=100 The location of the configuration file for the SpaceAgent module is /opt/SSM/SpaceAgent/config. The location of the configuration file for the Symfoware DB Agent module is /opt/SSM/SymfoAgent/config. Configuring Log Level

207

Log Level determines the detail of trace of execution that the user would like to capture to help debugging. Log Level can be configured in the configuration file against the LOG_LEVEL key name. Log Level is typically set to a value between 0 and 4. The user can switch off logging by setting log level to 0. Setting invalid or no values for log level will result in default log level being considered. Configuring Log Size Log Size determines the maximum size of each trace log file being created for a component. Once this size is exceeded, subsequent trace information is captured in a new file. The rotation mechanism ensures that a maximum of 10 trace log files of the specified size are created. Log Size can be configured in the configuration file against the LOG_SIZE key name. Log Size is to be specified in kilobytes (KB). Log Size for Spcom trace logs for the Space Agent component can be configured against the SPCOM_LOG_SIZE key name in the configuration file. Setting invalid or no values for log size will result in default log size being considered. Configuring Log Path Log Path determines the destination of the trace logs created during execution. Log Path can be configured in the configuration file against the LOG_PATH key name. The user can set either relative or absolute path. Relative path will be considered relative to the config folder where the configuration file exists. Invalid or no settings for log path will result in the default path (logs folder in the component installation location) being considered.

NOTE • In case of cluster space agent, the logging parameters can be specified in the ClusterSpaceAgent.cfg file whose path is specified in the SpaceAgent.cfg file. Log files formed will be named ModuleName_CLS_n.log. (E.g. SpaceAgent_CLS_0.log)

• For log parameters changes to be effective, SpaceAgent and SymfoAgent have to be restarted.

• If no parameter or incorrect parameter is specified for SpaceAgent on Unix, the corresponding configuration file settings are overwritten with default values.

15.3 Default values for configurable parameters The default log level for all the components on both Windows and Unix is 1. The default log sizes for components vary as specified below:

208

Component Default Log Size (KB) Maximum Size occupied (Default LogSize * 10)

Process Monitor 100 1000 Action Set Engine 500 5000 Data Collector 500 5000 Space Agent 100 1000 Console 500 5000 DBSupervisor 200 2000 Custom Command Supervisor 200 2000 SymfoAgent 100 1000 Reports 50 500 Spcom for Data Collector 100 1000 Spcom for Space Agent 100 1000 24500

NOTE In the maximum condition of 10 logs having been created for each component and each log having achieved its maximum default size, the total space occupied will be 24.5 MB.

The default log path for Windows and Unix components is the logs folder in the installation path.

15.4 Rotation Mechanism The first log file for each component is always formed with a 0 index (example – Data_Collector_0.log). When the size of this log achieves the value specified by the user in the log size parameter, the contents of this file are copied to a new file with a 1 index. This mechanism continues with contents of logs with a given index number being moved into a new file with the next index number whenever the 0 indexed log reaches its maximum capacity. The maximum number of such files which can exist is 10 with rotation occurring in the range 0 to 9. When the maximum number of files is reached, if the 0 indexed log reaches maximum size, the file with index 9 is deleted and the contents are moved down the index order. The log file with an index of 0 always contains the latest contents. In the Console module, the mechanism differs. Whenever the Console is invoked, a new log file is created with the latest index. The size of the log file for that session is determined by the log size setting. In a situation where 10 logs already exist and the Console GUI is invoked, the log with the least index value will be deleted. The latest log will be the one with the maximum index number. Thus, rotation is not restricted to the range 0-9 but can be between 1-10, 2-11 etc.

15.5 Investigation material To investigate during error situations, the following are required for analyzing the problem.

• All log files. If the user has not modified the path in the initialization or configuration file, logs will be available in

- [SSM Installation Path]/Logs in Windows - /opt/SSM/[SpaceAgent or DBAgent]/logs in Unix

Otherwise, the logs will be formed in the path specified by the user. • Exported Event Application and System logs in Windows. • Syslog contents in Unix.

209

15.6 Sample initialization and configuration files SSMServer.ini [Console] LogLevel=1 LogSize=500 LogPath=.\Logs [DataCollector] LogLevel=1 LogSize=500 LogPath= .\Logs SpcomLogSize=100 [ASE] LogLevel=1 LogSize=500 LogPath= .\Logs [SProcessMonitor] LogLevel=1 LogSize=100 LogPath= .\Logs [Reports] LogLevel=1 LogSize=100 LogPath= ..\Storage Manager\Space Manager\Logs [DBSupervisor] LogLevel=1 LogSize=200 LogPath= .\Logs [Custom Command Supervisor] LogLevel=1 LogSize=100 LogPath= .\Logs SSMAgent.ini [SpaceAgent] LogLevel=1 LogSize=100 LogPath= .\Logs SpcomLogSize=100 [SProcessMonitor] LogLevel=1 LogSize=100

210

LogPath= .\Logs SSMSymoAgent.ini [SymfoAgent] LogLevel=1 LogSize=100 LogPath= .\Logs [SProcessMonitor] LogLevel=1 LogSize=100 LogPath= .\Logs SpaceAgents.cfg SMS_NAME = 1.2.3.4 SMS_PORT = 3222 LOG_LEVEL = 1 LOG_SIZE = 100 LOG_PATH = /opt/SSM/SpaceAgent/logs/ SPCOM_LOG_SIZE = 100 SymfoAgent.cfg LOG_LEVEL = 1 LOG_SIZE = 100 LOG_PATH = /opt/SSM/SymfoAgent/logs/ INSTANCE = ssmsymfo SCAN_FREQUENCY = 100000

211

212

Glossary

A Action:

Event triggered by a condition. Agent:

Executable program that provides information to Softek Storage Manager.

Archive: Process of moving data to another storage media.

Automation: Executing routine and repetitive actions in self-operating mode, or without user intervention.

D Database:

Repository for common data that can be used by multiple applications.

DSI: Data Structure instance. It is a storage structure for base tables in Symfoware. It expresses a mapping to the database space.

F FIFO:

First In, First Out.

I Instance:

Each installation of the database engine is called an instance. Each instance has its own system and user databases which are not shared across instances.

M Managed Server:

A server that has a Storage Manager Agent installed and its storage pool managed by the SMS.

Metadata: Database term used to refer to data that describes other data.

N NAS:

Network-Attached Storage.

P Paging File:

A hidden file on the hard disk that Windows uses to hold parts of programs and data files that do not fit in memory. The paging file and physical memory, or RAM, comprise virtual memory. Windows moves data from the paging file to memory as needed and moves data from memory to the paging file to make room for new data. Paging file is also called a swap file.

Policy: A set of actions that will be carried out when a specified condition is met.

R Report Engine

Tool to generate graphical reports. Storage Manager uses Softek Reporter.

S SAN:

Storage Area Network. SMS:

Storage Management Server. Server upon which the Storage Manager product is installed.

Space Agent: An Executable program that is installed on a server, collects specified file level and file system data upon instructions from the Storage Management Server.

Storage Area Network (SAN) A network whose primary purpose is the transfer of data between computer systems and storage elements and among storage elements. Abbreviated SAN. A SAN consists of a communication infrastructure, which provides physical connections, and a management layer, which organizes the

213

T connections, storage elements, and computer systems so that data transfer is secure and robust. The term SAN is usually (but not necessarily) identified with block I/O services rather than file access services.

Topology: Physical configuration using nodes and cables when connecting local area network equipment.

SymfoAgent: V An executable program running on the machine

where the Symfoware DB server to be monitored is installed. It collects metadata information about the Symfoware databases.

Vulnerable Files: Files that are modified but not backed up at the time of the last file update.

214

215

216