View comments | RSS feed

After installing JRun

Perform the following steps to get started using JRun.

To start using JRun:

  1. Read the JRun 4 Release Notes located at jrun_root/readme.htm.
  2. Start a JRun server.

    For more information, see "Starting and stopping JRun servers".

  3. (Optional) Log in to the JRun Management Console.

    For more information, see "Starting the JMC". For usage information, see the JMC Online Help.

  4. (Optional) Configure the connection between JRun and an external web server (such as Apache or IIS).

    For more information, see Chapter 3, "Connecting JRun to External Web Servers".

Starting and stopping JRun servers

JRun provides utilities to start, stop, and perform other functions on the JRun servers. This section describes these utilities for Windows and UNIX platforms.

You can start and stop JRun servers using the following techniques:

For more information, see JRun Administrator's Guide.

Using the JRun server launcher

The JRun server launcher is a Java Swing application that you can use to start, stop, and restart JRun servers. You execute the launcher by running the jrun.exe file (Windows) or the jrun executable (UNIX), in the jrun_root/bin directory. The launcher contains buttons to start, stop, and restart JRun servers.

Using the command line

You can start JRun using the jrun.exe and jrun shell script command-line utilities. Use the following syntax:

jrun {options} {server-name}

The following table describes the options:
Option
Description
-start
Starts JRun.
-stop
Stops JRun.
-restart
Restarts JRun.
-status
Displays status information for all JRun servers or for a specified JRun server.
-nohup
Starts JRun in a separate process.
-config path-to-jvm.config
Specifies a path to the JVM configuration file. Overrides the default, jrun_root/bin/jvm.config, to determine the JVM configuration.
-version
Displays the JRun version number (primarily for OEM use).
-build
Displays the JRun build number (primarily for OEM use).
-info
Displays additional information (primarily for OEM use).

Starting the JMC

The JRun Management Console is a web application that provides a browser-based interface for configuring JRun. To use the JMC, you must install Netscape Communicator 4.77 or 6.x, Internet Explorer 5.5 or later, or Mozilla .096 or later.

To launch the JMC:

  1. Start the admin JRun server.

    For more information, see "Starting and stopping JRun servers".

  2. Start the JMC in UNIX or Windows by opening the following URL in your web browser: http://localhost:8000.

    Note:   This procedure assumes that you are connecting to the JMC on the default JWS port 8000. If not, substitute 8000 with the admin JRun web server port number, located in the jrun_root/servers/admin/SERVER-INF/jrun.xml file, in the following lines:

      <service class="jrun.servlet.http.WebService" name="WebService">
      <attribute name="port">8000</attribute>
      <attribute name="interface">*</attribute>
      </service>
    

    The JMC login window appears:

    This figure shows the JMC login window.

  3. Enter your user name and password, and click Login.

    Note:   You set your user name and password during JRun installation (see ).

    The Welcome to JRun window appears:

    This figure shows the JMC Welcome to JRun window.

    In the Available Servers table, you can edit, start, and stop JRun servers.

  4. Use the icons or click the server name for additional server information.
  5. To get online Help, click the Help icon in the top JMC menu bar.

    This figure shows the JMC online Help button.

Comments


stonie2003 said on Jun 7, 2003 at 6:12 AM :
its very good syetem i hope it helps me a lot
stonie2003 said on Jun 7, 2003 at 6:14 AM :
very good syetem i hope it will work good with me
kirk@ddptrain.com said on Aug 18, 2003 at 9:12 PM :
Does an osx jrun panel exist?
vyju said on Aug 22, 2003 at 10:12 AM :
I have installed JRun4 webser 4months ago, I have not tried to run the server since then.
Now Iam going through the after installation notes. I am stuck while starting the JMC; it asks for username
and password which I created during installing the software.
The problem here is I dont remember the username and password. Now what should I do?

Please let me know

thanks
vyju
No screen name said on Aug 31, 2003 at 12:53 PM :
Platform OS X

Is it possible to auto start a server on restart? Seems a pain to have to do it manually every time I start up
Alphagetties said on Apr 16, 2004 at 10:57 PM :
a start up on login would be nice for os x.

Is anyone else having very long response times with JRun 4 on Mac os
X. My startups using Jrun Launcher take forever
dio said on May 7, 2004 at 3:40 PM :
i too have a long wait time for the servers to start. anyone figured out
how to auto start a server on sytem boot? please advise.
Neil Y said on Feb 22, 2005 at 10:00 AM :
I am also looking for a way to automatically start JRun admin server at boot up. As of 2/22/2005, this matter is not discussed anywhere on the Macromedia site.
jrunrandy said on Feb 22, 2005 at 1:44 PM :
I think that the JRun install does this automatically. If not, you can use the standard UNIX etc/init.d directory to automatically start the JRun admin server. The command to start the admin server is jrun_root/bin/jrun -start admin
Neil Y said on Feb 22, 2005 at 2:03 PM :
The standard JRun install that I performed did not make the JRun server start by default at boot up. Also, the standard startup for JRun (if placed in init.d or other startup directories) will halt the boot process. The reason I found is that it does not actually run as a daemon per se but requires the shell session to continue running. In other words, if you log in and type this:

jrun_dir/bin/jrun -start admin

it will start the server but keep your session open. If you press ctrl-c or log out in some way, the admin server dies too. However, I found the command (buried in JRun Administrator's Guide docs) "-nohup" which starts the server without keeping a shell open.

/jrun_dir/bin/jrun -nohup -start admin

If this is placed in a script that is executed at boot up it will start the server and won't halt the rest of the UNIX/Linux machine's boot process. I chose to append to rc.local where it is run at boot time.

However, I doubt that this is a 'graceful' solution. I have no idea what happens when I do a reboot or whether it shuts down gracefully, although so far rebooting doesn't cause any obvious errors. In other words, this solution is functional, but probably not pretty. ...and the -nohup arg for jrun boot startup is very well hidden in the documentation.
tamcy said on Feb 23, 2005 at 3:51 PM :
Great article about writing OS X Startup Items…
http://www.macdevcenter.com/pub/a/mac/2003/10/21/startup.html

It really works!
tamcy said on Feb 23, 2005 at 4:06 PM :
as root or sudo
cd /System/Library/StartupItems

mkdir JRun

cd JRun

create file named StartupParameters.plist
with the following content:
{
Description = "JRun application server";
Provides = ("Application Server");
Requires = ("DirectoryServices");
Uses = ("NFS");
OrderPreference = "None";
}
save file.
next, create a file named JRun. (It must have the same name as
the directory where it lives.) with the following content:
#!/bin/sh

##
# Macromedia JRun J2EE Application Server
##

. /etc/rc.common

StartService ()
{
ConsoleMessage "Starting default JRun server"
cd /Library/JRun4/bin
./jrun -start default &
}

StopService ()
{
ConsoleMessage "Stopping default JRun server"
cd /Library/JRun4/bin
./jrun -stop default
}

RestartService ()
{
ConsoleMessage "Restarting default JRun server"
cd /Library/JRun4/bin
./jrun -restart default &
}

JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/
Versions/1.4.2/Home/bin/java; export JAVA_HOME
RunService "$1"

You'll need to insert your own paths to java and JRun start up
scripts.

Next Restart to make sure it works.
donald2002 said on Feb 28, 2005 at 11:11 PM :
I have a problem about shutdown the jun in LINUX system.
I install the jrun as a service when boot up, and record the startup context in log. The logs show s well.
Hoever, the jrun can't stop when the system is halt or reboot. No stop context info is recorded down.

Hope somebody can help.

Here's the script:

#!/bin/sh
#
# chkconfig: 345 77 82
# description: starts/stop the Jrun server
#

Jrun_bin=/opt/jrun4/bin

case "$1" in
'start')

echo "Starting JRun"

su - jrun -c "$Jrun_bin/jrun -start >> /var/log/jrund.log 2>&1 "

touch /var/lock/subsys/jrun4
;;
'stop')

echo "Stopping JRun"

su - jrun -c "$Jrun_bin/jrun -stop >> /var/log/jrund.log 2>&1 "

rm -f /var/lock/subsys/jrun4
;;
'restart')
$0 stop
$0 start
;;
'status')
$Jrun_bin/jrun -status
;;
*)
echo "Usage: jrun {start|stop|restart|status}"
exit 1
esac
exit 0
Ritesh Prakash said on May 11, 2005 at 4:13 AM :
Hi all

I have installed JRun v4 server on a SUN Solaris server. The install went fine and all the directories and executables were created.
The problem is that i am not able to start the Jrun admin server. I tried it as root and as a normal user. But it gives me error on trying to start the server. The commands i am using are : "sh ./jrun -start admin &" or "./jrun -start admin &" and even "./jrun" ; all of which gives me the error as :-
./jrun : syntax error at line 1 : '(' unexpected

I have downloaded the install directly on Solaris machine after reading at some discussion site that the install should not be downloaded on Windows machine. But the problem continues... Plz help.
jrunrandy said on May 11, 2005 at 5:56 AM :
In general, you will get a better and quicker answer by posting questions like this to the online forums: http://webforums.macromedia.com/jrun. However, I'll give it a shot.

When you issue the jrun command, are you located in the jrun_root/bin directory?

Maybe try changing to the jrun_root/bin directory and use ./jrun start admin
(that is, don't use a dash before start).

Also, what version of Solaris are you using? I don't know versions JRun supports, but that could be an issue.
No screen name said on Aug 31, 2005 at 8:00 PM :
I am getting a NoSuchMethodException: setURL when trying to start the admin server using the JRun Launcher. Does anyone have any idea why this is happening?
chainy said on Sep 10, 2005 at 5:53 AM :
Hi i have installed jrun4 sucsessfully on fedora 4 and all works fine but i need it to start on boot up automatically. i see and have read the article for max oXs but cannot find anything for fedora can anyone help me on this problem. thanks.

 

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/install6.htm