WebObjects Web Applications Deployment Windows

 22 August 08:14   

    (rev 1.3; 2002-08-29, see abounding afterlight list)

    The latest adaptation of this certificate can be begin at http://www.tetlabors.de/wo/setup_webobjects_on_windows.html.

    You can do with this how-to whatever you wish but do it at your own risk. I WILL Yield NO RESPONSIBILITIES WHATSOEVER. If you are not an able in these things, I advance ambience up a new arrangement just for analysis purposes first and then use your a new acquired ability on a absolute apple system.

    This how-to discusses accession of WebObjects 5.1 on Windows. It started as a email-help to install WebObjects 5.x on WinNT and has acquired since. It covers alotof gotchas for accession and agreement of both Development and Deployment of WebObjects 5.1 on the afterward versions of Windows:

    The capital advance of this how-to is directed to a development accession on Win2000 Server. Differences to additional configurations will be declared in abbreviate throughout the text. This still is abundant harder than Linux/WO Deployment, area you accept absolutely one configuration.

    This how-to is not about deployment issues that action afterwards WebObjects is installed. It ends with a alpha of Monitor. There are, however, a lot of issues that can be apparent be installing WebObjects in one of the appropriate means :-) , so you may apprehend this how-to anyhow.

    If you accept begin an absurdity or wish to create suggestions, improvements etc, you can acquaintance me here.

    To minimze delays, accept the afterward things at hand:

    If you plan to install on a new , abandoned machine, you additionally need:

    Thoughout this how-to you will see the appellation accessible a carapace several times. This agency you should go to the Alpha menu, bang on Run..., access cmd and columnist the Acknowledgment key. A new , abandoned window with a command alert should open. Of course, if there is already an accessible shell, just use that instead...

    This how-to follows the accession of Windows at the archetype of Windows 2000 server but should be accessible for all versions of Windows mentioned above. If something is absolutely different, there will be some abbreviate addendum in the text. Accession is mostly self-explanatory, I will alone acknowledgment the accomplish that crave some caution.

    If you plan to do absolute apple deployment on Windows, overlook about the non Server variants of Windows. Because of Windows authorization restrictions, the Workstation/Professional versions acquiesce alone 10 circumstantial access to the apparatus - files opened over arrangement shares calculation as connections, too. Ambience up a deployment will of advance plan but achievement will be actual bad, you should accede affairs a Windows Server adaptation or use Linux/Apache as the web server and arrange alone applications on Windows.

    First comes what I alarm the Basal Setup: admit Windows CD and boot. If you accept cossack diskettes, a arrangement binder or whatever as antecedent for the accession files, use that. On some OEM versions or with abandoned setup, alone some or no ascribe will be appropriate - just skip the adapted sections then.

    

    If bureaucracy asks for the role of the server, baddest Single-Server. Dont baddest one of the Area Ambassador roles, unless you understand what you are doing. During arrangement setup, you can accept to install Internet Advice Server (IIS). Dont do this, because it is an anachronous version. Be abiding to _uncheck_ that checkbox! Dont use DHCP! See Arrangement settings beneath for an explanation.

    

    Install alone apple Advanced Web Server, Internet Advice Casework Snap-In and all appropriate files. Dont install FTP, NNTP, SMTP unless you absolutely charge it. If not configured correctly, these casework accommodate execllent hooks for an attacker.

    If you accept added than operating arrangement installed, attenuate aurora extenuative for all but the first one or you will accept abundant fun alert a year...

    Choose custom arrangement settings and access IP/address, subnet mask, aperture and DNS server settings. Using DHCP on servers is not recommended because some casework await on a abiding IP adress. If you accept to use DHCP (its a air-conditioned service, afterwards all), configure the DHCP server so that your WebObjects machines consistently get the aforementioned adress (adress reservation, IP-to-MAC adress mapping).

    To be able to appearance additional computers around, the WORKGROUP name entered haveto bout the workgroup name of the additional systems. If you do a area based setup, there are no problems, just add the apparatus to your domain.

    Win2000/XP has the awkward addiction of absolution a arrangement adaptors agreement if it has no affiliation to the network. So consistently create abiding the arrangement cable is affiliated to an alive base (other apparatus or hub/switch) afore starting any services, abnormally while booting. If this is not the case, some casework will run on localhost (127.0.0.1) and you will acquaintance awe-inspiring errors if you try to connect.

    

    When you first log in to Windows, you will see the Configure Your Server dialog. Unless you understand what you are accomplishing I advance you accept I will configure this server later. and bang Next. On the next page, uncheck Appearance this awning at startup and abutting the chat window. If you want, you can appear aback after via Start, Programs, Authoritative Tools, Configure Your Server.

    

    If you accept to install added drivers (e.g. cartoon card) do so now. Otherwise, you are done with basal Windows setup. Actuality are some things you ability wish to do now:

    If you accept a multiprocessor system, you should be able to alpha Windows with alone one processor enabled (Single CPU HAL), This can be abundantly accessible if you run into accouterments issues after and accept to do an emergency cossack on a motherboard that supports alone one CPU. Also, some applications (Ethereal/winpcap) dont run on multiprocessor systems. To get individual CPU support, add a new access to c:oot.ini with a /onecpu about-face at the end. Dont copy-and-paste from this how-to, as deejay and allotment numbers may alter for your installation, just alike the access that is already there.

     [operating systems]

     multi(0)disk(0)rdisk(0)partition(1)WINNT=Windows 2000 Server /fastdetect

     multi(0)disk(0)rdisk(0)partition(1)WINNT=Windows 2000 Server (one CPU) /fastdetect /onecpu

    You ability accept to abolish address aegis from c:oot.ini to be able to add entries. Accessible a carapace and access this command:

     attrib -r -s c:oot.ini

    There is no charge to add address aegis afterwards.

    Another accessible apparatus is the Windows accretion console, abnormally if Windows crashes during startup (bluescreens, bad drivers, bad config, cannot cossack afterwards abacus a new harder deejay etc.). The Win2000 adaptation of the accretion animate can be acclimated on all versions of Windows while the WinXP adaptation cannot be acclimated on a apparatus that runs WinNT only. To add it, admit your Windows2000/XP CD, accessible a carapace and access the following:

     cd /d :i386

     winnt32 /cmdcons

    A new access is added to c:oot.ini that can be choosen from the account of installed operating systems.

    As of the time of this writing, no account backpack is accessible for WinXP. Install hotfixes as needed. For Win2000, install account backpack 2 and all hotfixes needed. For NT4, install account backpack 6, and then the past-sp6 rollup package. This should accord you 128 bit encryption strength.

    Insert the Windows NT Advantage Backpack CD and install Internet Explorer 4.01 (or a new er version).

    After this is done:

    Launch :setup.exe

    Setup warns that the advantage backpack was not activated with account packs new er than SP4. Bang Yes to advance anyway.

    Choose Custom as the accession type.

    On the next window, uncheck _all_ components, answering Yes to accessible warnings.

    Then go to Internet Advice Server (IIS) and bang on Appearance Subcomponents...

    Move to the end of the new alternative account and analysis apple Advanced Web Server. You ability wish to analysis Affidavit (at the alpha of the list). All barnacle software apparatus are called automatically.

    To abstain aegis issues, dont install the afterward unless you charge it and understand what you are doing:

    If bureaucracy asks you to specify to specify a binder for the WWW service, you can use the advancement c:inetpubwwwroot.

    For Microsoft Transaction Server, just bang Next twice. Advantage Backpack Bureaucracy should eventually complete. Afterwards that, you may accept to re-install all account packs/updates for WinNT as some files may accept been overwritten by Advantage Backpack Setup.

    Running NT / IIS out of the box is absolutely dangerous, so I advance you yield one of aegis how-tos that are accessible in this area. A defended IIS accession is not bare for simple centralized testing but it should be advised harakiri if you affix an caught apparatus to the Internet. You accept been warned. Actuality are some links that ability help:

    www.microsoft.com/security/ (then dive in from there)

    http://www.intersectalliance.com/projects/WinNTConfig/index.html (securing WinNT)

    http://www.intersectalliance.com/projects/Win2kConfig/index.html (securing Win2000)

    http://www.shebeen.com/iis4_nt4sec.htm (securing IIS on NT)

    http://www.intersectalliance.com/projects/IIS4Config/index.html (securing IIS)

    For added information, attending for hardening+iis+against+attack at Google.

    Now that you accept a active Windows box - hopefully defended :), we can adapt it for WebObjects installation. The being in this area works for both WebObjects 5.0 and 5.1.

    In case you are using an absolute apparatus with an earlier adaptation of WebObjects, you accept to uninstall it afore installing WebObjects 5.1. On the WebObjects 4.5 CD, beneath :developmentWindowsUninstall you will acquisition several directories:

    Use the adapted one for your version. To uninstall WebObjects 5.0, use Start, Ascendancy panel, Add/Remove Programs.

    The carapace congenital in to WinNT does not plan with WebObjects at all. For the Win2000 version, there are some issues if the command band gets best than 2000 characters due to abundant use of frameworks. Because of this, you will accept to alter the shell. The acceptable account is that you can use anniversary adaptation of CMD.EXE on every adaptation of Windows, so the basal abstraction is to get a CMD.EXE from a WinXP accession and use it to alter your absence carapace - unless you run WinXP :).

    If you do not accept a Win2000/XP CD, you can at atomic download Win2000 Account Backpack 2 (or Windows XP account backpack 1 as it becomes available) and abstract CMD.EXE from there. There should be no acknowledged issues back you can download account packs freely.

    Before attempting to alter the shell, be abiding to cut admission to the accession files or Windows Book Aegis will restore the old adaptation aural a few seconds. In case you installed from a CD, abolish the Windows accession CD. If you installed over a network, unplug the arrangement cable afore starting the replacement. Windows Book Aegis does not is on WinNT, you dont accept to anguish there.

    Within the added files amalgamation (download it here), there is a Software that does the backup for you. Feel chargeless to get your own adaptation of CMD.EXE if you dont feel adequate with the supplied one.

    Now abutting the carapace and accessible a new one, via Start, Run..., access cmd and columnist Return. Attending what it says on the first line:

    With the aboriginal versions, the first band in a carapace should attending like this:

    When you get this instead: Microsoft Windows XP [Version 4.0.1381] it agency that you infact run CMD.EXE from WinXP on a WinNT 4.0 accession (4.0.1381). Additional accessible combinations are larboard as an excercise to the reader. :-)

    Now you should change the agreement of Dr.Watson, Windows chip blast logger and debugger, so it runs after user interaction. Accessible a carapace and enter:

     drwtsn32 -i

    This installs Dr. Watson as the absence appliance debugger, which can be advantageous if you accept installed Beheld Flat Debugger and this barbarian shows its animal arch afterwards anniversary appliance crash.

    After this, enter:

     drwtsn32

    and a chat window ancestor up. Actuality you should use the follwing settings:

    Enable (check):

    Disable (uncheck):

    These settings acquaint Dr. Watson to aggregate as abundant advice as accessible and to accomplishment after user interaction. Otherwise, a comatose appliance will not abolish until the user clicks OK.

    This saves the endure 50 errors with the endure 20 instructions for anniversary error.

    Next affair is to install a Java-SDK. The adaptation of the SDK haveto be greater or according to 1.3.1, SDK 1.3.0 will not work. Also, you accept to install a SDK, installing alone a runtime ambiance (JRE) will not work.

    I would advance using SDK 1.4.0 or college unless you acquaintance problems with it (someone mentioned issues with Timestamps) . Abnormally on multiprocessor systems, 1.4.0s circumstantial debris accumulating is a big plus. If you do cross-platform development (OSX/Windows) be abiding to download the abounding all-embracing SDK from Sun (the better package), as alone this adaptation contains all the chantry encodings from the Mac. Else, you will get exceptions advertence that NSMacOSRomanStringEncoding could not be found.

    Run the SDK installer.

    Use the aisle appropriate (i.e. c:j2sdk1.4.0).

    You can deselect sources and examples, they are not bare for WO deployment. Install the Java plugin if you charge it.

    After SDK bureaucracy has finished, accessible a carapace and enter:

     java -version

    You should see an achievement like this:

     java adaptation 1.4.0

     Java(TM) 2 Runtime Environment, Accepted Copy (build 1.4.0-b92)

     Java HotSpot(TM) Applicant VM (build 1.4.0-b92, alloyed mode)

    Good job! You are now accessible to install WebObjects.

    With aggregate set up and active properly, you can now install WebObjects. Be abiding to log in as user with Ambassador privileges. This area aswell works for both WebObjects 5.0 and 5.1.

    Create a new binder on your harder deejay and archetype the capacity of the WebObjects accession CD there. Dont use a aggregate binder on the network, as Bureaucracy needs to restart if it is bisected way done and fails if it cannot acquisition the capacity of the CD; bad afterlife arises and you will be larboard with an abstract WO accession ... an abandoned binder like c:cdrom would be just fine.

    The acknowledging files amalgamation contains serveral versions of NMServer.reg. Accept the one you need:

    Rename the adapted book to NMServer.reg and archetype it to

    Depending on the blazon of setup, run

    To complete all accomplish in this how-to (like accumulation the adaptor), development bureaucracy is necessary. As anyone put it nicely:

    Development = Deployment + Developer Tools

    If you wish to install Deployment only, just skip the accomplish you dont need. Apprehension that you will not be able to abridge the ISAPI adaptor (which has an animal bug) if you install Deployment only. Be abiding to set up a Development accession (maybe on addition machine), too.

    Accept the authorization agreement.

    Enter User Name, Aggregation Name and the adapted consecutive amount for your bureaucracy (development, in this case).

    I accept apparent this alone on WinNT but it may appear on additional versions as well: Although you accept installed Java2-SDK 1.4.0, Bureaucracy complains that there is no JRE and that you should install Sun Java 1.3 or greater. In this case, abdicate Bureaucracy and acceptation the book jresettings.reg from the acknowledging files amalgamation (just double-click it). You may accept to accessible it first with a argument editor (notepad would be fine) and change the aisle settings in there. By default, it credibility to c:j2skd1.4.0. If you accept installed the SDK there, no changes to jresettings.reg are necessary.

    Choose Custom Setup.

    Select C:Apple as the destination folder. You may specify addition drive letter but dont put the Angel binder anywhere abroad but into the basis folder. Abundant annoyance with continued paths will apparent itself if you do. Also, beneath no affairs put spaces in the path!

    On the Baddest Apparatus dont change anything; artlessly bang Next.

    

    After this dialog, an ComponentAddItemError chat box may pop up. Artlessly bang Ok there and baddest Additional from the web server list; then bang Next.

    

    CGI-BIN Directory: Specify the aisle to the IIS scripts folder, which is about amid at c:inetpubscripts. You can use the Browse... button to abstain typos.

    Document Basis Directory: The aisle to the IIS wwwroot folder, about c:inetpubwwwroot.

    Click Next on all added chat windows. Bureaucracy should alpha artful all files bare to the appropriate locations. Then it asks you to reboot. Do so and log in afresh using the aforementioned user name as before. Bureaucracy will abide with the accession and eventually finish. Dont arrest it before, this will cede the accession useless!

    After bureaucracy has finished, install the latest amend for your adaptation of WebObjects. Reboot if asked to do so.

    Congratulations! WO Bureaucracy is complete.

    Having all the WebObjects files on you deejay does not beggarly sunshine immediately. Actuality comes what I alarm the column WebObjects setup.

    Open Services:

    %systemroot%system32services.msc /s

    You will acquisition the afterward WebObjects accompanying services. The name of the account is accounting into brackets - you can use that name to start/stop these casework from the command line.

    These two are installed in both Development and Deployment:

    This account manages all active appliance instances. It should be set to run automatically at startup on both Development and Deployment.

    This account provides a user interface to make new and administer absolute appliance instances, array of a frontend to wotaskd. It is not bare to alpha and administer appliance instances and should (for aegis reasons) be set to run manually. To alpha it, accessible a carapace and enter:

     net alpha womonitor5

    After the time it takes to alpha (usually alone some seconds), you can accessible a browser and point to http://:56789 to see the first page. To advance security, go to the Preferences tab and set a countersign for accessing Monitor. Then use it like you commonly would. To stop it afterwards use, enter:

     net stop womonitor5

    In WebObjects 5.0, wotaskd and Adviser are not installed as casework by default. To change this, you will charge the instsrv and srvany accoutrement from the acknowledging files package. Actuality comes a quick step-by-step adviser to install wotaskd and Adviser as services, for added advice see srvany.doc that comes with srvany.exe

    Move the Alpha Assignment Apparition adjustment out of the Startup binder to stop wotaskd from starting if you log in. I consistently put it into the WebObjects binder but you can annul it as well.

    Open a carapace and access instsrv wotaskd c:applesrvany.exe

    Change the DisplayName acreage to Angel WebObjects Assignment Daemon

    Change the Alpha acreage to 2 if it is not already 2. This agency that the account should alpha automatically.

    Under this subkey, make a new Appliance acreage (type string) with the afterward value: C:AppleLibraryWebObjectsJavaApplicationswotaskd.woaStartWOTaskD.exe

    Do not use %NEXT_ROOT% actuality - this may not yet be accessible if the account is about to be started consistent in a failure. Use the complete aisle name to your WebObjects basis binder instead.

    

    After reboot, you should be able to appearance http:\:1085 from addition apparatus after logging in to the Windows box. If this works you accept done aggregate correctly.

    If you wish to install Adviser as a service, too, do the following.

    Change DisplayName to Angel WebObjects Monitor

    Change Alpha to 3 which agency chiral startup. If you do not accept to affliction about security, you can set it to 2 (automatic startup).

    Under this subkey, make a new Appliance acreage (type string) with the afterward value:

    C:AppleLibraryWebObjectsJavaApplicationsJavaMonitor.woaJavaMonitor.cmd

    C:AppleLibraryWebObjectsJavaApplicationsJavaMonitor.woa

     -WOPort 56789

    You can specify added command band arguments actuality if you like.

    Now, try to alpha Monitor. Accessible a carapace and enter

    net alpha womonitor

    After a few seconds, accessible your browser and go to http://:56789. You should see Monitors starting page.

    These two casework - calm with Pasteboard Server and Window Server - accommodate the abject to run YellowBox applications (most of the WebObjects Developer Tools) on Windows. You dont accept to affliction about them, just set them to alpha automatically.

    This account starts the Openbase database engine and provides several sample databases. If you dont wish to use OpenBase, you can save anamnesis by ambience the startup blazon to Chiral which prevents this account from starting automatically. To get rid of the Openbase processes that are active at the moment, you can either reboot or annihilate all accordant processes using the annihilate apparatus (included in the acknowledging files package). Accessible a carapace and enter:

     annihilate OpenBase.exe

     annihilate pgroup.exe

     annihilate databackup.exe

     annihilate openinfo.exe

    Never set the startup blazon of an access to Disabled unless you are asleep abiding what you are doing! Chiral casework can be started from the arrangement as bare while disabled casework cannot be started at all (unless you baddest a altered startup type). Disabling the amiss casework may anticipate the arrangement from booting and is not advised to be a acceptable idea.

    Besides all those services, for a Development accession there are two shortcuts with the afterward settings in the All Users Startup folder:

     Target: %NEXT_ROOT%LibraryFrameworksAppKit.frameworkResourcespbs.exe

     Alpha in: %NEXT_ROOT%LibraryFrameworksAppKit.frameworkResources

     Run: Minimized

     Target: %NEXT_ROOT%LibrarySystemWindowServer.exe

     Alpha in: %NEXT_ROOT%LibrarySystem

     Run: Minimized

    Pasteboard Server and Window Server are started everytime a new user logs on. With Fast User Switching, added than one user can be logged in at the aforementioned time, causing Pasteboard Server and Window Server to be started added than once. Both programs dont like it and stop alive which in about-face causes the developer accoutrement (ProjectBuilder, EOModeler, WOBuilder) to stop working, too. ;-(

    Workaround: If alone one user on the apparatus is developing with WebObjects, move the shortcuts for Pasteboard Server and Window Server from the All Users Startup binder to the claimed Startup binder of the adapted user. If added than one user on the apparatus is developing with WebObjects, create abiding they are not logged in at the aforementioned time. If annihilation abroad helps, you can attenuate Fast User Switching.

    There are at atomic two bugs if installing WebObjects Updates:

    Open Arrangement in Ascendancy Panel. On the Avant-garde tab, bang Ambiance Variables, then bang the name of the user capricious or arrangement capricious you wish to change, as follows: Bang New/Edit/Delete to add/change/remove a new capricious name and value. You may accept to abutting and reopen active programs for the new settings to yield effect. To amend all active casework with the new values, it may be easier (and beneath absurdity prone) if you just reboot the apparatus already more.

    The afterward ambiance variables should is afterwards WO setup:

    one contains the aisle to several libraries acclimated be the WebObjects developer accoutrement and should point to C:AppleDeveloperLibraries. You usually dont accept to change annihilation here, it is just mentioned for completeness.

    New: Dont change the carve in NEXT_ROOT into a backslash! Just leave it as it is. The accumulation of the adaptor sources will fail, if you do this. Its all my fault, that I appropriate contrarily in a antecedent version.

    The afterward three entries are the alone ones bare by WebObjects but they are usually bifold by active the WebObjects Update. This does not abuse except that it makes the Aisle capricious accidental long. Be abiding to cover the afterward alone already (this assumes that you accept installed WebObjects to C:Apple):

    C:AppleLibraryExecutables;

    C:AppleLibraryJDKin;

    C:Applein;

    For the user accounts acclimated to advance and run WebObjects applications, abolish both TMP and Acting from the user variables area and add them to the all users section. Change Acting and TMP to a aisle after spaces, like c: emp. You may accept to make c: emp if it does not is yet. IMHO, that makes award barrage Software zombies, log files and additional WebObjects acting being abundant easier.

    To apple-pie the zombies, you alternatively can use any appliance you accept accounting and alpha it in a carapace with the apple-pie parameter:

     cd myapp.woa

     myapp.cmd clean

    This contains the aisle to the extensions binder for added JAR files. A archetypal aisle is C:/PROGRA~1/Java/J2RE14~1.0/lib/ext. Be abiding not to put spaces in here, either move your JRE to addition binder or use abbreviate names (8dot3 characters like old MSDOS).

    This specifies the aisle to the SDK acclimated by WebObjects applications you write. A archetypal aisle is C:/J2SDK1~1.0. Aswell like above, dont use spaces in the aisle name.

    As against to the SDK you specify here, the WebObjects developer accoutrement consistently use JDK 1.1.8 in %NEXT_ROOT%LibraryJDK - you dont accept to affliction about that.

    If you accept installed WebObjects Development but wish to absolutely use its Deployment capabilites (like assorted instances, absolute requests etc.) you accept to advancement your authorization to the Deployment version. There are two means to do this. First one is to use the Authorization Upgrader. Accessible a carapace and enter:

     %NEXT_ROOT%DemosJavaWebObjectsLicenseUpgrader.appJavaWebObjectsLicenseUpgrader.exe

    Alternatively, you can accessible it via Start, Programs, WebObjects, WebObjects 5 Authorization Upgrader. The additional way (if the Authorization Upgrader does not start) is to adapt the key book with a argument editor (Notepad would be okay). Just alpha the editor and open

     %NEXT_ROOT%LibraryFrameworksJavaWebObjects.frameworkResourcesLicense.key

    Delete the old authorization key and admit the new one.

    You accept to restart wotaskd and (if it is running) Adviser for the changes to yield effect:

     net stop wotaskd5

     net stop womonitor5

     net alpha wotaskd5

     net alpha womonitor5

    There is a animal bug in the IIS adaptor that acutely degrades achievement if it is put beneath abundant load. You will ability about 3 to 5 requests per additional and anamnesis will be eaten at acute speed, consistent in OutOfMemoryExceptions afterwards just a few sessions accept been created. This happens whenever you use the ISAPI adaptor, even if your applications run on addition apparatus with a altered OS.

    Luckily, Karl Hsu begin a fix to this which I am acutely beholden for. Acknowledgment Karl! Karl states that you should absorb this fix alone if you are seeing massive achievement problems, so do some analysis afore patching. The Apache Criterion apparatus ab (included in abutment files package) can be acclimated for this.

    Both files, request.h and request.c can be begin at %NEXT_ROOT%DeveloperExamplesWebObjectsSourceAdaptorsAdaptor

    Patched versions of request.h and request.c that cover the cipher beneath are aswell included in the abutment files package. If you did not create changes to these two files yourself, you can archetype them to %NEXT_ROOT%DeveloperExamplesWebObjectsSourceAdaptorsAdaptor and alpha accumulation appropriate away.

    Else, in request.h, seek for #include WOURLCUtilities.h and add the afterward band appropriate below:

     #include wastring.h

    In request.c, seek for the alpha of the adjustment int req_sendRequest (around band 217) and add the afterward cipher block _before_:

     #ifdef WIN32

     changeless abandoned req_appendHeader(const burn

     str_append(headers, key);

     str_appendLiteral(headers, : );

     str_appendLength(headers, val, valLength);

     str_appendLiteral(headers,
);

     }

     int req_sendRequest(HTTPRequest

     buffers[0].iov_base = headersString->text;

     buffers[0].iov_len = headersString->length;

     buffers[1].iov_base =
;

     buffers[1].iov_len = 2;

     bufferCount = 2;

     if (req->content_length > 0)

     aftereffect = transport->sendBuffers(socket, buffers, bufferCount);

     str_free(headersString);

     WOFREE(buffers);

     if (result == 0)

     aftereffect = transport->flush_connection(socket);

     else

     WOLog(WO_ERR, absurdity sending request);

     acknowledgment result;

     }

     #else

    Now, appropriate afterwards this #else comes the aboriginal req_sendRequest method. Go to the end of this adjustment and admit a #endif in the next line.

    When you accept sucessfully patched the antecedent file, it is time to...

    Next bug: The makefile expects the OS ambiance capricious to be either abandoned or accommodate the cord WINDOWS. Unfortunately, the amount of OS is WINDOWS_NT instead of WINDOWS so the create action will abort to abridge the ISAPI adaptor. You could change the makefile so it works with WINDOWS_NT but you will accept to do _a lot_ of alteration then.

    Instead, lets just change the OS variable. However, dont change this assuredly via ascendancy panel, as I do not understand if it is bare elsewhere. Just ambience it to the able amount afore abridge is enough. Accessible a carapace and enter:

     cd /d %NEXT_ROOT%DeveloperExamplesWebObjectsSourceAdaptors

     set OS=WINDOWS

     create clean

     make

    If accumulation was acknowledged (no absurdity messages), we now should accept the WebObjects adaptor as EXE (CGI) and DLL (ISAPI) file. These two should be affected to the able area (change c:inetpub to bout your system).

     net stop w3svc

     archetype /y cgiwebobjects.exe c:inetpubscripts

     archetype /y iiswebobjects.dll c:inetpubscripts

     net alpha w3svc

    Stopping IIS afore artful prevents accessible administration violations for the ISAPI adaptor as you cannot overwrite the book if it has already been loaded by IIS.

    Now that you accept aggregate the ISAPI adaptor, you accept to configure it. For a individual server deployment (IIS and wotaskd on the aforementioned machine), no added agreement is necessary. However, if you accept wotaskd active on addition machine, or wish to use added than one appliance server, you accept to acquaint the adaptor area to attending for them. The way that consistently formed for me is via host account in the registry.

    Open Regedit (open a carapace and access regedit) and go to:

     HKEY_LOCAL_MACHINESOFTWAREAppleWebObjects

    If it does not is yet, make a new subkey and name it Configuration. Then go to:

     HKEY_LOCAL_MACHINESOFTWAREAppleWebObjectsConfiguration

    and add the afterward two keys (type REG_SZ):

     CONF_INTERVAL 10

    This agency that every 10 seconds, the ISAPI adaptor will allocution to the wotaskds and re-read the configuration.

     CONF_URL http://host1:1085,http://host2:1085,http://host3:1085

    This is a comma-separated account of all hosts, on which a wotaskd is running. 1085 is the absence port. Just add all appliance servers and be abiding not to put spaces afterwards the commata - WO does not like spaces. If you accept anchored IP-addresses, you can specify them, contrarily use hostnames and create abiding the IIS apparatus can boldness hostnames to accurate addresses. This should be no problem if all machines run Windows, contrarily you accept to use a DNS server or a host file.

    Now that aggregate should be set up properly, it is time for a baby test. First, lets attending if wotaskd is working.

    Open a browser and go to http://:1085

     If it works, you should see the hosts agreement displayed in the browser. Now, accessible a carapace and alpha Adviser if it is not already running:

     net alpha womonitor5

    Wait a few seconds, then point the browser to http://:56789

    You should see Monitors capital window. Now you can alpha autograph and deploying applications. Accept fun!

    Q: I accumulate accepting the afterward barring if active the WO applications:

    

java.io.UnsupportedEncodingException: NSMacOSRomanStringEncoding

    A: Create abiding the charsets.jar library is in your Java runtime path. This is installed in the JDK but not consistently in the JRE.

    1.3: 2002-08-29

    - removed advancement to change the carve in NEXT_ROOT into a backslash, because this break accumulation of the adaptor sources

    1.2: 2002-07-26

    - added accomplish to install wotaskd and Adviser as casework in WebObjects 5.0

    1.1: 2002-07-10

    - added two workarounds for errors during WebObjects bureaucracy on WinNT

    1.0: 2002-07-09

    - first accessible release

    0.9: 2002-06-28

    - plan in progress