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