Setup guide

Setup on Windows
Before users can access the Web Monitor, you must install the following software on the workstation running
the Backburner Manager:
■ Apache HTTP server (Linux/Windows/Mac) or Microsoft Internet Information Services (IIS) (Windows
only)
■ Backburner Web Server
Users without administrator privileges can fully manage their own jobs, but can only monitor the status of
other jobs in the Web Monitor. Those with administrator privileges can manage all jobs and render nodes.
To assign administrator privileges to a Web Monitor user account:
1 Edit the Wiretap server configuration file, wiretap.cfg, located in the backburner directory of the
application data directory. For example:
C:\Documents and Settings\<user>\Local Settings\Application Data\backburner.
2 In the [SECURITY] section use the BackburnerAdministrators keyword to add users to the admin group.
It can be a comma-separated list.
To configure the Web Server to connect to the Backburner Manager:
1 Open for edit C:\Program Files\Apache Group\Apache2\cgi-bin\monitorCGI.cfg.
2 Find <Manager>localhost</Manager> and replace localhost with the name of the workstation running
Backburner Manager.
3 If necessary update <Port>3234</Port>.
4 Save and close the file. To test the Web Server, access http://<machinename>/backburner with a web
browser.
5 Enter a user name and password when prompted. By default these are both backburner. If you cannot
connect to the Web Server, try restarting the Backburner service and/or the web server.
To set up access to the Web Monitor:
1 Configure IIS to disable anonymous access, and enable integrated Windows authentication. These
settings allow anyone who can log in to the Windows workstation to use the Web Server. If you want
to provide access to users who do not have accounts on the Windows workstation, refer to the Microsoft
IIS documentation for help setting up Microsoft IIS user accounts.
2 Configure the Web Server itself to run in authenticated mode and then test this mode using the Web
Monitor: open for editing C:\Inetpub\wwwrootIcgi-binmonitorCGI.cfg. Add this line to the file:
<AuthorizedSite>monitorCGI.cgi</AuthorizedSite>. This requires all users connect through the Web
Monitor to provide a username and password.
Configure IIS and set the security for the Web Server:
1 Using Windows Explorer or My Computer, navigate to the C:\Inetpub\wwwroot\backburner folder
and edit its properties and enable sharing.
2 Edit the properties of the folder C:\Inetpub\wwwroot\cgi-bin. In the Web Sharing panel, enable Share
This Folder. You are prompted to set the security for the cgi-bin folder. From the dialog that appears,
select Execute (including scripts).
3 Set up the security for the shared backburner and cgi-bin folders in IIS using the Computer Management
Console tool. From the Computer Management Console, choose Services and Applications, Internet
Information Services, then Web Sites. IIS-managed Web sites appear in the right pane. If you just
installed IIS, only one site (the Default Web Site) appears. Otherwise, all IIS-administered Web sites
appear in the panel.
88 | Chapter 3 Networked processing