Administration Tools - oochange

Printer-friendly version
Lists and optionally changes the properties of a federated database or (HA) an autonomous partition.
oochange
[-ap apSysName | -id apId]
[-lockserverhost newLockServerHost]
[-fdnumber newFdId]
[[-bootfilehost newBootFileHost]
-bootfilepath newBootFilePath]
[[-sysfilehost newFileHost] -sysfilepath newFilePath
[-catalogonly]]
[[-jnldirhost jnlDirHost] -jnldirpath jnlDirPath]
[-offline | -online]
[-weight]
[-readonlyschema | -readwriteschema]
[-nowait | -standalone]
[-lockwait seconds]
[-notitle]
[-quiet]
[-help]
[bootFilePath]
Options
-ap apSysName
System name of the autonomous partition whose properties are to be changed or listed.
-id apId
Integer identifier of the autonomous partition whose properties are to be changed or listed (for example, 18).
-lockserverhost newLockServerHost
New lock-server host. (HA) Requires the -ap or -id option to change the lock-server host for an autonomous partition.
-fdnumber newFdId
New integer identifier for the federated database. The maximum identifier is 65533.
Warning: The identifier for a pre-Release 9.0 federated database should not exceed 32767 if that federated database is to be accessed by unrebuilt pre-Release 9.0 applications.
-bootfilehost newBootFileHost
New host for the boot file. To leave the host unchanged, omit both the -bootfilehost and -bootfilepath options.
If you omit only the -bootfilehost option, the default host is:
n
The host on which you are running this tool, if -bootfilepath specifies a local path.
n
The host implied by -bootfilepath, if an NFS mount name is specified.
If -bootfilepath specifies a Windows UNC share name, newBootFileHost is set to the literal string oo_local_host; any value you specify is ignored.
(HA) Requires the -ap or -id option to change the boot-file host for an autonomous partition.
-bootfilepath newBootFilePath
New path (including the filename) to the boot file on the designated host. To leave the path unchanged, omit both the -bootfilehost and -bootfilepath options. If the -bootfilehost option designates a remote system, newBootFilePath must be full, not relative.
(HA) Requires the -ap or -id option to change the boot-file path for an autonomous partition.
-sysfilehost newFileHost
New data-server host for the system-database file. To leave the host unchanged, omit both the -sysfilehost and -sysfilepath options. If you omit only the -sysfilehost option, the default host is:
n
The host on which you are running this tool, if -sysfilepath specifies a local path.
n
The host implied by -sysfilepath, if an NFS mount name is specified.
If -sysfilepath specifies a Windows UNC share name, newFileHost is set to the literal string oo_local_host; any value you specify is ignored.
(HA) Requires the -ap or -id option to change the file host for an autonomous partition.
-sysfilepath newFilePath
New path (including the filename) to the system-database file on the designated host. To leave the path unchanged, omit both the -sysfilehost and -sysfilepath options. If the -sysfilehost option designates a remote system, newFilePath must be full, not relative.
(HA) Requires the -ap or -id option to change the file path for an autonomous partition.
-catalogonly
Updates the system database’s location properties in the federated database’s boot file and global catalog, without physically relocating the system-database file. This option is valid only in combination with the -sysfilehost and -sysfilepath options.
-jnldirhost jnlDirHost
New host for the federated database’s journal directory. To leave the host unchanged, omit both the -jnldirhost and -jnldirpath options. If you omit only the -jnldirhost option, the default host is:
n
The host on which you are running this tool, if -jnldirpath specifies a local path.
n
The host implied by -jnldirpath, if an NFS mount name is specified.
If -jnldirpath specifies a Windows UNC share name, jnlDirHost is set to the literal string oo_local_host; any value you specify is ignored.
(HA) Requires the -ap or -id option to change the journal-directory host for an autonomous partition.
-jnldirpath jnlDirPath
New path to the federated database’s journal directory. To leave the path unchanged, omit both the -jnldirhost and -jnldirpath options. If the -jnldirhost option designates a remote system, jnlDirPath must be full, not relative.
(HA) Requires the -ap or -id option to change the journal-directory path for an autonomous partition.
-offline
(HA) Sets the status of the specified autonomous partition to offline. Requires the -ap or -id option.
-online
(HA) Sets the status of the specified autonomous partition to online. Requires the -ap or -id option.
-weight weight
(HA) New weight of the designated autonomous partition. weight must be a positive integer. If it is 0, oochange reports an error.
You may not change the weight of a partition if doing so would eliminate the quorum of partitions.
-readonlyschema
Changes the specified federated database’s schema so that it is read-only.
Note: This option has no effect in a pre-Release 9.0 federated database.
When a schema is read-only, no tool or application can modify the schema in any way. Any such attempt to modify the schema will report an error; you must change the schema back to read/write before you can run any tools or applications that will modify it.
-readwriteschema
Changes the specified federated database’s schema back to read/write. The schema is created as read/write; you normally specify this option to restore the default behavior if you have previously disabled it with -readonlyschema.
Note: This option has no effect if the schema was explicitly locked by an Objectivity/DB Active Schema application. A similar application must be used to unlock such a schema.
-nowait
Instructs the tool to terminate immediately if the federated database or the autonomous partition (specified by the -ap or -id option) is being accessed by another process.
-standalone
Nonconcurrent mode. Use this option if no lock server is running. You may also use this option to bypass a running lock server when changing any property except the lock-server host. In this case, the tool must be allowed to interact with the original lock server, if it is still running.
Warning: Corruption can occur if concurrent access to the federated database is attempted while any process is using this mode.
-lockwait seconds
Number of seconds to wait to obtain a lock. If you omit this option, the default is 10 seconds.
-notitle
Suppresses the copyright notice and program title banner. Useful when invoking the tool from another tool or product.
-quiet
Suppresses all normal program output.
-help
Prints the tool syntax and definition to the screen.
bootFilePath
Path to the boot file of the federated database to be changed or listed. You can omit this argument if you set the OO_FD_BOOT environment variable to the correct path. (HA) You can specify the boot file of any autonomous partition; the -ap or -id option specifies the autonomous partition to be changed or listed.
Discussion
To list the current properties of a federated database, enter oochange with just the bootFilePath argument.
Note: You must specify a fully operational federated database. If necessary, use ooinstallfd to install the federated database before you attempt to change its properties.
To specify a new boot file location, use the -bootfilehost and -bootfilepath options. oochange writes an updated boot file in the specified location, and leaves the old boot file as is. You delete the old boot file using appropriate operating-system commands.
To move or rename the system-database file, use the -sysfilehost and -sysfilepath options. By default, oochange physically relocates the file in the file system. To make the change only logically (without relocating the system-database file), you add the -catalogonly option. This is appropriate only if the file has been or will be moved by an operating-system command.
(HA) You must specify the -ap or -id option if the specified federated database has multiple autonomous partitions. For example, to list the current properties of an autonomous partition, enter oochange with the -ap or -id option and the bootFilePath argument.
See also

Date: 
Tuesday, October 30, 2012
Product: 
Objectivity/DB
Version: 
10.2.1
10.2
10.1.4
10.1.2
9.4.1