Windows Service
From Resin 3.0
(Difference between revisions)
| Line 11: | Line 11: | ||
[[Image: windows-setup.png]] | [[Image: windows-setup.png]] | ||
| + | |||
| + | ; Resin Home | ||
| + | : The location of the Resin binaries, which is the same directory as the setup.exe script. | ||
| + | ; Services | ||
| + | : List of installed Resin already-installed services. Choose one or create a new service. | ||
| + | ; Java Home | ||
| + | : The location of the JVM you want to use. Typically the default will be the latest version installed on your machine. | ||
| + | ; Resin Root | ||
| + | : The root directory for your content. Many sites will change the Resin root to something like c:\www. | ||
| + | ; Resin Conf | ||
| + | : The path to the Resin configuration file | ||
| + | ; Log Directory | ||
| + | : The directory where Resin's log files will be placed. | ||
| + | ; Service Name | ||
| + | : The windows service name for Resin, typically "Resin" | ||
| + | ; Service User | ||
| + | : The windows user running the service. It can be a good idea to create a special account for Resin for security reasons. | ||
| + | ; Service Password | ||
| + | : The windows password for the windows user. | ||
| + | ; Preview | ||
| + | : The default is usually appropriate. This choice lets you select a different deployment stage for the installation. | ||
| + | ; Server | ||
| + | : Selects the -server value defined in the resin.xml. In a cluster, each server has a unique name that must be selected here. | ||
| + | ; Watchdog Port | ||
| + | : Lets you change the watchdog port from the default 6600. | ||
| + | ; JMX Port | ||
| + | : If you're using jconsole, you can specify the JMX port for the started Resin instance. | ||
| + | ; Debug Port | ||
| + | : If you're using JVM debugging, you can specify the JVM's debugging port for the started instance. | ||
| + | ; Extra Params | ||
| + | : Any command line arguments | ||
| + | |||
| + | == starting Resin == | ||
| + | |||
| + | By default, the setup.exe script installs Resin in "automatic" mode, which means it will be started when Windows starts, but it does not start Resin immediately. | ||
| + | |||
| + | To start Resin, | ||
| + | # go to the control panel / administration tools / services and start Resin manually | ||
| + | # or use "net start Resin" from a console (you may need to start the console in secure mode) | ||
| + | # or restart windows | ||
Revision as of 22:10, 15 October 2010
overview
When installing Resin as a windows service, you have a few options, including configuring the service manually. The easiest method, however is to use the Resin setup.exe program.
setup.exe
For a simple configuration, the only values you may need to change are the service user and password, because it is generally more secure to run Resin as a non-administrator.
- Resin Home
- The location of the Resin binaries, which is the same directory as the setup.exe script.
- Services
- List of installed Resin already-installed services. Choose one or create a new service.
- Java Home
- The location of the JVM you want to use. Typically the default will be the latest version installed on your machine.
- Resin Root
- The root directory for your content. Many sites will change the Resin root to something like c:\www.
- Resin Conf
- The path to the Resin configuration file
- Log Directory
- The directory where Resin's log files will be placed.
- Service Name
- The windows service name for Resin, typically "Resin"
- Service User
- The windows user running the service. It can be a good idea to create a special account for Resin for security reasons.
- Service Password
- The windows password for the windows user.
- Preview
- The default is usually appropriate. This choice lets you select a different deployment stage for the installation.
- Server
- Selects the -server value defined in the resin.xml. In a cluster, each server has a unique name that must be selected here.
- Watchdog Port
- Lets you change the watchdog port from the default 6600.
- JMX Port
- If you're using jconsole, you can specify the JMX port for the started Resin instance.
- Debug Port
- If you're using JVM debugging, you can specify the JVM's debugging port for the started instance.
- Extra Params
- Any command line arguments
starting Resin
By default, the setup.exe script installs Resin in "automatic" mode, which means it will be started when Windows starts, but it does not start Resin immediately.
To start Resin,
- go to the control panel / administration tools / services and start Resin manually
- or use "net start Resin" from a console (you may need to start the console in secure mode)
- or restart windows
