This document contains a quick summary of the steps needed to setup your
REBOL/IOS server on Linux (Unix) and Windows operating systems. For more
details and more complete descriptions it is suggested that you view: REBOL/IOS
Administrator's Guide
Setting up an IOS server is quick and can be accomplished in 5 to 15
minutes depending on the skill level of the administrator.
No special "setup script" or "installer" is required. You will simply
copy the IOS files into a directory on your system and add a small
program to your web server CGI (scripts) directory.
If you encounter problems, 90% of the time they are related to file
and directory permissions. Please follow those instructions carefully
in the steps below. Some systems, such as Windows may contain slight
variations, depending on your Internet Services server version.
1. Create a new user account on your server (something like
"rebol-serve") and unarchive the distribution files into that account.
2. Verify that the files have correct ownership and permissions. The
files should be owned by the account created above, not by root or
administrator.
3. In the proxy directory, find the correct rebolproxy for your system.
For Windows, use the rebolproxy.exe file. For Linux run the make-proxy
script to compile the proxy code.
4. Copy the rebolproxy to your web server's cgi-bin directory. Under
Microsoft IIS, the cgi-bin directory may be called "scripts". (But you
should use the same name as that pre-configured in your IOS client URL.)
5. Set the correct file permissions for the rebolproxy file and its
directory. Under Windows 2000-XP, you will need to set the IIS server
options to allow executable script (CGI) files in that directory. To do
so, open your ISS control panel, open your server and its "default web
site" directory, right click on the "scripts" directory and select
"properties". Then verify that execute permissions are set to "scripts and
executables." This is a necessary step to allow the rebolproxy to
run within the scripts (CGI) folder.
6. Run a web browser and goto the URL for your web server with the CGI
rebolproxy. An example would be:
http://www.example.com/cgi-bin/cgiproxy
|
The web server should display a message that the REBOL IOS web proxy
ran correctly. If you get an error, check your cgi-bin file permissions
and web server configuration. Note that the REBOL IOS server does not
need to be running for this test to be done.
7. Test REBOL/Serve by starting it from the console. YOU MUST BE
LOGGED-IN AS THE SAME USER YOU CREATED IN STEP 1, not as root.
Otherwise, newly created files may have the wrong ownership and could
cause problems later.
To start the server change to the server directory and enter the shell
command:
rebol-serve -s (or ./rebol-serve -s)
|
In windows you can create an icon shortcut and add the -s flag. THE -s
FLAG MUST BE SET, or files cannot be created by the server.
You should see the rebol-serve banner appear on the console. The REBOL
IOS server is now running and you can test it with a REBOL/Link client.
Once that test has been done, you will terminate the IOS server and add
it to your normal system boot scripts.
1. Run one of the REBOL/Link clients to verify that you can connect to
the server. Once the client has installed, enter the account
information below:
username: admin
password: test
|
2. If all goes well, you should see the client's status bar (in the
lower right corner) indicating that you connected successfully. If the
client does not connect, see the admin-guide document in the docs folder
for troubleshooting suggestions.
3. Immediately change the password for the Admin account. While logged
on, go to the Utilities arena and change the password by clicking on
Password program. Write down your password in a safe place and store it
away, as you may forget it (but do not save it in a file on your
computer or on IOS).
