README revision a395dd575518d9e5280fc5d5d5ef47c61b174647
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * CDDL HEADER START
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * The contents of this file are subject to the terms of the
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * Common Development and Distribution License, Version 1.0 only
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * (the "License"). You may not use this file except in compliance
7ed711d973b319320da100d3e905ef7b99ed69d6Timo Sirainen * with the License.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * You can obtain a copy of the license at
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * trunk/opends/resource/legal-notices/OpenDS.LICENSE
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * or https://OpenDS.dev.java.net/OpenDS.LICENSE.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * See the License for the specific language governing permissions
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * and limitations under the License.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * When distributing Covered Code, include this CDDL HEADER in each
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * file and include the License file at
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable,
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * add the following below this CDDL HEADER, with the fields enclosed
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * by brackets "[]" replaced with your own identifying information:
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * Portions Copyright [yyyy] [name of copyright owner]
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * CDDL HEADER END
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen * Copyright 2008 Sun Microsystems, Inc.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen ========================
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenwinlauncher.exe is a small windows executable that is intended to be used by
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenthe command line files to perform certain operations. It is not intended to
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenbe a final user interface and that is one of the reasons why is placed under
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenSee the comments in winlauncher.c file and common.c for more information.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen ========================
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenopends_service.exe is a small windows executable that is intended to be used by
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenthe command line files to be able to run OpenDS as a windows service (or not
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainento configure it as windows service). It is not intended to be a final user
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Siraineninterface and that is one of the reasons why is placed under the lib
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenSee the comments in service.c file and common.c for more information.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen ========================
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenlauncher_administrator.exe is a small windows executable that is intended to
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenbe used by the command line files to launch operations that require
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenadministrator privileges on Vista. Basically is a wrapper containing a
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenmanifest that specifies to require administrator privileges to be run. This
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenis required if UAC is enabled on Vista so that we have a prompt for the user
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenSee the comments in winlauncher.c file and common.c for more information.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen ========================
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenUsing Visual C++ and the command line you must set your environment
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenvariables to point to your Visual Studio install. You can set the environment
7ed711d973b319320da100d3e905ef7b99ed69d6Timo Sirainenvariables by changing to the \bin subdirectory of your Visual C++ installation
7ed711d973b319320da100d3e905ef7b99ed69d6Timo SirainenThis will basically update your PATH, INCLUDE and LIB environment variables
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainento point to the correct paths of your Visual Studio install.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenGo to the directory where the source files winlauncher.c, winlauncher.h,
7ed711d973b319320da100d3e905ef7b99ed69d6Timo Sirainencommon.c and common.h are and launch the following command:
7ed711d973b319320da100d3e905ef7b99ed69d6Timo SirainenNOTE: An alternative to this mode is to compile winlauncher.exe using the
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen(See INSTRUCTIONS TO COMPILE opends_service.exe for more information).
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen************************
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenUsing Visual C++ graphical interface you just must to Create a Project and add
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenwinlauncher.c, winlauncher.h, common.c and common.h to the project.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenYou can build winlauncher.c and then winlauncher.exe with the commands in the
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen************************
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenUsing gcc (for instance you can get it with the open source project MinGW -
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenMinimalist GNU for Windows), you must include the directory where the gcc
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenbinaries are on your PATH environment variable.
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenGo to the directory where the source files winlauncher.c and winlauncher.h are
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainen> gcc common.c winlauncher.c -o winlauncher.exe
97437f768d1a3e6134fed1971202803fd250eef2Timo Sirainen INSTRUCTIONS TO COMPILE opends_service.exe and administrator_launcher.exe
97437f768d1a3e6134fed1971202803fd250eef2Timo Sirainen ========================
97437f768d1a3e6134fed1971202803fd250eef2Timo Sirainenservice.c (the main code file for opends_service.exe) uses windows resources and
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenThe fastest way of generating opends_service.exe is to do it using the command
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenUsing Visual C++ and the command line you must set your environment
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenvariables to point to your Visual Studio install. You can set the environment
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo Sirainenvariables by changing to the \bin subdirectory of your Visual C++ installation
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenThen go to the directory where the source files are and run the following
b8b085f7bc6f1c0367802a9f00062bbbd981690dTimo SirainenThis command will generate both opends_service.exe and winlauncher.exe.