Oracle ConText Option Administrator's Guide, Rel 2.3 | ![]() Library |
![]() Product |
![]() Contents |
![]() Index |
This chapter provides reference information for using the ConText server executables and utilities provided with ConText.
The executables and utilities discussed in this chapter are:
The ctxsrv and ctxsrvx executables start ConText servers. You execute ctxsrv or ctxsrvx for each ConText server that you want to start.
The ctxsrvx executable starts a ConText server with the ConText Linguistics disabled. The executable for ctxsrvx is considerably smaller than ctxsrv, resulting in less memory required to run the executable.
You can also use the ctxctl utility to start and shut down ConText servers.
See Also:
For more information about the CTXSYS user, see "CTXSYS User" in Chapter 2, "Administration Concepts". For more information about ctxctl, see "ctxctl Utility" in this chapter. |
The syntax for executable ctxsrv or ctxsrvx is:
ctxsrv|ctxsrvx -user ctxsys/passwd[@sqlnet_address] [-personality RQDML] [-logfile log_name] [-sqltrace]
where:
specifies the username and password for the Oracle user CTXSYS.
The username and password may be immediately followed by @sqlnet_address to permit logon to remote databases. The value for sqlnet_address is a database connect string. If the TWO_TASK environment variable is set to a remote database, you do not have to specify a value for sqlnet_address to connect to the database.
specifies the personality mask for the ConText server started by ctxsrv/ctxsrvx. The possible values can be any combination of:
The default is QDM.
specifies the name of a log file to which the ConText server writes all session information and errors.
enables the ConText server to write to a trace file in the directory specified by the USER_DUMP_DEST initialization parameter.
Before you specify -sqltrace for ctxsrv or ctxsrvx, you should specify a value for USER_DUMP_DEST in your initsid.ora file.
See Also:
For more information about SQL trace and the USER_DUMP_DEST initialization parameter, see Oracle7 Server Administrator's Guide. |
The following example starts a linguistically-disabled ConText server with a Query and DDL personality mask and writes all server messages to a file named ctx.log:
ctxsrvx -user ctxsys/ctxsys -personality QD -log ctx.log &
Note: In this example, the server is run as a background process in a UNIX-based environment. This is useful if you need to use the window/screen from which you started the server for other tasks. |
The following example starts a linguistically-enabled ConText server with a Linguistic personality and writes all server messages to a file named ctx.log. Because -user is not specified, ConText prompts you to enter a user:
ctxsrv -personality L -log ctx.log ... ConText: Release 2.0.6.0.0 - Production on Sat Jun 7 14:06:26 1997 ... Copyright (c) Oracle Corporation 1979, 1996. All rights reserved. ... Enter user:
At the prompt, enter 'CTXSYS/password', where password is the password assigned to the CTXSYS user.
The ctxctl utility is a shell script that can be used to start up and shut down ConText servers on the system from which you run ctxctl. It can also be used to check the status of all the ConText servers currently running on the system.
To start ctxctl, at the operating system prompt, type:
ctxctl
Once ctxctl is running, you can issue the following commands from the ctxctl command prompt:
Provides online help for the specified command. If called without a command, it provides a list of all the commands you can use in ctxctl.
Provides a list of all the ConText servers and their personality masks currently running on the server host.
Note: The ConText servers listed in the status output may be connected to different database instances. |
Starts n number of servers, each with the personalities specified. The personalities can be typed in any order, but must be typed in lowercase and exactly as they are named (e.g. load, query, ddl, dml, ling).
If you do not specify a personality, ctxctl starts the specified number of servers, each with the query, ddl, and dml personalities.
The first time you type the start command for a ctxctl session, ConText prompts you to enter the password for the ConText administrator (CTXSYS). After you enter the password, ConText starts the specified number of servers.
Shuts down the ConText server identified by pid or shuts down all ConText servers (all).
The status command can be used to obtain the pid for all currently running ConText servers.
Note: ctxctl does not use CTX_ADM.SHUTDOWN to shut down the ConText server. Instead, it aborts the server process running on the host machine. |
Terminates ctxctl and returns you to the command-line of the host machine.
The following example starts two ConText servers, each with a DML, DDL, and Query personality mask:
command> start 2 query dml ddl
The following example shuts down a ConText server with a pid of 230454:
command> stop 23054
![]() ![]() Prev Next |
![]() Copyright © 1997 Oracle Corporation. All Rights Reserved. |
![]() Library |
![]() Product |
![]() Contents |
![]() Index |