/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License, Version 1.0 only * (the "License"). You may not use this file except in compliance * with the License. * * You can obtain a copy of the license at * trunk/opends/resource/legal-notices/OpenDS.LICENSE * or https://OpenDS.dev.java.net/OpenDS.LICENSE. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at * trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable, * add the following below this CDDL HEADER, with the fields enclosed * by brackets "[]" replaced with your own identifying information: * Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END * * * Portions Copyright 2006-2007 Sun Microsystems, Inc. */ package org.opends.server.util; import java.io.BufferedWriter; import java.io.File; import java.io.FileWriter; import java.io.IOException; import java.net.InetSocketAddress; import java.net.ServerSocket; import java.net.Socket; import java.util.LinkedList; import org.opends.server.types.OperatingSystem; /** * This class provides a number of utility methods that may be used during the * graphical or command-line setup process. */ public class SetupUtils { /** * Creates a MakeLDIF template file using the provided information. * * @param baseDN The base DN for the data in the template file. * @param numEntries The number of user entries the template file should * create. * * @return The {@code File} object that references the created template file. * * @throws IOException If a problem occurs while writing the template file. */ public static File createTemplateFile(String baseDN, int numEntries) throws IOException { File templateFile = File.createTempFile("opends-install", ".template"); templateFile.deleteOnExit(); LinkedList lines = new LinkedList(); lines.add("define suffix=" + baseDN); if (numEntries > 0) { lines.add("define numusers=" + numEntries); } lines.add(""); lines.add("branch: [suffix]"); lines.add(""); lines.add("branch: ou=People,[suffix]"); if (numEntries > 0) { lines.add("subordinateTemplate: person:[numusers]"); lines.add(""); lines.add("template: person"); lines.add("rdnAttr: uid"); lines.add("objectClass: top"); lines.add("objectClass: person"); lines.add("objectClass: organizationalPerson"); lines.add("objectClass: inetOrgPerson"); lines.add("givenName: "); lines.add("sn: "); lines.add("cn: {givenName} {sn}"); lines.add("initials: {givenName:1}" + "{sn:1}"); lines.add("employeeNumber: "); lines.add("uid: user.{employeeNumber}"); lines.add("mail: {uid}@maildomain.net"); lines.add("userPassword: password"); lines.add("telephoneNumber: "); lines.add("homePhone: "); lines.add("pager: "); lines.add("mobile: "); lines.add("street: Street"); lines.add("l: "); lines.add("st: "); lines.add("postalCode: "); lines.add("postalAddress: {cn}${street}${l}, {st} {postalCode}"); lines.add("description: This is the description for {cn}."); } BufferedWriter writer = new BufferedWriter(new FileWriter(templateFile)); for (String line : lines) { writer.write(line); writer.newLine(); } writer.flush(); writer.close(); return templateFile; } /** * Returns {@code true} if we are running under Mac OS and * {@code false} otherwise. * @return {@code true} if we are running under Mac OS and * {@code false} otherwise. */ public static boolean isMacOS() { return OperatingSystem.MACOS == getOperatingSystem(); } /** * Returns {@code true} if we are running under Unix and * {@code false} otherwise. * @return {@code true} if we are running under Unix and * {@code false} otherwise. */ public static boolean isUnix() { return OperatingSystem.isUNIXBased(getOperatingSystem()); } /** * Indicates whether the underlying operating system is a Windows variant. * * @return {@code true} if the underlying operating system is a Windows * variant, or {@code false} if not. */ public static boolean isWindows() { return OperatingSystem.WINDOWS == getOperatingSystem(); } /** * Commodity method to help identifying the OS we are running on. * @return the OperatingSystem we are running on. */ private static OperatingSystem getOperatingSystem() { return OperatingSystem.forName(System.getProperty("os.name")); } /** * Write a set-java-home file appropriate for the underlying platform that may * be used to set the JAVA_HOME environment variable in a form suitable for * the underlying operating system. If a JAVA_HOME environment variable is * currently set, then its value will be used. Otherwise, it will be * dynamically determined from the JVM properties. *

* Note that if the target file that would be written already exists, then * this method will exit without doing anything and leaving the existing file * intact. * * * @param serverRoot The path to the root of the Directory Server instance * for which the file will be written. * * @return A handle to the {@code File} object that has been written. * * @throws IOException If a problem occurs while creating or writing to the * specified file. */ public static File writeSetJavaHome(String serverRoot) throws IOException { String javaHome = System.getenv("JAVA_HOME"); if ((javaHome == null) || (javaHome.length() == 0)) { javaHome = System.getProperty("java.home"); } File binDirectory = new File(serverRoot, "bin"); File setJavaHomeFile; if (isWindows()) { setJavaHomeFile = new File(binDirectory, "set-java-home.bat"); if (setJavaHomeFile.exists()) { return setJavaHomeFile; } BufferedWriter writer = new BufferedWriter(new FileWriter(setJavaHomeFile)); writer.write("set JAVA_HOME=" + javaHome); writer.newLine(); writer.close(); } else { setJavaHomeFile = new File(binDirectory, "set-java-home"); if (setJavaHomeFile.exists()) { return setJavaHomeFile; } BufferedWriter writer = new BufferedWriter(new FileWriter(setJavaHomeFile)); writer.write("#!/bin/sh"); writer.newLine(); writer.newLine(); writer.write("JAVA_HOME=" + javaHome); writer.newLine(); writer.write("export JAVA_HOME"); writer.newLine(); writer.close(); } return setJavaHomeFile; } /** * Returns {@code true} if the provided port is free and we can use it, * {@code false} otherwise. * @param port the port we are analyzing. * @return {@code true} if the provided port is free and we can use it, * {@code false} otherwise. */ public static boolean canUseAsPort(int port) { boolean canUseAsPort = false; ServerSocket serverSocket = null; try { InetSocketAddress socketAddress = new InetSocketAddress(port); serverSocket = new ServerSocket(); if (!isWindows()) { serverSocket.setReuseAddress(true); } serverSocket.bind(socketAddress); canUseAsPort = true; serverSocket.close(); /* Try to create a socket because sometimes even if we can create a server * socket there is already someone listening to the port (is the case * of products as Sun DS 6.0). */ try { new Socket("localhost", port); canUseAsPort = false; } catch (IOException ioe) { } } catch (IOException ex) { canUseAsPort = false; } finally { try { if (serverSocket != null) { serverSocket.close(); } } catch (Exception ex) { } } return canUseAsPort; } /** * Returns {@code true} if the provided port is a priviledged port, * {@code false} otherwise. * @param port the port we are analyzing. * @return {@code true} if the provided port is a priviledged port, * {@code false} otherwise. */ public static boolean isPriviledgedPort(int port) { return (port <= 1024) && !isWindows(); } /** * Returns the default value for the JMX Port. * @return the default value for the JMX Port. */ public static int getDefaultJMXPort() { return 1689; } }