Installing JRun
Installing JRun

Additional installation options

This section describes the following installation options:

• Installing JRun as a Windows service (Windows only)
• Silent installation (UNIX and Windows)

Typically, these options are useful in production systems and for OEM use.

Windows services considerations

If you are running Windows NT, XP, or 2000, during installation, you can configure JRun servers to run as services or applications. If you choose Windows services, the JRun servers start every time you start your Windows system. Services run as system processes rather than as user processes. You can also use the Services utility to start, stop, and restart the JRun servers.

If you do not run JRun as a Windows service, it runs as an application.

Installing JRun as a Windows service

JRun provides a command-line utility that you can use in the Windows environment to install a JRun server as an Windows system service. This section explains the options for this utility.

To run the command-line utility, open a console window, change to the jrun_root/bin directory, and use the following command-line syntax:

jrunsvc [-options]

The following table describes the options:

Option	Description
-install jrun_server [service-name [service-display [service-description]]]	Installs the JRun server as a Windows service. The Windows service name, Windows service display name, and Windows service description fields are optional. If a name contains spaces, use quotation marks. The default Windows service name is JRun jrun_server. The default Windows service display name is JRun jrun_server Server. The default Windows service description field is J2EE Application Server. The Windows service description field is used for Windows 2000 and ignored for other platforms.
-remove service-name	Removes the named Windows service, if you installed it using this utility. You can mark the service for deletion on system start.
-stop service-name	Starts the named service, if it is not already started.
-start service-name	Stops the named service, if it has started.
-console service-name	Runs the service from the console rather than from the Windows service Control Manager. Use this option for debugging.
-config path-to-jvm.config	Specifies a path to the JVM configuration file used by the Windows service. Overrides the default, jrun_root\bin\jvm.config, to determine the JVM configuration.
-help	Lists all options.

Silent installation

Silent mode lets the installer run without any user interaction. If you choose this option, there is no console or GUI output during the installation. Silent mode supports the setting of a target directory, shortcuts directory, and components to install using command-line arguments or a properties file.

Silent mode is supported in the installer and uninstaller runtime environments. You can set InstallAnywhere and end-user-defined variables using command-line parameters or a properties file. You can trigger silent mode using a command-line parameter or a properties file.

Installer properties file

An installer properties file is an ASCI text file in which you define the parameters for your installation. This is useful when installing for an internal and external audience. You can turn panels on or off, depending on specific needs. In addition, in the properties file, you can define the type of installation, such as console or silent.

You can name the properties files, installer.properties or installername.properties, and save the installer file as installername.exe. However, if properties files with both of these names exist in the same directory as the client executable, JRun reads only the installer.properties file.

Note:   Ensure that your properties file ends in .properties, not .txt.

If the properties file is in the same directory as your installer, the installer invokes the properties file automatically. However, if it is in a different directory, use the following command line option:

C:\\ path to the installer -f path to the properties file

Properties files variables

The installer.properties file might contain the following properties files variables:

USER_INSTALL_DIR=/opt/jrun4

INSTALLER_UI=mode [gui|console|silent]
USERNAME=(Pre set)
PASSWORD=(Pre set)
RETURN_VARIABLE=(Pre set to the product serial number)
JAVA_EXECUTABLE=/opt/jrun4/jre/bin/java
JAVA_HOME=/opt/jrun4/jre
INSTALLER_LOCALE=en
CHOSEN_INSTALL_BUNDLE_LIST=Applica, Sample, Web Ser, Documen
CHOSEN_INSTALL_SET=CUSTOMIZED_SET

Running a silent install, JRun installs all components by default. To install selected components, specify the variables as follows:

• Set CHOSEN_INSTALL_BUNDLE_LIST to the components you want to install, using their shortnames. All the components available are listed.
• Set CHOSEN_INSTALL_BUNDLE_LIST prior to setting CHOSEN_INSTALL_SET.
• Set CHOSEN_INSTALL_SET to CUSTOMIZED_SET.

Command-line parameters

To run a silent installation from the command line, use the following syntax:

installername -i [-options]

The following table describes the options:

Option	Description
-i mode	Triggers the following modes: gui | console | silent
-f propertiesfile	Calls the properties file. You can use the direct or the relative path to the properties file.

To run a Windows JRun 4 installation in silent mode, use the following command-line syntax:

Command line argument	Description
/s	Run silently.
/x	Uninstall.
/v "/qn {PROPERTY=VALUE} "	Run silently while setting internal values.

You combine the command line arguments with the internal property settings. The following table shows the internal property values for JRun 4:

Properties	Default value	Description
INSTALLDIR	C:\JRun4	(Optional) Installation directory.
JVMDIR	<none>	Path to the JRE bin directory.
ADMINPORT	<none>	(Optional) Admin server port value.
NTSERVICE	"0"	"0" Indicates to launch JRun using the Windows Start menu. "0" Installs JRun as a Windows service.

A typical silent JRun 4 installation command might appear as follows:

jrun-40-win-en.exe /s /v"/qn JVMDIR=C:\Progra~1\IBM\Java13\jre NTSERVICE=0 INSTALLDIR=C:\MyDir"

Note:   If a name contains spaces, use quotation marks.

Comments

Add Comment

jrunrandy said on Dec 2, 2003 at 8:11 AM :

The table for jrunsvc options says that stop start JRun and start stops JRun. This is obviously backwards.

Busy Bart said on Jan 19, 2005 at 1:50 AM :

I am very green in this field and to computers any help or simplifed terms would be appreciated thanks.

jrunrandy said on Jan 19, 2005 at 5:51 AM :

I suggest starting with the JRun Support Center (http://www.macromedia.com/support/jrun ) and the JRun/Java Dev Center (http://www.macromedia.com/devnet/java/ ).

No screen name said on May 16, 2005 at 8:24 AM :

Thank You for your contiual support.

RichardPeter said on Jul 15, 2005 at 6:39 AM :

I'm trying to install RJun4 silent using the installer.properties file. This fails and it looks like it is not using any of the properties. I'm using a WIN2003 server and try to install the application in D:\JRun4 without documents and samples. I also tried to install with the commandline options but here i can't set the useraccount and password to use. If i install silent using the commandline options the application installs but there are no shortcuts.

What do i put in my installer.properties file, all the paths look like unixpaths. Where are my shortcuts?

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/jrun/4/Installing_JRun/install5.htm

Add Comment