N1 Service Provisioning System 4.1 Installation Guide

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

This chapter describes the steps to install the N1 Service Provisioning System 4.1 on systems running Windows. You will install each of the applications separately by using the appropriate installation script on the product media. The installation scripts for each of the N1 Service Provisioning System 4.1 applications begin by performing the same set of preparatory tasks and asking the same questions about directories and files. Each script then asks specific configuration questions about the application that it will install.

This chapter discusses the following topics:

Installing the Master Server

ProcedureHow to Install the N1 Service Provisioning System 4.1 Master Server on Windows

Before You Begin

Review the task map in Table 1–1. Complete any necessary tasks prior to installing the Master Server.

Steps
  1. Insert the N1 Service Provisioning System 4.1: IBM AIX, Redhat Linux, Windows 2000 Server/Advanced Server CD.

  2. Use the Windows File Manager or a DOS window to access the windows directory on the CD.

  3. Start the installation script for the Master Server.

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

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


      E:\N1SPS4.1_2\windows> cr_ms_win32_4.1.msi
      
  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 it 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 4.1.

  7. Log in to the system.

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

  8. Click Next to complete the installation.


    Note –

    The installer opens DOS windows and executes commands. Some of the commands might take several minutes to run. Do not close the DOS 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 Web interface address 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.

ProcedureHow to Create a Scheduled Task to Optimize the Database

Steps
  1. Open the Windows 2000 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/4.1/server/bin/roxdbcmd 
    vacuumdb -h localhost -a -z”
    

    c/Program\ Files/N1\ Service\ Provisioning\ System/4.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

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

Before You Begin

Review the task map in Table 1–1. Complete any necessary tasks prior to installing the Master Server.

Steps
  1. Insert the N1 Service Provisioning System 4.1: IBM AIX, Redhat Linux, Windows 2000 Server/Advanced Server CD.

  2. Use the Windows File Manager or a DOS window to access the windows directory on the CD.

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

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

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


      E:\N1SPS4.1_2\windows> cr_app_win32_4.1.msi
      

    app is one of the following values:

    • ra – installs the Remote Agent

    • ld – installs the Local Distributor

    • cli – installs the CLI Client

  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 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.

ProcedureHow to Non-Interactively Install Remote Agents on Windows

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

  2. Insert the N1 Service Provisioning System 4.1: IBM AIX, Redhat Linux, Windows 2000 Server/Advanced Server CD.

  3. Change to the directory on the software CD where the Windows installation script is located.


    C:\> cd path-to-CD/windows
    

    path-to-CD is the path to the software CD.

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


    % cp cr_ra_win32_4.1.sh 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_4.1.msi /qn
    VARIABLE=value VARIABLE=value
    

    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. If you do not include any variables or values, the installation program installs the Remote Agent using the default values.


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_4.1.msi/ qn 
INSTALLDIR=“C:\Program Files\N1 Service Provisioning System\”R
A_PARENT_CONNECTION=false

Remote Installation of Remote Agents on Windows

The Remote Agent installation script 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:

ProcedureHow to Remotely Install Remote Agents on Windows

Steps
  1. On the Master Server machine, open a DOS window.

  2. Insert the N1 Service Provisioning System 4.1: IBM AIX, Redhat Linux, Windows 2000 Server/Advanced Server CD.

  3. Change to the directory on the software CD where the Windows installation script is located.


    C:\> cd path-to-CD/windows
    

    path-to-CD is the path to the software CD.

  4. Copy the installation script to the Master Server.


    % cp cr_ra_win32_4.1.sh MS-machine/
    

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

  5. Start the installation.


    C:\MS-machine> cscript WinInstaller.wsf 
    parameters Hostname
    

    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 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.

    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 installation script. 

    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 
"INSTALLDIR='C:\Program Files\N1 Service Provisioning System'" targetHost

Remote Agent Variable Values

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

Table 5–1 Remote Agent Variable Values

Variable Name 

Description 

Default 

Values 

INSTALLDIR

Specify the directory in which to install the Remote Agent. 

C:\Program Files\N1 Service Provisioning System

Any valid directory. 

REMOTE_AGENT_HOSTNAME

Specify the hostname or IP address for the machine on which to install the Remote Agent. 

The Windows computer name 

Any valid hostname or IP address. 

RA_PORT_NUMBER

Specify the IP Port number to use for this Remote Agent. 

2313 

Any valid port number. 

RA_PARENT_CONNECTION

Specify that the parent application connect to this Remote Agent using unencrypted (raw) or SSL connections. 

false

true specifies to use SSL. false specifies to use raw.

RA_SSL_CIPHER

If you selected SSL, specify the type of SSL cipher suite to use. 

0 specifies to use encryption with authentication. 1 specifies to use encryption without authentication.

RA_SERVICE_USERNAME

RA_SERVICE_PASSWORD

Specify which user account the Remote Agent is to run as. 

system user 

Use a prefix of .\ for local user names.

If you define these variables, you must set RA_SERVICE_CONTROL to other.

RA_SERVICE_AUTOSTART

Specify whether to start the Remote Agent automatically on system restart. The variable also determines whether the Remote Agent is started at the time of the installation. 

 

1 specifies to start automatically. 0 specifies to not start automatically.