Notes for Windows users

The examples in this document are shown for Linux, so if you are running Windows#MATH9# please make the following changes as you read what follows:¹

• Replace forward-slashes with backslashes for directory separators.
• Make sure the Jtrix binaries (the .bat scripts and JAR files) are on your path. This is achieved in either of two ways.

  The first option is to ensure you run everything from within the Jtrix binary directory.

  The second option is to add the Jtrix binary directory to your Path environment variable. Let us suppose this is the directory C:\jtrix\bin. The we go to Start | Control Panel | System | Advanced | Environment Variables. In the section marked ``System variables'' select the variable Path and Edit... it so that C:\jtrix\bin is on the end. Don't forget to put a ; (semi-colon) separator in front of it.

  Whichever method you use, you should not put the .bat on the end of the script names.

• Make sure your JAVA_HOME is set properly. Your particular Java distribution should have done this for you.
• In the long lines that you see below we have added a backslash before each carriage return to tell Linux that we've not finished the line yet. In Windows you will just have to type it all on one long line and then hit carriage return at the end.
• If a Jtrix script or JAR has a parameter of the form key=value then you will need to include those in double-quotes like this:

  
  

  C:\> jnode 100 -netlet-stdio hos01-boot.xml "hosting-out=hos01-admin.xml"
       telnet-2000.xml "hosting-in=hos01-admin.xml"
       sas01-boot.xml "hosting-in=hos01-admin.xml"
           "hosting-out=hos01-real-admin.xml" "sas-out=sas01-warrant.xml"
           "sas-desc=sas01-real-desc.xml"
  

Finally, note that the version of Jtrix discussed here is not necessarily compatible with previous versions, so please check you have the latest version. In particular, if you are interacting with a service outside your local environment, such as one at http://www.jtrix.org, then different versions are not guaranteed to be compatible. Jtrix.org will always be running the latest version. This will continue until a 1.0 release, although we will of course try to minimise this as much as possible.

If you have any problems, check out the troubleshooting tips in Appendix  or drop us a note on the Sourceforge mailing lists.