WebSTAR Manual & Technical Reference

Previous Page | Manual Contents | Chapter Contents | Next Page

WebSTAR Admin Application  

The WebSTAR Admin application is a Mac OS program which allows you to monitor and configure your WebSTAR server. As you change your server settings with the WebSTAR Admin application, it updates the WebSTAR Settings file on the server machine. Be sure to back up that file frequently, so the data is preserved.

WebSTAR Admin can simultaneously administer many different machines running WebSTAR servers.

You can run the WebSTAR Admin application on the same machine as your server, or on any other local or remote Mac with access to the server via an intranet or the Internet. That's because it communicates with your WebSTAR server application using TCP/IP, just as web browsers and FTP clients contact your server.

Connecting To A Server

The WebSTAR Admin lets you connect to your WebSTAR server simply by entering the host name or IP address, port number, and password. You can even save this information in an Admin Connection file, and then use it to connect again, although for security, you must always enter your password.


WebSTAR Admin connects only to the primary domain name and IP address : it ignores all secondary IP addresses and host names, even if you have enabled Virtual Hosts. You can do all administration for all hosts using this access.

If you have a firewall, you may have to ask your network administrator to let you access the administration port: see Port Numbers.

You can see the monitor windows for Web, FTP and Proxy servers, and edit the server settings remotely. All your changes are cached, and will be sent to the server as soon as you press the "Save" button in the Settings window.

Admin Timeout

The WebSTAR Admin will break its connection after 1 hour of inactivity. This reduces the chance that a forgotten administration session will be used by an unauthorized person, or permanently block one of the four allowed simultaneous Admin connections. WebSTAR Admin will bring up the Connection dialog and allow you to enter your password to reconnect.

Connecting to Multiple Servers

You can open several connections to different servers, either on separate machines or on separate ports on the same machine (such as the SSL server).

If you have a connection to more than one server, only one is known as the current server , and all your commands will go to that server. The active monitor window defines the current server. As each monitor window displays the server name and port number in the title bar, you can always tell which server is currently selected.

For your convenience, you can drag data and drop from one server setting window to another.

Admin Connection Documents

WebSTAR Admin can create Admin Connection files. These store the domain name or IP address and port number, so you don't have to type them in every time, along with window positions. You can open them instead of retyping every time. For security, you will always have to enter your password in this dialog.

WebSTAR Admin Security

For security, access to the WebSTAR Admin application is password-protected. You must set the Admin password on the WebSTAR server, and you should change the password at regular intervals, such as every month. For instructions on entering your administration password in the WebSTAR server, see Admin Password.

See Also: Safe Passwords.

The WebSTAR Admin encrypts all communication to the server, so no one else can read or send instructions. The encryption key is changed for each connection. This allows you to make changes from any Mac on the Internet, without worrying about security.

Admin Monitor Windows

The WebSTAR Admin monitor windows contain much the same information as the server monitor windows. Each window title includes the server type (Web, FTP or Proxy), the host name or IP address (from the Connection dialog), and the port number.

The server monitor windows themselves contain a status pane and a log entry pane. Most of the information in these windows is the same as in the WebSTAR Status and Monitor Windows. The chasing arrows indicator shows that they are connected to the server--there will be a red X if the connection times out.

You can use the mouse to select text, then copy it to the Clipboard and paste to a text editor document.

Admin Web Monitor

The WebSTAR Admin Web monitor window is somewhat different from the server Web monitor window. The Status pane is much like the Status Window Top Panel, although it does not have the histogram, LED, or "high-water marks" in the Connections and Memory bars.

The logging pane is exactly like that of the server: see Web Server Monitoring and Log Formats for details.


For more information, see Web Server Monitoring.

Admin FTP Monitor

The FTP monitor is much like that of the server, as described in WebSTAR FTP Monitors & Loggin. The status pane displays a Connections bar indicating the percentage of available connections now in use, the maximum possible connections and the current number of connections. The logging pane below it shows the actions of the FTP server, including client logins, file transfers and so on.


Admin Proxy Monitor

The Proxy monitor is much like that on the server, as described in Proxy Status Window & Log File. The status pane displays the number of bytes sent, the number of files matched in the cache, a bar indicating the percentage of connections used, the maximum number of connections and the current number of connections. Below it, the log pane shows the date, time, HTTP status, requesting browser's IP address, URL, Proxy Cache status (Hit, Miss or Pass), bytes transferred and time taken.


WebSTAR Admin Menus

File Menu

Monitor > Web / FTP / Proxy

Open a monitor window if it is currently closed. The monitor window menu items will be disabled if that window is currently open.

New Connection

The New Connection dialog allows you to specify the host name (or IP Address), port number, and administration password of your WebSTAR server. If you should lose your connection to the server, you may have to re-connect using this dialog.

Open and Save

WebSTAR Admin can create Admin Connection files. These store the host name or IP address and port number, so you don't have to type them in every time. When you choose Open, you can select one of these files and it will bring up the Connection dialog, with the information filled in. For security, you will always have to enter your password in this dialog.

Close and Quit

Closing all a server's connection windows will close the connection to the server.

Quitting the Admin application will also close the connection to the server.

There is also an option to quit the WebSTAR server application remotely: see Quit WebSTAR.

Edit Menu

Undo / Cut / Copy / Paste / Clear / Select All

Normal editing commands apply to the dialogs text fields and log windows of the WebSTAR Admin application.

Server Settings

This option opens the Server Settings window for the active server, allowing you to specify settings for Web, FTP and Proxy servers. For more information, see WebSTAR Admin Menus, Web Server Administration, WebSTAR FTP Administration, and WebSTAR Proxy Administration.

Options Menu

This menu always applies to the current server (the server in the active monitor window). They are permanent changes, saved in the WebSTAR Settings file. The commands on this menu duplicate those in the WebSTAR server (see Options Menu).

Quit WebSTAR

This will tell the active server to shut itself down, even if it's on a remote machine. It will not restart until a person launches it or, if you have arranged it, a script or other program launches it.

WebSTAR Admin Settings Window

To open the settings window, connect to your server and choose "Server Settings" from the Edit menu.

To connect, see New Connection.

On the left, you'll see the Web, FTP and Proxy Settings, with disclosure triangles (like the Finder List view), and entries for the settings panels for each. If you are missing FTP or Proxy, that Plug-In was not in the server's Plug-Ins folder when the server was launched.

The "Save" button at the lower right sends your changes to the WebSTAR server, which saves them in the WebSTAR Settings file.

If you close without saving, you'll get an opportunity to save changes to the server, or discard your changes.

Working with Admin Lists

File Paths in WebSTAR Admin

There are several options in WebSTAR Admin that require you to specify a unique file. This file path lets the WebSTAR server locate the file properly. The Macintosh OS file path delimiter is a colon (":"), separating folder names. Paths to files end with the file name, while paths to folders end with a colon.

HTTP requests and URLs use slashes (/) as a delimiter, rather than colons.

WebSTAR Admin file paths are not case-sensitive, and they can include spaces and Macintosh extended characters.

Absolute File Paths

File paths can be absolute , starting from the name of your hard disk. In that case, they do not start with a colon, because there is no parent folder:

Mac HD:WebSTAR 3.0:images:navbar.gif
FTP-HD:pub:human resources:

The FTP Server requires absolute file paths for the user root folders.

Relative File Paths (Web Server Only)

Web server file paths can be relative , starting from your root folder. They always start with a colon, to indicate that they are subfolders, like these:



Default Root Folder

The default root folder is the folder in which the active WebSTAR server application is stored. Virtual Hosts designate their own root folders, and paths for their files refer to that root: see Virtual Host Root Folders and Default Files.

Previous Page | Manual Contents | Chapter Contents | Next Page