37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle/*
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * CDDL HEADER START
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle *
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * The contents of this file are subject to the terms of the
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * Common Development and Distribution License, Version 1.0 only
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * (the "License"). You may not use this file except in compliance
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * with the License.
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle *
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * or http://forgerock.org/license/CDDLv1.0.html.
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * See the License for the specific language governing permissions
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * and limitations under the License.
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle *
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * When distributing Covered Code, include this CDDL HEADER in each
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * file and include the License file at legal-notices/CDDLv1_0.txt.
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * If applicable, add the following below this CDDL HEADER, with the
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * fields enclosed by brackets "[]" replaced with your own identifying
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * information:
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * Portions Copyright [yyyy] [name of copyright owner]
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle *
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * CDDL HEADER END
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle *
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle *
37c999796383567df3db1f9d2a09942d83d413caChad Kienle * Copyright 2008 Sun Microsystems, Inc.
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle * Portions Copyright 2011 ForgeRock AS
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle */
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle WHAT is winlauncher.exe
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle ========================
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienlewinlauncher.exe is a small windows executable that is intended to be used by
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienlethe command line files to perform certain operations. It is not intended to
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienlebe a final user interface and that is one of the reasons why is placed under
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienlethe lib subdirectory.
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle
37f9df7d5b474a12668813f98992dceb7c7feacbChad KienleSee the comments in winlauncher.c file and common.c for more information.
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle WHAT is opendj_service.exe
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle ========================
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienleopendj_service.exe is a small windows executable that is intended to be used by
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienlethe command line files to be able to run OpenDJ as a windows service (or not
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienleto configure it as windows service). It is not intended to be a final user
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienleinterface and that is one of the reasons why is placed under the lib
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienlesubdirectory.
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle
37f9df7d5b474a12668813f98992dceb7c7feacbChad KienleSee the comments in service.c file and common.c for more information.
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle WHAT is launcher_administrator.exe
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienle ========================
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienlelauncher_administrator.exe is a small windows executable that is intended to
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienlebe used by the command line files to launch operations that require
37f9df7d5b474a12668813f98992dceb7c7feacbChad Kienleadministrator privileges on Vista. Basically is a wrapper containing a
manifest that specifies to require administrator privileges to be run. This
is required if UAC is enabled on Vista so that we have a prompt for the user
asking for confirmation.
See the comments in winlauncher.c file and common.c for more information.
INSTRUCTIONS TO COMPILE winlauncher.exe
========================
Using Visual C++ and the command line you must set your environment
variables to point to your Visual Studio install. You can set the environment
variables by changing to the \bin subdirectory of your Visual C++ installation
and running the VCVARS32.bat batch file.
This will basically update your PATH, INCLUDE and LIB environment variables
to point to the correct paths of your Visual Studio install.
Go to the directory where the source files winlauncher.c, winlauncher.h,
common.c and common.h are and launch the following command:
> cl winlauncher.c common.c
This will generate the binary winlauncher.exe.
NOTE: An alternative to this mode is to compile winlauncher.exe using the
Makefile by running:
> nmake all
(See INSTRUCTIONS TO COMPILE opendj_service.exe for more information).
************************
Using Visual C++ graphical interface you just must to Create a Project and add
winlauncher.c, winlauncher.h, common.c and common.h to the project.
You can build winlauncher.c and then winlauncher.exe with the commands in the
menu 'Build'.
************************
Using gcc (for instance you can get it with the open source project MinGW -
Minimalist GNU for Windows), you must include the directory where the gcc
binaries are on your PATH environment variable.
Go to the directory where the source files winlauncher.c and winlauncher.h are
and launch the following command:
> gcc common.c winlauncher.c -o winlauncher.exe
This will generate the binary winlauncher.exe.
INSTRUCTIONS TO COMPILE opendj_service.exe and administrator_launcher.exe
========================
service.c (the main code file for opendj_service.exe) uses windows resources and
so it requires Windows libraries to be compiled.
The fastest way of generating opendj_service.exe is to do it using the command
line.
Using Visual C++ and the command line you must set your environment
variables to point to your Visual Studio install. You can set the environment
variables by changing to the \bin subdirectory of your Visual C++ installation
and running the VCVARS32.bat batch file.
Then go to the directory where the source files are and run the following
command:
> nmake all
This command will generate both opendj_service.exe and winlauncher.exe.
See the comments in the file Makefile for more information.