ftp.nice.ch/Attic/openStep/developer/resources/MiscKit.2.0.5.s.gnutar.gz#/MiscKit2/Examples/Giger/WebObjects/InstallGuide.rtf

This is InstallGuide.rtf in view mode; [Download] [Up]

Installation Guide


This guide shows you how you can deploy GigerWeb and WebProjector. It takes you step-by-step through an example installation.

First lets review the assumptions made in the example installation. Your site will probably differ from the example site and you have to make some changes accordingly.

Example site
	- host assumption:
		- hostname: www.example.com
		- host runs NEXTSTEP or OpenStep for Mach
		- host has WebObjects installed
		- the html docs directory of the WebServer on host is: /NextLibrary/WebServer/htdocs
	- image location assumption:
		- all images will be in  /NextLibrary/WebServer/htdocs/Images
		- all gigerwww documents (the thumbnails) will be in /NextLibrary/WebServer/htdocs/Images/Thumbnails
		- the catalogs will be declared in  /NextLibrary/WebServer/htdocs/Images/Catalogs.plist

Installation steps

1.) Make directory /NextLibrary/WebServer/htdocs/Images and put in it all the images you want to make available on the Web.
2.) Make directory /NextLibrary/WebServer/htdocs/Images/Thumbnails.
3.) With Giger.app create catalogs of images from /NextLibrary/WebServer/htdocs/Images and save them as gigerwww files in
      the directory /NextLibrary/WebServer/htdocs/Images/Thumbnails.
4.) Copy the file Giger.app/Resources/WebObjects/Catalogs.plist to /NextLibrary/WebServer/htdocs/Images.
5.) For every gigerwww document in /NextLibrary/WebServer/htdocs/Images/Thumbnails make an entry in the array in 
      file /NextLibrary/WebServer/htdocs/Images/Catalogs.plist. The entry should be the document name but without extension.
6.) Copy Giger.app/Resources/WebObjects/GigerWeb to /NextLibrary/WebObjects.
7.) Copy Giger.app/Resources/WebObjects/WebProjector to /NextLibrary/WebObjects.
8.) Edit file /NextLibrary/WebObjects/GigerWeb/SiteInfo.plist to look like this:

{
	host = "www.example.com";
	htdocs = "/NextLibrary/WebServer/htdocs";
	imagedir = "/Images";
	thumbdir = "/Images/Thumbnails";
	catalogs = "/Images/Catalogs.plist";
}
	

9.) Edit file /NextLibrary/WebObjects/WebProjector/SiteInfo.plist in the same way.


Now the URL's

http://www.example.com/cgi-bin/WebObjects/GigerWeb
http://www.example.com/cgi-bin/WebObjects/WebProjector

should work.

Troubleshooting

Application = GigerWeb or WebProjector

Trouble: Application does not respond.
Answer: Check to see if Application is properly copied in /NextLibrary/WebObjects and if it shows up in /NextLibrary/WebServer/htdocs/WebObjects.

Trouble: No thumbnails.
Answer: Check the entries in /NextLibrary/WebServer/htdocs/Images/Catalogs.plist if they match the gigerwww files in /NextLibrary/WebServer/htdocs/Images/Thumbnails.

Trouble: No images.
Answer: Open the appropiate gigerwww file (which is a wrapper) and look in the Thumbs.plist file at the filenames. They should all
start with /NextLibrary/WebServer/htdocs/Images.

Remember, www.example.com is the name of the example site. Your site has probably a different name. Make the installation accordingly. Also if your directories differ from the example assumptions make the changes in the installation.

Good luck,

Uwe Hoffmann
hoffmann@fzi.de


These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.