8.2. Set Up

The following steps are required to run the web registration interface:

  1. Install the standard JRaceman from the regular jar file installer.

  2. Install the JRaceman war file in your Java webapp container.

  3. Configure the required parameters for the web interface. At a mininmum, you must set the MeetId.

  4. Start the JRaceman database server.

  5. Start the Java webapp container.

Optionally, you can also take the following steps:

  1. To simultaneously run JRaceman against a second Meet, install another copy of jraceman.war using a different name. By default the name appears in the URL that the users must specify to access the web interface. You must then use context-path-specific parameters to configure separate values for each war file, as described below.

  2. You can change the database access parameters to make the web interface use a different JRaceman database than the default (such as hostname, port, database user and password). See the section on Webapp Configuration below.

  3. You can customize some of the web interface screens. See the section on Web Registration Options below.

In the default configuration, you must run the JRaceman database server on the same host as the Java webapp container and the JRaceman war file, and the JRaceman database must be set up with the default username and password.

JRaceman supports running simultaneous registration for multiple meets within one database. In this case, the non-Meet data such as Teams and People are shared between the meets, so if a user enters or changes data about a person for one Meet, that change will also be reflected for the other Meet.

The multiple-meets mechanism is based on the context path of each war file. To set up multiple MeetId values, open the JRaceman GUI client, go to the Database/ContextOptions tab and add an option named "MeetId" with a webContext that matches the context path for one of your JRaceman war files. For example, if you have renamed jraceman.war to nationals.war, you would put nationals in the webContext field. You can add a separate entry to the ContextOptions table for each different context path. Set the value of the option to the MeetId of the meet to be used from that war file.

There is an older mechanism for specifying context-path-specific option values. You can manually create entries in the Options table of the form WebRegistration.context.PATH.OPT where PATH is the context path and OPT is the option name. Such a value, if set, will take precedence over a value for the same PATH and OPT in the ContextOptions table.

8.2.1. Webapp Configuration

You can modify the behavior of the webapp by editing option values in the webapp configuration file, WEB-INF/web.xml in the expanded jraceman directory next to the installed jraceman.war file. To change the value of an option, find the option in the table below, look for the <context-param> entry in the web.xml file with a <param-name> value that matches the Param-Name in the table, then change the value of the <param-value> as described.

OptionParam-NameDefaultDescription
database hostdbHostlocalhostThe first part of the dbHost parameter gives the name of the JRaceman database server. This can be specified either as a hostname or as an IP address.
database portdbHost The port can be specified by adding a colon and number after the hostname. For example, if you wanted to connect to port 1234 on host foo, you would specify that as foo:1234.
database user and passworddbHost You can specify a username and password by appending them as HTTP query parameters after the database hostname (or after the port number, if that is specified). The username is called "user" and the password is called "password". For example, if you want to use username "master" and password "secret" with the standard localhost database, your web.xml file would contain this line: <param-value>localhost?user=master&amp;password=secret</param-value>. Note that you must entity-encode the ampersand (that's the &amp; part).

8.2.2. Web Registration Options

To set an option from the table below, first check the Database/Options tab in JRaceman to see if that option is available. If so, and if you are only using a single war file and thus do not need context-path-specific values, then you can simply provide the value in that form. If the form does not show that parameter, use the Database/ContextOptions tab and add an option with the name WebRegistration.OPT where OPT is the name from the below table. If you want to create a context-path-specific option, then you must use the Database/ContextOptions tab. Create an entry with the name WebRegistration.OPT and set the webContext value to the desired context path. The path-specific option value takes precedence for that context-path; if no context-path-specific option is defined, the non-path-specific option is used.

NameDefaultDescription
AdminEmail The email address of the administrator of the web registration.
BelowAccountBlurb The text to show below the account information on the Check Out page. HTML formatting tags are honored. The value for this option can include resource values by referring to them with the same "{@RES}" syntax as is used in report resource files. If no value is specified in the database, then the Web.PersonAccount.BelowAccount.blurb property resource is used.
EnableUserSignuptrueIf set to false, users can not create their own accounts. Users with existing accounts can log in. The administrator can create accounts for users.
IsLatefalseIf set to true, web users will see a Late notice under the title at the top of every web page. See the LateLabel parameter.
IsOpentrueIf set to false, existing web users can log in and view their data, but can not make changes. New registrations are not allowed.
LateLabel The label to show under the title at the top of every web page if the IsLate parameter is set to true.
MailHostmailhostThe hostname of the server through which to send email.
MeetId The ID of the Meet for which entries are being registered. This parameter is required.
PaymentInfoUrl The location of the web page that provides payment details. JRaceman puts a "Payment Info" link on the summary and team edit pages.
ShowAlternateColumntrueIf true, show the Alternate column in web registration pages. Set to false to suppress display of that column.
Url The primary URL for the web registration site.
WaiverInfoUrl The location of the web page that provides waiver details. JRaceman puts a "Waiver Info" link on the summary and team edit pages.