REBOL IOS Express Version 1.0.2 REBOL Technologies WWW.REBOL.COM IOS Server Quick Installation: ----------------------------- 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" and you may need to set the IIS server options to allow executable CGI files. 5. Set the correct file permissions for the rebolproxy file. It must be executable from from the web server CGI. 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. Testing IOS Express ------------------- 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. On the client, open the User Admin application in the Admin arena and change the admin password by clicking on the admin account and clicking on the set password button. Save your changes. Automatic Startup on Server Boot -------------------------------- 1. Stop the server that you started above (e.g. ctrl-C or close the window.) 2. Add a call to your system's boot scripts to start rebol-serve on initial boot. Example scripts are provided for Unix and Linux users. Restart rebol-serve using the correct script and login account. Additional Information and Support ---------------------------------- For up-to-date information on IOS Express, visit: http://www.reboltech.com/express/docs Contact us at feedback@rebol.com if you experience problems installing your package. ###