Deploying your Service with the Makefile
The generated makefile includes a deploy target to deploy the sample service and associated client. (See Chapter 22, Options for Compiling, for more information on building your applications using the makefiles.) If you have compiled the service using MSVC on Windows, a deployment batch file is generated for your convenience. See Deploying your Service Using MSVC Files.
To deploy the service, follow the steps in this section.
NOTE: Make sure that you have set up your environment as described in Chapter 2, Setup in the HydraExpress User Guide. On Windows, be sure you have set up your command window with the MSVC environment.
If the Agent is currently running, stop it using the rwsfserver stop command:
Windows | rwsfserver stop |
UNIX/Linux | rwsfserver stop |
Run nmake (Windows) or make (UNIX or Linux) at the command prompt with the target deploy:
Windows | nmake deploy |
UNIX/Linux | make deploy |
The makefile deploys the service and client into your HydraExpress installation, as follows:
The service WSDL file, configuration files, and service descriptor web.xml are deployed to the <installdir>\apps\servlets\<servicecontextname> directory.The DLL or shared library for the service and client is placed in <installdir>\apps-bin on Windows and <installdir>/apps-lib on UNIX/Linux.For example:
Deployment Directory | Deployed Files |
|---|---|
<installdir>\apps\servlet\<servicecontextname> | myWSDL.wsdl handlers.xml transports.xml WEB-INF [subdirectory] objects.xml web.xml |
<installdir>\apps-bin (Windows) <installdir>/apps-lib (UNIX/Linux) | <bindingname>ClientLibrary12d.dll or <bindingname>ClientLibrary12d.so <portname>Service12d.dll or <portname>Service12d.so HandlersServiceSample12d.dll or HandlersServiceSample12d.so |
Restart the Agent to load the new service. To restart the Agent, run the rwsfserver start command as shown below:
Windows | rwsfserver start |
UNIX/Linux | rwsfserver start |
NOTE: For services built using the MSVC project files, do not use nmake deploy. See Deploying your Service Using MSVC Files.
