sccinstance Command

Use sccinstance.bat (Windows) or sccinstance (UNIX) to deploy an instance of SAP Control Center from a shared-disk installation or to manage existing instances.

You can run multiple instances of SAP Control Center, including SCC servers, SCC agents, or a mixture of the two, from a single installation on a shared disk.

Syntax

sccinstance[.bat] 
[-agent] 
[-c | -create] 
[-d | -debug]
[-disable] 
[-enable]
[-f | -force]
[-h | -help] 
[-host host-name]
[-i | -instance [instance-name]] 
[-l | -list]
[-plugins {plugin-ID,plugin-ID,...}] 
[-portconfig {port-name=port-number,port-name=port-number, ...}]
[-refresh] 
[-r | -remove] 
[-s | -server] 
[-service]
[-silent]

Parameters

-agent – use with -create or -refresh to create or refresh an SCC agent. In a -create or -refresh command, -agent is the default, so you can omit it.
-create – deploy a new instance. Use alone or with -agent to create an agent instance, or with -server to create a server instance.
-d | debug – display debugging messages with the output of this command.
-disable – turn off shared-disk mode for this installation. Generates an error if any instance is running.
-enable – turn on shared-disk mode for this installation. Shared-disk mode is required if you intend to run more than one server or agent from a single installation of SCC.
-f | -force – execute sccinstance even if there are potential conflicts, such as port clashes or a running SCC process. SAP does not recommend using -force to remove or refresh a running instance in a Windows environment.
-h | --help – display help and usage information for the sccinstance command.
-host host-name – specify the host for this instance. Use with -create; required only when the instance name does not match the name of the host on which this instance will run. (The instance name defaults to the name of the current host unless you use -instance to specify another name.)
-instance [instance-name] – specify an instance. Use with -create, -remove, or -refresh, or use alone to display the instance’s status. You can omit -instance when you are addressing the only SCC instance or the only instance of the specified type (server or agent) on the current host.
sccinstance assumes that the host name is the same as the instance name unless you use -host to specify a different host name.
-l | -list – display a list of all instances deployed from this SCC installation.
-plugins {plugin-ID,plugin-ID,...} – specify one or more product module plug-ins for this instance. An alternative to -agent and -server, -plugins is primarily for use by the SCC installation program. Use with -create or -refresh. Use commas to separate plug-in names.

-portconfig {port-name=port-number, port-name=port-number, ...} – assign ports to services for this instance. Use only with -create or -refresh. For the port-name value, use a port name from the table below. If you plan to run more than one SCC instance on a host machine, you must reassign all the ports for every instance after the first.

Port information:

Port Name	Description	Service Names	Property Names	Default Port
db	Database port Present on SCC server	SccSADataserver Messaging Alert Scheduler	com.sybase.asa.server.port messaging.db.port alert.database.port org.quartz.dataSource.ASA.URL	3638
http	Web HTTP port Present on SCC server	EmbeddedWebContainer	http.port	8282
https	Web HTTPS (secure HTTP) port Present on SCC server	EmbeddedWebContainer	https.port	8283
jiniHttp	JINI HTTP server Present on SCC server and SCC agent	Jini	httpPort	9092
jiniRmid	JINI remote method invocation daemon Present on SCC server and SCC agent	Jini	rmidPort	9095
msg	Messaging port Present on SCC server	Messaging	messaging.port	2000
rmi	RMI port Present on SCC server and SCC agent	RMI	port	9999
tds	Tabular Data Stream™ port (used to communicate with other SAP database products) Present on SCC server and SCC agent	Tds	tdsPort	9998

-refresh – recopy all the files that make up this instance (Windows) or all this instance’s services and plug-ins (UNIX). Refreshing preserves any service or plug-in configuration in the deployed instance.
You can also use -refresh to convert a server to an agent or an agent to a server (see the examples). Files are removed or added to change the function of the instance. Use alone or with -agent to refresh an agent instance, or with -server to refresh a server instance. Generates an error if the instance is running.
-r | -remove – delete an instance. Use alone or with -instance. Generates an error if the instance is running. You cannot restore a removed instance.
-s | -server – use with -create or -refresh to create or refresh an SCC server, including any product modules available.
-service – use with -create or -remove to create or remove a Windows service for this instance. You must be logged in to Windows as an administrator to use this option.
-silent – suppress the output of sccinstance.

Examples

Deploy an SCC server instance – enables shared-disk mode, deploys a server called Boston with a Windows service on the current host, and starts the Windows service:
```
sccinstance -enable
sccinstance -create -server -instance Boston -service
net start "SAP Control Center 3.3 (Boston)"
```
Note: To create the service, you must log in to Windows as an administrator.
Deploy an SCC agent instance – deploys an SCC agent on this host and configures a Windows service for it. The -agent option, because it is the default, is not required—the command does exactly the same thing without it.
```
sccinstance -create -agent -service
```
or
```
sccinstance -create -service
```
Deploy a server instance and reassign ports – deploys the server on this host and configures nondefault RMI, HTTP, and HTTPS ports.
```
sccinstance -create -server -portconfig rmi=8888,http=7070,https=7071
```
Deploy two instances on the same host – creates two agent instances on the host fireball. The first command does not need the -host option because the instance name is the same as the host name.
```
sccinstance -create -agent -instance fireball -portconfig rmi=9991
sccinstance -create -agent -instance fireball2 -host fireball 
-portconfig rmi=9992
```
Note: In a production environment, SAP recommends that you deploy no more than one SCC instance of each type (one server and one agent) on the same host.
Refresh a server instance or convert an agent to a server – refreshes the server on this host. If the instance on this host is an SCC agent, refreshing it as an SCC server converts it into a server.
```
sccinstance -refresh -server
```
Refresh an agent instance or convert a server to an agent – refreshes the instance named kalamazoo. If kalamazoo is a server, refreshing it as an SCC agent converts it into an agent.
```
sccinstance -refresh -agent -instance kalamazoo
```
Remove a server instance – removes the instance named porcupine if it is not running:
```
sccinstance -remove -instance porcupine
```
Display status – displays the status of the instance on this host:
```
sccinstance
```
List all instances – displays a list of all SCC server and agent instances deployed from this SCC installation:
```
sccinstance -list
```

Scenario: Remove an instance by force – suppose you have inadvertently deployed two SCC agent instances on the same host:

$ sccinstance -list
2 SCC instances deployed:
SCC instance node1 deployed in agent mode for host node1 RMI port 9999
SCC instance node2 deployed in agent mode for host node2 RMI port 9999

Both instances use the same RMI port. You must either reassign ports for one instance or remove it. But you get an error if you try remove an instance when another instance is running on the same host:

$ sccinstance -instance node2 -remove
[ERROR] Command execution failed.
[ERROR] SCC instance node2 could not be removed because it is running. Shut 
down the SCC before removing the instance.

Use the -force option to override the error and force the removal of the second agent instance:

$ sccinstance -instance node2 -remove -force
Removing SCC instance node2 ...
SCC instance node2 was successfully removed.

Permissions

sccinstance permission defaults to all users, except as noted for certain parameters.