Starting and Stopping Sybase Control Center in UNIX

There are two ways to start Sybase Control Center. You can start it manually, which is useful for testing and troubleshooting, or you can set up a service to start automatically and to restart in case of failure.

If you run Sybase Control Center manually, you must issue a command every time you want to start or stop it. If you run as a service (which is recommended), you can configure Sybase Control Center to start and restart automatically. These are the options:

Use the scc.sh script to start Sybase Control Center manually. The command gives you access to the Sybase Control Center console, which you can use to shut down and to display information about services, ports, system properties, and environment variables. You can also use scc.sh to run Sybase Control Center at a nondefault logging level for troubleshooting. When you use scc.sh, you cannot take advantage of the automatic start and restart features available to services.
Use the agentd script to configure a Sybase Control Center service that starts automatically.

Here are the steps:

Before you start Sybase Control Center for the first time, set environment variables. Do this only once.
1. Change to the Sybase directory (the parent of the Sybase Control Center installation directory).
2. Execute one of the following to set environment variables. Bourne shell:
```
. SYBASE.sh
```
  C shell:
```
source SYBASE.csh
```
Start Sybase Control Center manually.
1. To start Sybase Control Center and drop into the console when the startup sequence is finished, enter:
```
$SYBASE/SCC-3_1/bin/scc.sh
```
Shut down Sybase Control Center.
1. To shut down from the scc-console> prompt, enter:
```
shutdown
```
  Warning! Do not enter shutdown at a UNIX prompt; it shuts down the operating system.
  
  To shut down from the UNIX command line, enter:
```
$SYBASE/SCC-3_1/bin/scc.sh --stop
```
Configure Sybase Control Center to run as a service.
A UNIX service is a daemon process that starts automatically after the machine is started and runs in the background. In UNIX installations, a shell script, agentd, is available in $SYBASE/SCC-3_1/bin. Use agentd to configure the Sybase Control Center service. (Some UNIX platforms supply tools that make service configuration easier; Linux chkconfig is an example.)
Note: Sybase recommends that if you are not familiar with the process of setting up services in UNIX, you delegate this task to a system administrator or consult the system administration documentation for your UNIX platform.
1. Copy agentd into this directory:
  - HPUX: /sbin/init.d
  - AIX: /etc/rc.d/init.d
  - All other platforms: /etc/init.d
2. Open agentd and edit the line that sets the SYBASE variable. Set it to the location of your Sybase installation (that is, the parent of SCC-3_1, the Sybase Control Center installation directory).
3. On Linux, execute this command to configure the service to run in run levels 2, 3, 4, and 5:
```
/usr/sbin/chkconfig --add agentd
```
  You can test the agentd script with /usr/sbin/service agentd status. (The service command accepts these options: start | stop | status | restart.)
4. On other UNIX platforms, make two soft links in this directory:
  - HPUX: /sbin/rcX.d
  - AIX: /etc/rc.d/rcX.d
  - All other platforms: /etc/rcX.d
  Where X is the run level (for example, 3). Set the links to point to:
  - HPUX: /sbin/init.d/agentd: S90agentd and /sbin/init.d/agentd: K10agentd
  - AIX: /etc/rc.d/init.d/agentd: S90agentd and /etc/rc.d/init.d/agentd: K10agentd
  - All other platforms: /etc/init.d/agentd: S90agentd and /etc/init.d/agentd: K10agentd
  The S90agentd link starts the service and the K10agentd link stops the service. The two-digit numbers in the links indicate the start and stop priorities of the service.
5. Use the S90agentd and K10agentd links to test starting and stopping the service. The links are called automatically when the system is booted or shut down.