Installing
INSTALLING ON UNIX
To install on Unix, simply expand the compressed .tar installable image in a directory of your choice. We will refer to this directory as DWAHOME in the remainder of this manual.
INSTALLING ON WINDOWS
To install on Windows simply expand the compressed .tar installable image in a directory of your choice. We will refer to this directory as DWAHOME in the remainder of this manual.
NOTE: During the product configuration phase, you need to edit configuration files such as the dwagent.properties. Depending on the tool used to expand the compressed .tar installable image, these files might have Unix-style end-of-line terminator, which makes editing difficult using Windows Notepad: In this case, use Windows Wordpad (or any other smart editor). The product runtime will handle any type of end-of-line terminator without problems.
In the rest of this section, we will talk about the DWAgent Windows service commands (i.e. <DWAHOME>\ bin\runtimeW64\dwagentservice.bat and <DWAHOME>\bin\runtimeW64\dwagentservicemgr.bat).
Installing as Windows service
When running DWAgent on an unattended Windows server, it might be convenient to configure DWAgent to run as a service.
This can be done running the following command as administrator (JAVA_HOME environment variable must be set for the user):
dwagentservice.bat install
This command may fail in some environments, reporting that it is impossible to locate jvm.dll. If this is the case, a jvm location hint can be given on the command line as an argument via the
–jvmdll switch:
dwagentservice.bat install –jvmdll “C:\my jre\binext\jvm.dll”
To verify the installation of the DWAgent service you can run:
dwagentservice.bat ivp
Once DWAgent is installed as a service, you can optionally customize the service name (by default it is DWAgent) and other attributes by using the provided service manager GUI:
dwagentservicemgr.bat config
You can also monitor DWAgent service status at runtime by running the service manager widget (a system tray application), using this script:
dwagentservicemgr.bat monitor
Finally, the DWAgent service can be cleanly removed from Windows Services by running:
dwagentservice.bat remove
Coexistence of multiple DWAgent instances as Windows Services
Most of the times, a single DWAgent instance is required on each node. But it may happen that more than one instance is needed, e.g. when two different Administrators need to operate independently on DWAgent or when different operating system credentials must be associated to different DWA Emitters.
To install two DWAgent instances you simply need to install a second copy of DWAgent on a different DWAHOME.
When installing DWAgent as a Windows service, you also need to ensure that the two instances use different service names. You can do this by specifying the optional –service
switch on dwagentservicemgr.bat
and dwagentservice.bat
to install or administer a specific service instance.
For example, this command will install a DWAgent Windows Service named myOtherDWAgent
:
dwagentservice.bat –service myOtherDWAgent install
For more information on the available command line options please refer to the System Administration section of this documentation.
POST-INSTALLATION TASKS
After the installation, copy the provided DWAHOME/config/dwagent.properties.template to DWAHOME/config/dwagent.properties. This latter file is read at runtime by DWAgent and will be used to configure it.
INSTALLED DIRECTORY TREE
Once the product is installed, the following directories will be created in DWAHOME:
- bin/runtime: this directory contains a shell script and the batch file.
- bin/runtime/runtimeW64: this directory contains Windows specific scripts and executables (e.g. Windows service support).
- config: this directory contains the product configuration files.
- dat: this directory contains the data and caches managed at runtime by DWAgent. This data is managed by DWAgent at runtime and must not be altered or removed.
- lib: this directory contains the product jar files.
- lib-ext: this directory contains third-party products runtime jars that come bundled within DWAgent.
- lib-emitter-ext: this directory contains additional emitters jars, it is empty out-of-the-box.
- licenses: this directory contains third-party products licenses.
- logs: this directory contains all the diagnostic files produced by DWAgent at runtime.
- version: this directory contains the file with the DWAgent version installed.
Updated 12 months ago