Before starting or stopping RealServer, you may want to ascertain whether RealServer is running.
Windows NT: If RealServer is running, it will be listed on the Applications tab of the Windows NT Task Manager.
Windows 95: If RealServer is running, it will be listed on the Taskbar.
Determine whether RealServer is running by typing a ps command and a grep command that searches for pnserver. For example,
ps -ef | grep pnserver
If the server is running, the ps and grep command return two lines for the pnserver processes that look similar to this:
username 25851 25850 0 16:51:11 0:00 bin/pnserver server.cfg
username 25850 1 0 16:51:11 0:00 bin/pnserver server.cfg
The lines above indicate that the pnserver process and the pnserver resolver process (which is a child process of the pnserver process) are running. The PIDs for the two processes should be sequential. In the example above, the pnserver process has a PID of 25850, and the pnserver resolver process has a PID of 25851.
When you start the RealServer, it asks you to register online. RealServer will not start unless you register.
When you first install RealServer, it is configured to start automatically each time you start your computer. The instructions below describe how to disable this.
RealServer is installed as a service under Windows NT, where it can be controlled from the Services Control Panel.
If you want to remove RealServer as a service, first stop RealServer, then run the delsvc.exe program in the bin directory.
To restore automatic starting, run crtsvc.exe, which is also located in the bin directory.
When you run RealServer as a Service, errors are written to the Windows NT error logs rather than the Error Log specified in the RealServer configuration file. You can view them just like any other Windows NT errors.
If you want to disable automatic starting, remove the RealServer command from the boot-time scripts of your UNIX system.
To restore automatic starting, add the pnserver command to start RealServer to the boot-time scripts of your UNIX system. The boot-time scripts generally reside in files or directories beneath the /etc subdirectory. Be sure to use complete path names in your script.
If you do not have permission to change the boot-time scripts on your computer, you may need to have your system administrator do this for you.
To start RealServer manually using the Control Center:
To start RealServer manually from the command line:
bin\pnserver server.cfg
If RealServer does not start, review the error messages in the RealServer Error Log.
Because RealServer runs on a high-numbered, unprivileged port, you do not need super-user privileges to start it unless you have configured for PNAviaHTTP by setting HTTPPort 80. However, if you do start it while you are logged on as super-user, then RealServer can configure itself to use additional system resources, such as file descriptors, that it needs to support a large number of users connected simultaneously.
After you start RealServer with super-user privileges and it adjusts its resource limits, RealServer assumes the user and group IDs entered into the configuration file.
To start RealServer manually from the command line:
bin/pnserver server.cfg
If RealServer does not start, review the error messages in the RealServer log files.
If you stop RealServer while users are connected, they may receive error messages. To prevent users from receiving error messages, first prevent new users from connecting, then stop the server. If no users are connected, you can skip directly to the instructions listed in "Stopping RealServer."
By shutting down RealServer gracefully, you can prevent new connections without disconnecting current users. After your current users have disconnected, stop the RealServer. Be sure to change the PnaPort back to its normal value before restarting RealServer.
UNIX command line:
After the currently connected users stop playing clips, stop the server.
Use either the Administration Web Page or the Control Center to stop RealServer.
To stop RealServer using Control Center, follow the platform-specific directions below.
If you started RealServer with the pnserver utility, press Ctrl+C at the command line. If you started RealServer from the Control Center, click Stop on the Server menu.
kill 'cat logs/pnserver.pid'