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:
Review the task map in Table 1–1. Complete any necessary tasks prior to installing the Master Server.
Insert the N1 Service Provisioning System 4.1: IBM AIX, Redhat Linux, Windows 2000 Server/Advanced Server CD.
Use the Windows File Manager or a DOS window to access the windows directory on the CD.
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 |
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.
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.
Restart the machine to complete the installation.
You must restart the machine to complete the installation of the N1 Service Provisioning System 4.1.
Log in to the system.
After you log in, the installation program displays a Welcome screen.
Click Next to complete the installation.
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.
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.
(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.
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.
To create a new task, right click in the folder and select New -> Scheduled Task.
Name the task.
Double click on the task to edit it.
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.
In the Schedule tab, configure the task to run once a day.
Review the task map in Table 1–1. Complete any necessary tasks prior to installing the Master Server.
Insert the N1 Service Provisioning System 4.1: IBM AIX, Redhat Linux, Windows 2000 Server/Advanced Server CD.
Use the Windows File Manager or a DOS window to access the windows directory on the CD.
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
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.
Click Install to begin the installation.
The installation program installs the program files.
Click Finish to exit the installation program.
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.
On the machine where you want to install the Remote Agent, open a DOS window.
Insert the N1 Service Provisioning System 4.1: IBM AIX, Redhat Linux, Windows 2000 Server/Advanced Server CD.
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.
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.
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.
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 |
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:
Attaches to the Remote Systems WMI DCOM interface
Uses WMI to create a temporary Sindows file share on the target system
Copies cr_ra_win32_4.1.msi from the local location to the target share
Uses WMI remotely to run the silent MSI on the target machine
On the Master Server machine, open a DOS window.
Insert the N1 Service Provisioning System 4.1: IBM AIX, Redhat Linux, Windows 2000 Server/Advanced Server CD.
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.
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.
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.
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 |
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. |
1 |
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 |
1 specifies to start automatically. 0 specifies to not start automatically. |