Chapter 1: Starting and Stopping RealPlayer Intranet Components

This chapter explains how to start and stop RealPlayer Intranet Administrator on both UNIX and Windows platforms, as well as how to access RealSystem Administrator.

Overview of RealPlayer Intranet Administrator Components

RealPlayer Intranet Administrator consists of the following components:

RealPlayer Intranet Administrator 8 executable file
This is the software component of RealPlayer Intranet Administrator that runs the product. The executable file is called ria.exe on Windows platforms and ria on UNIX platforms.
RealSystem Administrator
This is a Web-based console with which you use Web pages to centrally configure, build, deploy, and maintain RealPlayer 8 Intranet clients throughout your enterprise. Using RealSystem Administrator, you can configure settings either locally or remotely, because you can access the Web pages from almost any browser on your network.
RealPlayer 8 Intranet components
You use these components to build installers for RealPlayer desktop deployment on Windows NT, Windows 95, Windows 98, Windows 2000, and Windows ME workstations.

Note that RealPlayer Intranet Administrator uses components and terms similar to those used by RealServer^™, but the components in RealPlayer Intranet Administrator serve different functions than do those in RealServer. RealPlayer Intranet Administrator is not a streaming server. Rather, it is a product that enables administrators to deploy and configure RealPlayer 8 Intranet clients across corporate intranet environments from a single computer.

Starting and Stopping RealPlayer Intranet Administrator on Windows

The instructions in this section describe how to start and stop RealPlayer Intranet Administrator on Windows NT and Windows 2000.

Starting RealPlayer Intranet Administrator on Windows

On Windows NT and Windows 2000, RealPlayer Intranet Administrator is automatically installed as a service (named "RIA") unless you cleared that option during setup. As a service, RealPlayer Intranet Administrator is always running in the background.

Starting RealPlayer Intranet Administrator Manually

You can start RealPlayer Intranet Administrator either from the Start menu or from a command line.

If RealPlayer Intranet Administrator is already running as a service, do not try to start it a second time.

To start RealPlayer Intranet Administrator from the Start menu:

On the Start menu, point to Programs, point to RealPlayer Intranet Administrator, and then click RealPlayer Intranet Administrator 8. This starts the ria.exe program.

RealPlayer Intranet Administrator loads the default configuration file, ria.cfg.

Note
If RealPlayer Intranet Administrator has already been started, a console window appears briefly and then disappears.

	Note
If RealPlayer Intranet Administrator has already been started, a console window appears briefly and then disappears.

To start RealPlayer Intranet Administrator from a command line:

From the main RealPlayer Intranet Administrator directory, type the following at a command line and then press Enter:


Bin\ria ria.cfg

If you start it without including a configuration file, RealPlayer Intranet Administrator uses the most recently used configuration settings.

Setting Up RealPlayer Intranet Administrator as a Service

You can run RealPlayer Intranet Administrator as a service on Windows NT and Windows 2000. There is an option you can select during setup that configures this automatically. Instructions in this section describe how to add RealPlayer Intranet Administrator to the services list if you did not instruct the setup program to do so.

To install RealPlayer Intranet Administrator as a service:

At a command prompt, go to the RealPlayer Intranet Administrator Bin directory.

Import the configuration file you want to use into a specific key in the registry by typing the following:


ria.exe -import[:key] configuration_file

where:

key is the registry key name you want to use. If you omit this key name, the default name Startup Params is substituted.

Note
If you enter a registry key, do not type the bracket symbols. They are used to indicate an optional parameter.

	Note
If you enter a registry key, do not type the bracket symbols. They are used to indicate an optional parameter.

configuration_file is the path and configuration file you want to import.

Note
The configuration file you use must contain absolute paths for variables such as BasePath. When it is runs as a service, RealPlayer Intranet Administrator does not recognize relative paths.

	Note
The configuration file you use must contain absolute paths for variables such as `BasePath`. When it is runs as a service, RealPlayer Intranet Administrator does not recognize relative paths.

For example, the following command:


ria.exe -import:Server1   ../ria.cfg

imports all of the values in the ria.cfg file into the following key of the Windows NT registry:

HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\RIA\Server1

Note
You must supply the path to the configuration file of RealPlayer Intranet Administrator. If RealPlayer Intranet Administrator cannot find the configuration file, it may not start.

	Note
You must supply the path to the configuration file of RealPlayer Intranet Administrator. If RealPlayer Intranet Administrator cannot find the configuration file, it may not start.

Tip
You can now start RealPlayer Intranet Administrator using this configuration by typing the following at a command prompt:
ria.exe registry:Server1

Install the service by typing the following command at a command prompt:
```
ria.exe -install[:ServiceName] "parameters"
```
where:

ServiceName is the name that will appear in the Services dialog box. If you omit ServiceName, RIA is substituted.

Note
If you enter the service name, do not type the bracket symbols. They are used to indicate an optional parameter.

parameters is either the name of the configuration file or the registry and key name, as entered in Step 2. The format of the registry and key name is registry:key. You can use any command-line parameters, such as the -m switch, for example.

Note
The quotation marks surrounding parameters are required.

The next time you start RealPlayer Intranet Administrator from the Services dialog box, it will use the settings specified in parameters and will be configured to start automatically.

For example, the following command:
```
ria.exe -install:RMInternet "Server1"
```
installs RealPlayer Intranet Administrator with the service name "RMInternet" and uses the settings in the Server1 key.
Start the service. In the Services control panel, select the name you used for ServiceName, and then click Start.

	Tip
You can now start RealPlayer Intranet Administrator using this configuration by typing the following at a command prompt: `ria.exe registry:Server1`

	Note
If you enter the service name, do not type the bracket symbols. They are used to indicate an optional parameter.

	Note
The quotation marks surrounding `parameters` are required.

To remove any RealPlayer Intranet Administrator from the services list:

At a command prompt, type the following:


ria.exe -remove[:ServiceName]

where ServiceName is the optional name of the service. If you omitted a service name when you installed the service, you can omit it here, and RealPlayer Intranet Administrator will use RIA the default service name.

Stopping RealPlayer Intranet Administrator on Windows

If RealPlayer Intranet Administrator was started from the Start menu or a command line, switch to the command window and then press Ctrl+C.

On Windows NT or Windows 2000, if RealPlayer Intranet Administrator was started as a service, stop RealPlayer Intranet Administrator by using the Services window (accessed from Control Panel). To stop the service, do one of the following:

On Windows NT, click Start, point to Settings, and then click Control Panel. In Control Panel, double-click Services. Locate RIA on the list (your service name may be different), select it, and then click Stop.
On Windows 2000, click Start, point to Settings, and then click Control Panel. In Control Panel, double-click Administrative Tools and then double-click Services. Locate RIA on the list (your service name may be different), select it, and then click Stop.

Starting and Stopping RealPlayer Intranet Administrator on UNIX

Instructions in this section describe how to start and stop RealPlayer Intranet Administrator when you are running it on UNIX.

Starting RealPlayer Intranet Administrator on UNIX

Start RealPlayer Intranet Administrator initially with the default configuration file; later, you can create other configuration files and start RealPlayer Intranet Administrator using those files.

To start RealPlayer Intranet Administrator on UNIX:

Go to the main RealPlayer Intranet Administrator directory, and then type the following:


Bin/ria ria.cfg

To start RealPlayer Intranet Administrator in the background:

From the main RealPlayer Intranet Administrator directory, type the following:


Bin/ria ria.cfg &

If you have other configuration files, you can substitute one of their names for ria.cfg and RealPlayer Intranet Administrator will use the settings in the file you name.

To limit the amount of memory that RealPlayer Intranet Administrator uses:

Start RealPlayer Intranet Administrator with the -m parameter, as follows:


Bin/ria ria.cfg -m 128

where the number after -m can be any amount of memory—in megabytes, or MB—that is128 MB or greater. (This parameter is not necessary on FreeBSD and Linux.)

Stopping RealPlayer Intranet Administrator on UNIX

To stop RealPlayer Intranet Administrator on UNIX, obtain the parent process identification number, and then issue the kill command with that process number. The process ID is stored in the ria.pid file, which is usually kept in the Logs directory. The PIDPath variable specifies this location.

You can perform both of these actions with one command. To do this, go to the directory that contains the RealPlayer Intranet Administrator PID file, and then type the following:


kill `cat pidfile`

where pidfile is the name of the RealPlayer Intranet Administrator PID file, as shown in the PIDPath variable.

Accessing RealSystem Administrator

RealSystem Administrator is a feature of RealPlayer Intranet Administrator. It is a Web-based console from which you can view and configure the general setup options for RealPlayer Intranet Administrator and create settings in configuration files and installers for RealPlayer deployment.

When RealPlayer Intranet Administrator is running, you can access RealSystem Administrator from nearly any browser on your network that supports Java and JavaScript. The compatible browsers are Netscape Navigator versions 4.x or later and Microsoft Internet Explorer version 4.0 or later. For more information on browser compatibility, see http://service.real.com/help/library/guides/intranet/readme.html.

Note
To access RealSystem Administrator, you must be running RealPlayer Intranet Administrator. You cannot configure RealPlayer Intranet Administrator settings on any other RealSystem Administrator console. For example, you cannot use a RealServer's RealSystem Administrator to administer settings on RealPlayer Intranet Administrator.

	Note
To access RealSystem Administrator, you must be running RealPlayer Intranet Administrator. You cannot configure RealPlayer Intranet Administrator settings on any other RealSystem Administrator console. For example, you cannot use a RealServer's RealSystem Administrator to administer settings on RealPlayer Intranet Administrator.

To access RealSystem Administrator:

Start RealPlayer Intranet Administrator. (See "Starting and Stopping RealPlayer Intranet Administrator on Windows" and "Starting and Stopping RealPlayer Intranet Administrator on UNIX".)
In any compatible browser, type the following address:
```
http://address:AdminPort/admin/index.html
```
where:

address is the IP address or host name of the computer on which RealPlayer Intranet Administrator is installed.

AdminPort is the port that RealSystem Administrator uses to connect to RealPlayer Intranet Administrator. During setup you were asked for a port number; use that port number here.

The following URL will start RealSystem Administrator if it is typed in the browser on the same computer as RealPlayer Intranet Administrator (be sure to substitute your port number for AdminPort):
```
http://127.0.0.1:AdminPort/admin/index.html
```
The following command will also work on that computer:
```
http://localhost:AdminPort/admin/index.html
```
You are prompted for your user name and password; these should match the values you entered during setup. Click OK.
The RealSystem Administrator window for RealPlayer Intranet Administrator appears.

Tip
Bookmark this location so that you can easily return here at any time.