Objectivity/DB Administration : Index
Index
Numerics
32-bit vs. 64-bit architecture, space requirements for objects 54
A
access permissions
AMS 27, 109
Assist 80
container files 93
database file 88
file and directory 27
lock server 27, 99, 144
access status
containers 92
schema 35
AddIndex tool reference 243, 247
AddKeySpecification tool reference 249
add-only policy, importing 156
AddStorageLocation tool 64, 67, 68
AddStorageLocation tool reference 250
administration tools, see specific tool names
Advanced Multithreaded Server, see AMS
AMS
access permissions 27
account requirements 109
changing TCP/IP port
UNIX and Macintosh 110
checking if running 190
guidelines for choosing 108, 164
output on Windows 110
remote data files 22
setting network timeout period 111
specifying files 30
starting 231
Macintosh 109
UNIX 109
Windows 109
StopAms 109
stopping 109, 238
timeout errors 111
using as data server software 107
Any selection policy
database placer 61
applications
failures, recovery from 138, 146
processes 19
rehosting 167
application-specific classes 150
application-specific location preferences 59
architecture
see also Macintosh
see also UNIX
see also Windows
32-bit vs. 64-bit 54
components 22
disk format 168
storage pages, changing 172, 195
arguments, tools 180, 181
Assist
access permissions 80
transaction model 80
attributes, see properties
automatic recovery, see recovery
B
Backup
see also ootapebackup
see alsobackup
backing up federated database 122
example 122
backup set 135
compress backup files 128
Tidy 122
tool reference 183
backup
see also Backup
basic 115
basics 116
before software upgrade 120
boot file 119, 186, 230
customized 116
database corruption 122
deleting backup set 127
diary 118
events
defined 116
displaying history 126
failures 122
federated database 183
full 116
history, obtaining 126
incremental 116, 130
levels
about 130
basic and customized 131
descriptions 116
medium 116, 129
performing 122, 134
processing volumes during 127
querying a backup set 126, 226
schedules
example 121, 132
guidelines 121, 132
sets
creating 134, 199
customized backups 129
defined 117
deleting 127, 202
querying 126
subincremental 116
tools for 177
user access during 118
volume 129
backupBootFilePath 119
batch commands, executing 211
boot file
about 19
backup 119, 186, 230
federated database 16, 19
location 34, 165
maintaining multiple 165
name
format for automatic recovery 144
bootFilePath
format 28
specifying 19
buffer pages 20
C
cache, see Objectivity/DB cache
case sensitivity 32
catalog
database containers 85
global, see global catalog
ChangeFd
changing lock-server hosts 100
changing schema policy 42
listing properties 36
moving federated database resources 42
tool reference 186
CheckAms
checking AMS 108
tool reference 190
CheckLs
checking lock server 98
tool reference 191
CheckRESTServer
tool reference 192
classes
exporting
schemas 212
importing
duplicating schemas 156
operation output 155, 156
populated schema 157
schema compatibility 156
internal 150
CleanupFd
configuring to perform recovery 141
example 147
listing transactions with locks 50
releasing transactions 100
tool reference 192
client hosts
about 22, 161, 165
boot file location 165
failure monitoring 139
failures, recovery from 138, 147
NFS files 30
setting up 165
configuration file
location preferences 72
containers
about 17, 91
access status 92
catalog, in database 85
creating 93
embedded
about 18, 91
estimating maximum size 55
external
about 18, 91
access permissions 93
files 18, 91
getting file information 93
restricting file access 93
troubleshooting access 93
identifiers
format 52, 92
out of range 224, 225
maximum number in database 54
number of logical pages 54
properties 92
read-only and read/write 92
storage-page size 92
ConvertFormat
changing architecture 172
tool reference 195
corruption
detecting during a backup 122
restoring after detecting 123
Tidy 48, 88
CreateBackupSet
creating backup set 134
tool reference 199
CreateContainers tool reference 255, 258
CreateFd
duplicating a schema 156
running 38
tool reference 200
D
data files
see also containers
about 18
database 18
Objectivity/DB type 159
properties 86
data packet size, used with NFS 165
data-server host
about 22, 161
configuring 164
summary of platform combinations 166
data-server software
about 22
obtaining data 107
AMS 107, 164
best for automatic recovery 144
choosing 108
local files 22
NFS 107, 164
remote files 22
Windows Network 107, 164
database placers
obtaining storage locations 58
databases
about 17, 85
access permissions 88
catalog of containers 85
defragmenting 88
deleting 87, 204
estimating maximum size 55
files 18, 86
getting
file information 86
identifiers
displaying 87
format 52, 86
maximum number 54
properties
list 86
restricting access 88
storage-page size 86
displaying 87
system name
displaying 87
tidying 88
tools
getting information 177
placement-related tasks 243
troubleshooting access 89
D-C-P-S format 51
DeleteBackupSet
deleting backup set 127
tool reference 202
DeleteDb
deleting databases 87
tool reference 204
DeleteFd
deleting federated database 47
tool reference 205
DeleteIndexSpecification tool reference 260
DeleteKeySpecification tool reference 262
diary, backup 118
directories
journal 18
log 97
Objectivity server 97
disk format
about 168
conversion in memory 169
converting on disk 172, 195
disk-space requirements 52
distributed Objectivity/DB systems
about 22
advantages 162
recovery considerations 144
working with 159
DO
tool reference 206
DO Runner 206
drive letter, mapped 29, 31, 165
DropIndex tool reference 263
DumpCatalog
getting info about external containers 93
listing component files 36
listing database properties 87
tool reference 210
E
embeddable classes
see also storable classes
embedded containers, see containers, embedded
end-user site deployment 45
environment variables
OO_CONNECT_RETRIES 103, 111
OO_NFS_MAX_DATA 166
OO_RPC_TIMEOUT 103, 111
OO_SERVER_LOG_DIR 101
exclusive lock 96
Execute
tool reference 211
ExportPlacement tool reference 265
ExportSchema
duplicating a schema 156, 157
tool reference 212
external containers, see containers, external
F
failures
application 138, 146
client hosts 138, 147
lock server 142, 148
federated database
about 16
backing up 115
boot file
about 16, 19
moving 42
checking consistency 49
converting storage pages
changing ownership 172
ConvertFormat 195
creating
placement-managed 200
planning 38
defragmenting 239
deleting 47, 205
distributed 159
estimating size
considerations 52
maximum 55
exporting
about 46
file 16, 34
filenames 25
fixing consistency 50
getting
file information 36, 214
properties 36
global-catalog information 125
identifiers 34, 51
importing
about 46
installing 45, 216
journal directory
about 34
moving 42
license
about 35
displaying 44, 219
managing 43
updating 44, 219
listing files 36, 210
location preferences 59
lock server 95
lock-server host
about 34
changing 100
main storage group (MSG) 17, 58
maximum size 53
moving 42
non-placement-managed, see non-placement-managed federated database
Objectivity/DB system resources
about 16
distribution on network 159
location properties 34
moving 42
placement-managed 17
properties
changing 41
displaying 36
list 34
querying 206
reference number 51
restoring
failure 126
from backup 123, 135, 227
full restore 117, 132
point of restore 117
processing volumes during 127
specifying restore point 123
to original location 124
user access while 118
schema policy
about 35
changing 42
size
initial 52
maximum 53
storage-page size
about 34
displaying 37
system name 16, 25, 34
system-database file
about 16, 34
moving 42
tasks 33
tidying 47
tools
creating and modifying 175
exporting and importing 176
getting information 177
managing 175
troubleshooting access 49
file storage
about 57
locations, see storage locations
main storage group 17, 58
persistent data 57
FileInfo
getting file names/types 36
getting info about external containers 93
listing database properties 86
tool reference 214
filenames
about 25
case sensitivity 32
extensions used 25
host format 28
journal files 26
spaces in 32
system-database files
federated database 25
files
see also boot file
see also journal files
containers 18, 91
data 18, 159
databases 18, 86
getting type 36, 214
license, setting up 43
listing
federated database 36
names, see filenames
Objectivity/DB 15, 159
permissions, see access permissions
sharing using UNC names 165
specifying local 28
specifying remote
AMS 30
NFS 30
Windows Network 31, 165
system-database
federated database 16, 34
format
see disk format
see host format filenames
full backup 116
G
generated filenames
journal files 26
global catalog
about 17
listing files 36, 210
H
header page for large object 20
host format filenames 28
host, Objectivity/DB 160
I
identifiers
containers 52, 92
databases
format 52
getting 87
D-C-P-S format 51
federated database
about 34
getting 36
referencing objects 51
ImportPlacement tool reference 266
ImportSchema
duplicating a schema 157
tool reference 215
incremental backup 116, 130
InstallFd
installing federated database 46
tool reference 216
intention locks 225
internal classes 150
J
journal directory 18
journal files
about 18
automatic recovery 137
federated database 34
names 26
K
kernel, Objectivity/DB 19, 22
L
large objects 20
latches 224, 225
license
displaying 44, 219
federated database 35
file, setting up 43
managing 43
updating 44, 219
License tool reference 219
ListIndexes tool reference 267
ListOperator
tool reference 221
ListStorage tool 65
ListStorage tool reference 268
ListSystemValues
tool reference 222
ListWait
determining lock server processes 99
getting transaction information 50
tool reference 223
local data 22, 161
local data server, see Objectivity/DB kernel
location preferences
see also storage locations
about 59
application-specific
preferred storage zones 61
representing in configuration file 72
setting up 59
specifying 70
defining 70
example 59
handling unavailability 62
ranking 60
unavailable
entire group 63
specific locations 63
Lock 22
lock file, recovery 148, 195
lock server
about 19
access permissions
about 27
account requirements 99
required for 144
applications cannot connect 105
automatic recovery
initiating 142
changing TCP/IP port
UNIX and Macintosh 102
changing the log directory 100
checking if running 191
crash recovery 148
enabling
automatic recovery at startup 142
recovery monitor thread 139, 233
failures, recovery from 142, 148
host
about 96, 161
changing 100
platform combinations 166
log directory 97
log file 97
output on Windows 102, 110
recovery error log 97
recovery monitor thread 139, 233
setting network timeout period 103
starting
Macintosh 98
problems 103, 104
StartLockServer 233
UNIX 98
stopping 99
problems 99
StopLockServer 238
stopping a lock-server process 99
timeout errors 103
using 95
LockMonitor
determining lock server transactions 99
listing lock server processes 100
tool reference 225
locks
exclusive lock 96
intention lock 225
listing 225
problems 103
read lock 96
update lock 96
log directory 97
logical page
about 20
object identifier (OID) 51
M
Macintosh
starting server
AMS 109
lock server 98
stopping server
AMS 109
lock server 99
main storage group (MSG)
about 17, 58
displaying 65
removing storage locations 67
selecting storage locations 58
setting selection policy 69
manual recovery 145, 192
Microsoft Windows, see Windows
MROW 96
N
network
impact on performance 162
share names 165
timeout period
AMS 111
lock server 103
recovery monitor 140
Network File System, see NFS
NFS
accessing user ID, Windows apps 164
alternative 107
data packet size 165
remote data files 22
specifying files 30
nonstorable classes
schema descriptions 150
O
object identifier (OID)
containers 52, 92
databases 52
D-C-P-S format 51
persistent object 51
Objectivity license, see license
Objectivity servers
AMS 107
lock server 95
tools for managing 175
Objectivity/DB
backup 115
basics 15
cache 20
components 159
files 15, 159
host 160
kernel 19, 22
naming files 27
processes 15, 159
recovery 137
system resources
about 16
distribution on network 159
location properties 34
tools 175, 183, 243
objects
large 20
persistent, see persistent objects
OID, see object identifier
OO_CONNECT_RETRIES environment variable 103, 111
oo_local_host 29, 31
OO_NFS_MAX_DATA environment
variable 166
OO_RPC_TIMEOUT environment
variable 103, 111
OO_SERVER_LOG_DIR environment variable 101
ooams-xx service 110
ools-xx service 102
oorecvr.LCK file 148, 195
options, tools 180, 181
P
packet size, used with NFS 165
pages
buffer 20
header, for large object 20
logical 20, 51
storage, see storage pages
permissions, see access permissions
persistent data, file storage 57
persistent objects
about 17
large 20
physical storage page, see storage pages
placement model 16
placement model documents (PMDs)
changing MSG 69
placement-managed federated databases 17
point of restore
about 117
specifying 123, 135
ports
AMS 109
conflict 101, 109
lock server 101
properties
containers 92
databases
descriptions 86
federated database
changing 41, 186
descriptions 34
listing 36
Q
QueryBackupSet
displaying backup history 126
tool reference 226
R
Random selection policy
database placer 61
read lock 96
read-only containers, restricting access 92
recovery
about 137
application failures 138, 146, 147
automatic 137, 192
boot-file name format 144
client-host failures 138, 147
error log 97
lock file for 148, 195
lock-server failures 142, 148
manual 145, 192
monitor 139, 233
oocleanup failure 148
transaction, example of 147
reference number for federated database, see identifier, federated database
referenceable classes
see also storable classes
rehosting application 167
remote data 22, 161
remote data server, see AMS
RemoveStorageLocation tool 67, 69
RemoveStorageLocation tool reference 269
resources, of federated database 16, 34, 159
REST server
checking 192
starting 236
stopping 239
Restore
example
backup set 135
displaying catalog info 125
path 124
uncompress backup files 128
restoring federated database 123
tool reference 227
return status 23
RoundRobin selection policy
database placer 61
RPC timeout error 166
RPC timeout period, see network, timeout period
S
schedule, backup 121, 132
schema evolution
about 16
permitting 189
schemas
about 16, 149
duplicating 156
exporting 155
ExportSchema 212
federated database policy 42
importing 155
about import operations 155, 156
compatibility 156
compatibility checks 156
loading with import 156
policy 35
restricting access 35
specifying read-only or read/write 42, 189
synchronizing 155
selection policies 58
about 61
example 61
MSG 69
servers
see data-server software
software upgrade
backing up before 120
spaces in filenames 32
start_studio script reference 273
StartAms
manually starting AMS 109
tool reference 231
StartLockServer
delayed automatic recovery 143
enabling recovery monitor 140
manually starting lock server 98
performing automatic recovery at startup 143
tool reference 233
StartRESTServer
tool reference 236
stop_studio script reference 274
StopAms
stopping AMS 109
tool reference 238
StopLockServer
stopping a lock server 99
stopping lock server 99
tool reference 238
StopRESTServer
tool reference 239
storability
classes 150
storable classes 150
storage locations
see also location preferences
about 57
configuring selection process 59
managing 65
naming or renaming 67
number in storage zones 68
preferred 70
registering 58, 64
removing from MSG 67
removing from storage zones 69
selecting 58
selection policies 58, 61
storage zones 61
unavailable 62
storage pages
about 20
disk format
about 168
converting 195
owning architecture
about 168
changing 172
size
about 20
container property 92
database property 86
displaying 37, 87
federated-database property 34
maximum and minimum 54
storage-unavailable policies
setting 73
storage locations 63
storage zones
about 61
managing 68
removing storage locations 69
setting up 68
subincremental backup 116
system classes 150
system-database file
federated database 34
of federated database 16
system name
see federated database
T
TCP/IP
configuration problems 105
port
AMS 109
conflict 101, 109
lock server 101
Windows 160
Tidy
backup and 88
guidelines for using 48
tidying federated database 47
tool reference 239
timeout period, network 103, 111
tools
see also specific tool names
abbreviating options 180, 181
classic command-line syntax 180
mechanisms for running 23
overview
placement-managed federated database 23, 175
return status 23
syntax
classic command-line 180
tool runner 179
tool runner 179
transactions
listing 50, 223
MROW 96
recovering incomplete 137, 192
troubleshooting
container file access 93
database access 89
listing
active transactions 50
transaction information 50
waiting transactions 50
lock problem 103
starting
lock server 103
stopping a lock server 99
types, see data types
U
UNC names for remote Objectivity/DB
files 31, 165
Universal Naming Convention, see UNC names
UNIX
data servers 164
preparing for Windows clients 164
setting up automatic recovery 144
setting up automatic recovery 142
starting server
AMS 109
lock server 98
stopping server
AMS 109
lock server 99
update lock 96
utilities, see tools
V
virtual drive letter 29, 31, 165
W
Windows
AMS output 110
data servers
file access 164
hosts 164
setting up automatic recovery 145
lock-server output 102, 110
setting up automatic recovery 141
specifying Objectivity/DB files
local names 29
mapped drive letter prohibited 31, 165
UNC names 31, 165
starting server
AMS 109
user ID for NFS 164
Windows Network
accessing Objectivity/DB files 164
specifying files 31
WSAEADDRINUSE error message 102
X
XML documents
exporting
hierarchy of top-level elements 214
schema 212
XML Schema for Objectivity/DB structures 214