Chapter 5 Installing the N1 Service Provisioning System 5.1 on Windows Systems

This chapter describes the steps to install the N1 Service Provisioning System 5.1 on servers running Windows. You will install each of the applications separately by using the appropriate Microsoft Installer (MSI) package on the product media. The MSI packages for each of the N1 Service Provisioning System 5.1 applications begin by performing the same set of preparatory tasks and asking the same questions about directories and files. Each MSI package then asks specific configuration questions about the application that it will install.

This chapter discusses the following topics:

• Installing the Master Server

• Installing the Remote Agent, Local Distributor, and CLI Client

• Non-Interactive Installation of a Remote Agent on Windows

• Remote Installation of Remote Agents on Windows

• Remote Agent Variable Values

• Starting Applications on Windows Systems

Installing the Master Server

How to Install the N1 Service Provisioning System 5.1 Master Server on Windows

Before You Begin

Review the installation process overview in Installing the N1 Service Provisioning System 5.1 – Process Overview. Complete any necessary tasks prior to installing the Master Server.

If you want to install the Master Server remotely, use the Virtual Network Computing (VNC) software to access the server. If you use Terminal Client Services to access the server, the installation fails.

Ensure that you have write permissions on the folder in which the MSI packages are saved.

Steps

1. Access the MSI packages.

   • If you are installing from a CD, insert the Sun N1 Service Provisioning System 5.1: Windows CD.

   • If you are installing from the image that you downloaded, change to the directory where you saved the downloaded image.

2. Use the Windows File Manager or a Command Prompt to access the windows directory on the CD or in the directory where you saved the downloaded image.

3. Start the Master Server installation.

   • If you are using the File Manager, double-click the cr_ms_win32_5.1.msi file.

   • If you are at a Command Prompt, type the name of the installation file at the prompt.

     E:\N1GSPS5.1\windows> cr_ms_win32_5.1.msi [ALLOWFORWARDVERSION=true]

     The ALLOWFORWARDVERSION=true option enables you to install an N1 Service Provisioning System 5.1 Master Server on a version of an operating system that is numerically higher than the highest version the N1 Service Provisioning System 5.1 supports for that operating system. If you use the ALLOWFORWARDVERSION=true option, the installation program does not verify that the operating system on which you are installing the Master Server is supported. There is no standard Sun Services support for use of the N1 Service Provisioning System 5.1 on unsupported operating systems.

     ---

     Caution –

     Installing the N1 Service Provisioning System 5.1 on unsupported operating systems might result in undefined and unexpected behavior. Install the N1 Service Provisioning System 5.1 on unsupported operating systems only for testing purposes. Do not use the N1 Service Provisioning System 5.1 on unsupported operating systems in a production environment.

     ---

4. Answer the configuration questions when prompted by the installation program.

   The installation program prompts you to answer a series of configuration questions and then displays the Ready to Install screen.

5. Click Install to begin the installation.

   The installation program installs the program files. When the installation completes, the installation program prompts you to restart the machine.

6. Restart the machine to complete the installation.

   You must restart the machine to complete the installation of the N1 Service Provisioning System 5.1.

7. Log in to the server.

   After you log in, the installation program displays a Welcome screen.

8. Click Next to complete the installation.

   ---

   Note –

   The installer opens Command Prompt windows and executes commands. Some of the commands might take several minutes to run. Do not close the Command Prompt windows or cancel the operations. The operations complete automatically after a few minutes.

   ---

9. Click Finish to exit the installation program.

   The Master Server is installed. Access the Master Server by using your web browser and the browser interface address that you specified during the installation.

10. (Optional) Create a scheduled task to optimize the database.

    To optimize the performance of your database, create a scheduled task that runs the vacuumdb utility daily. To create the scheduled task, follow the instructions in How to Create a Scheduled Task to Optimize the Database.

How to Create a Scheduled Task to Optimize the Database

Steps

1. Open the Windows Scheduled Tasks Folder.

   You can open the Scheduled tasks folder by clicking the Start menu, then clicking Programs -> Accessories -> System Tools -> Scheduled Tasks.

2. To create a new task, right click in the folder and select New -> Scheduled Task.

3. Name the task.

4. Double–click on the task to edit it.

5. In the Run field, type the following command on a single line:

   bash -c “/cygdrive/c/Program\ Files/N1\ Service\ Provisioning\ System/5.1/server/bin/roxdbcmd vacuumdb -h localhost -a -z”

   c/Program\ Files/N1\ Service\ Provisioning\ System/5.1 is the directory in which you installed the Master Server.

6. In the Schedule tab, configure the task to run once a day.

Installing the Remote Agent, Local Distributor, and CLI Client

How to Install the Remote Agent, Local Distributor, and CLI Client on Windows

Before You Begin

Review the installation process overview in Installing the N1 Service Provisioning System 5.1 – Process Overview. Complete any necessary tasks prior to installing the Master Server.

Ensure that you have write permissions on the folder in which the MSI packages are saved.

Steps

1. Access the installation MSI packages.

   • If you are installing from a CD, insert the Sun N1 Service Provisioning System 5.1: Windows CD.

   • If you are installing from the image that you downloaded, change to the directory where you saved the downloaded image.

2. Use the Windows File Manager or a Command Prompt to access the windows directory on the CD or in the directory where you saved the downloaded image.

3. Start the installation for the application you want to install.

   • If you are using the File Manager, double-click the cr_app_win32_5.1.msi file.

   • If you are in a Command Prompt, type the name of the installation file at the prompt.

     E:\N1GSPS5.1\windows> cr_app_win32_5.1.msi [ALLOWFORWARDVERSION=true]

     app is one of the following values:

     • ra – installs the Remote Agent

     • ld – installs the Local Distributor

     • cli – installs the CLI Client

     The ALLOWFORWARDVERSION=true option enables you to install an N1 Service Provisioning System 5.1 application on a version of an operating system that is numerically higher than the highest version the N1 Service Provisioning System 5.1 supports for that operating system. If you use the ALLOWFORWARDVERSION=true option, the installation program does not verify that the operating system on which you are installing the application is supported. There is no standard Sun Services support for use of the N1 Service Provisioning System 5.1 on unsupported operating systems.

     ---

     Caution –

     Installing the N1 Service Provisioning System 5.1 on unsupported operating systems might result in undefined and unexpected behavior. Install the N1 Service Provisioning System 5.1 on unsupported operating systems only for testing purposes. Do not use the N1 Service Provisioning System 5.1 on unsupported operating systems in a production environment.

     ---

4. Answer the configuration questions when prompted by the installation program.

   The installation program prompts you to answer a series of configuration questions and then displays the Ready to Install screen.

5. Click Install to begin the installation.

   The installation program installs the program files.

6. Click Finish to exit the installation program.

Non-Interactive Installation of a Remote Agent on Windows

You can install the Remote Agent by using variables on a command line to indicate your configuration selections. The non-interactive installation for Remote Agents is accomplished by using the msiexec command that is installed as part of the Windows Installer Service.

How to Non-Interactively Install Remote Agents on Windows

Before You Begin

Ensure that you have write permissions on the folder in which the MSI packages are saved.

Steps

1. On the machine where you want to install the Remote Agent, open a Command Prompt window.

2. Insert the Sun N1 Service Provisioning System 5.1: Windows CD.

3. Change to the directory where the MSI package is located, either on the software CD or from the directory where you saved the downloaded image.

4. Copy the installation MSI package to the machine on which you want to install the Remote Agent.

   % copy cr_ra_win32_5.1.msi RA-machine\

   RA-machine is a directory on the machine on which you want to install the Remote Agent.

5. Start the installation.

   C:RA-machine\> msiexec /i cr_ra_win32_5.1.msi /qn RA_PARENT_CONNECTION=value CR_RA_CTYPE_CONFIRM=value VARIABLE=value[ALLOWFORWARDVERSION=true]

   You may include as many variables as necessary. Variable values that contain spaces, such as directory names, must be included in quotation marks. For the variables and values accepted by the non-interactive installation program, refer to Table 5–1. For variables for which you do not specify a value, the installation program installs the Remote Agent using the default value.

   ---

   Caution –

   You must set a value for the RA_PARENT_CONNECTION variable or the installation script will abort. Also, if you choose to use an insecure connection type, such as raw or SSL encryption with no authentication, you must set the CR_RA_CTYPE_CONFIRM variable value to true.

   ---

   The ALLOWFORWARDVERSION=true option enables you to install an N1 Service Provisioning System 5.1 Remote Agent on a version of an operating system that is numerically higher than the highest version the N1 Service Provisioning System 5.1 supports for that operating system. If you use the ALLOWFORWARDVERSION=true option, the installation program does not verify that the operating system on which you are installing the Remote Agent is supported. There is no standard Sun Services support for use of the N1 Service Provisioning System 5.1 on unsupported operating systems.

   ---

   Caution –

   Installing the N1 Service Provisioning System 5.1 on unsupported operating systems might result in undefined and unexpected behavior. Install the N1 Service Provisioning System 5.1 on unsupported operating systems only for testing purposes. Do not use the N1 Service Provisioning System 5.1 on unsupported operating systems in a production environment.

   ---

Example 5–1 Non-Interactive Installation of a Remote Agent on Windows

The following example is a sample of the command to install the Remote Agent non-interactively on Windows.

C:\> msiexec /i cr_ra_win32_5.1.msi /qn
INSTALLDIR=“C:\Program Files\N1 Service Provisioning System\”
RA_PARENT_CONNECTION=false CR_RA_CTYPE_CONFIRM=true

Remote Installation of Remote Agents on Windows

The Remote Agent MSI package facilitates remote installation in a non-interacitve mode. The installation is accomplished by using a .wsh script used by the Windows Scripting Host. The script file contains VB script code that does the following:

• Attaches to the Remote Systems WMI DCOM interface

• Uses WMI to create a temporary Windows file share on the target server

• Copies cr_ra_win32_5.1.msi from the local location to the target share

• Uses WMI remotely to run the silent MSI on the target machine

How to Remotely Install Remote Agents on Windows

Before You Begin

Ensure that you have write permissions on the folder in which the MSI packages are saved.

Steps

1. On the Master Server machine, open a Command Prompt window.

2. Access the MSI packages.

   • If you are installing from a CD, insert the Sun N1 Service Provisioning System 5.1: Windows CD.

   • If you are installing from the image that you downloaded, change to the directory where you saved the downloaded image.

3. Change to the directory where the MSI package is located, either on the software CD or from the directory where you saved the downloaded image.

4. Copy the MSI package to the Master Server.

   C:\> copy cr_ra_win32_5.1.msi MS-machine\

   MS-machine is a directory on the Master Server machine.

5. Change to the Master Server home directory.

   C:\> cd N1SPS5.1-home\server\bin\WinInstaller

   N1SPS5.1-home is the directory in which you installed the Master Server.

6. Start the installation.

   C:\MS-machine> cscript WinInstaller.wsf [ALLOWFORWARDVERSION=true] parameters Hostname

   The ALLOWFORWARDVERSION=true option enables you to install an N1 Service Provisioning System 5.1 Remote Agent on a version of an operating system that is numerically higher than the highest version the N1 Service Provisioning System 5.1 supports for that operating system. If you use the ALLOWFORWARDVERSION=true option, the installation program does not verify that the operating system on which you are installing the Remote Agent is supported. There is no standard Sun Services support for use of the N1 Service Provisioning System 5.1 on unsupported operating systems.

   ---

   Caution –

   Installing the N1 Service Provisioning System 5.1 on unsupported operating systems might result in undefined and unexpected behavior. Install the N1 Service Provisioning System 5.1 on unsupported operating systems only for testing purposes. Do not use the N1 Service Provisioning System 5.1 on unsupported operating systems in a production environment.

   ---

   Hostname is the hostname of the machine on which to install the Remote Agent.

   If you do not include values for any of the following parameters on the command line, the installation program installs the Remote Agent using the default values as shown below.

   The Remote Agent non-interactive installation program accepts the parameters that are listed in the following table.

   Parameter	Description	Default
   -user	User to connect to WMI on the target machine.	None
   -password	Password to connect to the WMI on the target machine.	None
   variables	The Windows variable for the cscript WinInstaller.wsf command found in Table 5–1. All variables and values must be contained in a string that is enclosed by quotation marks. Caution – You must set a value for the RA_PARENT_CONNECTIONvariable or the installation script will abort. Also, if you choose to use an insecure connection type, such as raw or SSL encryption with no authentication, you must set the CR_RA_CTYPE_CONFIRM variable value to true.	None
   -msiLocation	Paths to the .msi\.input files to install.	Current working directory
   -shareLocation	An existing directory on the target machine in which to create a temporary Windows file share. The file share directory must be at least the size of the MSI package.	C:\WINNT\Temp

   The exit code is 0 for a successful installation and 1 for a failure.

Example 5–2 Remote Installation of a Remote Agent On Windows

The following example is a sample of the command to remotely install a Remote Agent on Windows.

C:\> cscript WinInstaller.wsf -shareLocation C:\installs -options
"RA_PARENT_CONNECTION=false CR_RA_CTYPE_CONFIRM=true" targetHost

Remote Agent Variable Values

The Remote Agent non-interactive and remote installation programs accepts the following variables.

Starting Applications on Windows Systems

On Windows servers, you start the Master Server, Local Distributor, and Remote agent in the Services Panel. You start the CLI Client from a Command Prompt window.

To start the Master Server, Local Distributor, or Remote Agent, click the Start menu, then Programs -> Administrative Tools -> Services. In the Services panel, find the name of the application and start it.

To start the CLI Client on a Windows server, type one of the following commands at a Command Prompt. N1SPS5.1-home is the home directory of the application.