Starting and Stopping Sybase Control Center in UNIX

You can start Sybase Control Center or the SCC agent 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.

This topic applies to both Sybase Control Center (the server) and the Sybase Control Center agent that runs on each product server managed by SCC.

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

Use the scc.sh script to start Sybase Control Center or the SCC agent manually. You can do this in two ways:
- Run scc.sh in the foreground to get 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.
- Run scc.sh in the background to suppress the console.
You can use scc.sh to run Sybase Control Center at a nondefault logging level for troubleshooting. When you start manually with scc.sh, you cannot take advantage of the automatic start and restart features available to services.
Use the sccd script to configure a service that starts Sybase Control Center or the SCC agent automatically.

Here are the steps for each option:

Before you start Sybase Control Center or the SCC agent 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
```
Run Sybase Control Center or the SCC agent in the foreground.
Running in the foreground is a method of manually starting; you must issue comands to stop and restart Sybase Control Center or the SCC agent when you use this method.
1. To start Sybase Control Center or the SCC agent and drop into the console when the start-up sequence is finished, enter:
```
$SYBASE/SCC-3_2/bin/scc.sh
```
Run Sybase Control Center or the SCC agent in the background.
You can use nohup, &, and > to run Sybase Control Center or the SCC agent in the background, redirect output and system error to a file, and suppress the SCC console. Sybase recommends that you do this from the Sybase Control Center bin directory. Running in the background is a method of manually starting; you must issue comands to stop and restart Sybase Control Center or the SCC agent when you use this method.
1. Execute a command similar to the sample below that matches your shell. Both sample commands direct output to the file scc-console.out. If the output file already exists, you might need to use additional shell operators to append to or truncate the file.
  For Bourne shell (sh) or Bash:
```
cd <SCC-install-dir>/bin; nohup ./scc.sh 2>&1 > scc-console.out &
```
  For C shell:
```
cd <SCC-install-dir>/bin; nohup ./scc.sh >& scc-console.out &
```
Shut down Sybase Control Center or the SCC agent.
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_2/bin/scc.sh --stop
```
Configure Sybase Control Center or the SCC agent 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. UNIX installations of Sybase Control Center include a shell script, sccd, which you can use 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 $SYBASE/SCC-3_2/bin/sccd into this directory:
  - AIX (SCC agent only): /etc/rc.d/init.d
  - HP-UX (SCC agent only): /sbin/init.d
  - All other platforms: /etc/init.d
2. Open sccd 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_2, the Sybase Control Center installation directory).
3. In Linux, execute these commands to configure the service to run in run levels 2, 3, 4, and 5:
```
/usr/sbin/chkconfig --add sccd
/usr/sbin/chkconfig --level 2345 sccd
```
  You can test the sccd script with /usr/sbin/service sccd status. (The service command accepts these options: start | stop | status | restart.)
4. On non-Linux platforms, locate this directory:
  - AIX (SCC agent only): /etc/rc.d/rc<X>.d
  - HP-UX (SCC agent only): /sbin/rc<X>.d
  - Solaris: /etc/rc<X>.d
  Where <X> is the run level (for example, 3). Make two soft links in the directory for your platform and set the links to point to:
  - AIX (SCC agent only): /etc/rc.d/init.d/sccd: S90sccd and /etc/rc.d/init.d/sccd: K10sccd
  - HP-UX (SCC agent only): /sbin/init.d/sccd: S90sccd and /sbin/init.d/sccd: K10sccd
  - Solaris: /etc/init.d/sccd: S90sccd and /etc/init.d/sccd: K10sccd
  The S90sccd link starts the service and the K10sccd link stops the service. The two-digit numbers in the links indicate the start and stop priorities of the service.
5. Use the S90sccd and K10sccd links to test starting and stopping the service. The links are called automatically when the machine is started or shut down.