Installing the SDX-300 Software > Installing the SDX Software by Using the Installation Program

Installing the SDX Software by Using the Installation Program

You can install the SDX software from the SDX installation program in two modes:

• Silent Mode
• Graphical Mode

We use the graphical mode to illustrate the installation procedures.

Silent Mode

The silent mode does not display the installation GUI. Instead, the system prompts you for input in a UNIX window as the various components of the SDX software are installed. Provide input as requested by the program to proceed with the installation.

To start the installation process in silent mode, enter the following command at the UNIX command line:

./UMCsdx.bin -D[argument]="[value]" -i silent

Table 13 shows the possible inputs to this command.

 Table 13:  Command Options for UMCsdx.bin 

 [argument]
 default [value]
 Notes

 ADMIN_FILE

 pkgadd.SSC.default

 SDX Admin file


 INSTALLER_DATA_DIR

 /opt/UMC/var/InstallerData

 Installation data directory


 USER_INSTALL_DIR

 /opt/UMC

 Installation destination directory


 USER_INPUT_RESULT_1

 sdxuser

 User with nonroot privileges who can install the SDX software. See Logging the Installation Session.


 USER_INPUT-RESULT_2

 staff

 Group for users with nonroot privileges who can install the SDX software. See Logging the Installation Session.


 MEDIAFOLDER

 cdrom/cdrom0/SDX

 Installation source directory



 

If you want nonroot users to configure and administer the SDX software after it is installed, you can define users with nonroot privileges with the USER_INPUT_RESULT_1 and USER_INPUT_RESULT_2 arguments to the command. For example:

./UMCsdx.bin -DUSER_INPUT_RESULT_1="sdxuser" 
-DUSER_INSTALL_DIR="/opt/UMC" -DMEDIA_FOLDER="/cdrom/cdrom0" -i 
silent

Graphical Mode

The graphical mode lets you use the GUI for the installation program (Figure 28) to select which SDX components you want to install and where you want to install them. Buttons at the bottom of the window let you cancel the installation, move to a previous step, and move to the next step. You can move, minimize, or close the window for the installation program.

Figure 28: Installation Program GUI

To use the installation program:

1. On the UNIX host where you will install the SDX software, log in as root.
2. Ensure that the display variable is set.

echo $DISPLAY

3. (Optional) Create nonroot users and groups using the UNIX admintool utility to enable nonroot users and groups to administer the SDX software. See Logging the Installation Session.
4. Load SDX software disk 1, and start the SDX installation program.

/cdrom/cdrom0/UMCsdx.bin

5. Follow the instructions in the various windows.

See the following sections for more information about the windows in the installation program.

6. In the Install Complete window, click Done when the installation program indicates that the installation is complete.

Choose SDX Software Distribution Folder

In the Choose Software Distribution Folder window, the program displays the location of the software to be installed. You can change the location if needed.

Choose SDX Installation Folder

In the Choose SDX Install Folder window, the program displays the default installation directory, /opt/UMC. Although you can specify a different installation directory, you cannot change the location where SDX components are installed within that directory.

NOTE: All examples in this book presume that you have accepted the default directory.

 NOTE: The SDX software does not support the use of spaces in filenames or directories. If you create files or directories inside the installation directory structure, you must do the following:

  
 Ensure that the names do not include spaces.
  
 Manage the files and directories outside the context of SDX software.

 If a filename or directory name includes a space, the removal of various SDX packages will fail.



 

License Agreement

In the License Agreement window, you read then accept the software license for the SDX software. You must accept the license agreement to proceed with the installation.

Get Admin Option

In the Get Admin Option window, you select the admin file from which the SDX installation program obtains installation parameters. An admin file assigns values to various installation parameters to define default installation actions. See the UNIX man page for admin(4). You can select one of the following:

• SDX Admin file—Uses SDX installation parameters.
• Solaris Admin file—Uses Solaris default installation parameters from the Solaris default admin file. This file is located in /var/sadm/install/admin/default.

The selected admin option is used to install all the packages. You cannot change admin options for an individual package. The admin selection affects only the current SDX GUI installation instance; if you start the installation program again, the program does have access to any value previously set for the admin option and therefore does not use any previous settings.

Choose Product Features

In the Choose Product Features window, you select sets of SDX components to install. You select an installation set that includes one or more feature sets, in part or whole. A feature set includes one or more components. Figure 29 shows how installation sets, feature sets, and components appear in the Choose Product Features window.

Figure 29: Choose Product Features Window

For each installation set, various recommended or required components are selected by default for installation. Click on a package or component to display a brief description.

NOTE: If you install SDX software over an existing installation, the installation program displays a message stating that the existing software will be overwritten.

Table 14 lists components for each available feature set, their Solaris package names, and the directories in which each component is installed. In Table 14, the directories listed are all installed in /opt/UMC, except for the following:

• IP Filter—Installed in the /opt/ipf folder
• DirX—Installed in the <DirX_HOME>folder.

 Table 14:  Solaris Packages and Installation Directories for All Installation Components 

 Feature Set
 Components
 Package
 Installation Directory

 Env


  
 Java Runtime Environment
  
 Python Runtime Environment (includes Python additional libraries)



  
 UMCjre
  
 SMCpython and UMCpyadd



  
 jre
  
 python



 License Server


  
 License Server



  
 UMClicsvr



  
 licsvr



 Application and Web Server


  
 JBoss



  
 UMCjboss



  
 jboss



 SAE System


  
 SAE 
  
 System Management Agent



  
 UMCsae
  
 UMCagent



  
 sae
  
 agent



 Juniper Policy Server 


  
 Juniper Policy Server



  
 UMCjps



  
 jps



 Captive Portal System


  
 IP Filter (Solaris 8 or 9)
  
 Web Redirect



  
 ipfx, ipf
  
 UMCredir



  
 ipf
  
 redir



 Configuration Editor


  
 Configuration Editor



  
 UMCecl



  
 sysconf



 NIC System


  
 NIC System



  
 UMCnic



  
 nic



 Redundancy Monitor System


  
 Redundancy Monitor System



  
 UMCredmon



  
 redmon



 Admin Workstation


  
 Policy Editor
  
 SDX Admin
  
 omniORB



  
 UMCpom
  
 UMCsmg
  
 omniORB



  
 pom
  
 smg
  
 omni



 Directory Server


  
 OpenLDAP
  
 OpenLDAP Add-On
  
 DirX Add-On
  
 eTrust Directory
  
 Sun ONE Directory Server Add-On
  
 Oracle Internet Directory Add-On
  
 Migration



  
 UMColdap
  
 UMColdapa
  
 UMCdirxa
  
 UMCedsa
  
 UMCiDSa
  
 UMCoida
  
 UMCmig



  
 openldap
  
 openldap
  
 $DIRX_HOME$
  
 conf
  
 conf
  
 conf
  
 migration



 Merit RADIUS


  
 Merit RADIUS



  
 UMCradius



  
 radius



 Data Integration Suite


  
 Data Integration Suite



  
 UMCdatint



  
 datint




 

Table 15 lists the components and feature sets that are included by default for each installation set. In general, an installation set corresponds to a group of software components that provide specific functionality. For example, if you want a particular host to act as an SAE and as a directory server, you could install the SAE and Directory Server installation set on that host.

 NOTE: For a specified installation set, you can select additional components or deselect components. Be careful if you do this; deselecting required components can have undesired results.



 

 Table 15:  Default Installation Set Components 

 Installation Set
 Feature Sets and Components

 SDX Demo


  
 Env

  

    
 Java Runtime Environment
    
 Python Runtime Environment
  


 


  
 Application and Web Server

  

    
 JBoss
  


 


  
 SAE System

  

    
 SAE 
    
 System Management Agent
  


 


  
 Juniper Policy Server



 


  
 Captive Portal System

  

    
 IP Filter (Solaris 8 or 9); the installation program detects the Solaris version on the host and installs the appropriate IP Filter for that OS.
    
 Web Redirect
  


 


  
 Configuration Editor



 


  
 Admin Workstation

  

    
 Policy Editor
    
 SDX Admin
    
 omniORB
  


 


  
 Directory Server

  

    
 OpenLDAP
    
 OpenLDAP Add-On
  


 


  
 Merit RADIUS



 SDX License Server


  
 Env

  

    
 Java Runtime Environment
    
 Python Runtime Environment
  


 


  
 License Server



 SAE and Directory Server


  
 Env

  

    
 Java Runtime Environment
    
 Python Runtime Environment
  


 


  
 SAE System

  

    
 SAE
    
 System Management Agent
  


 


  
 Directory Server

  

    
 OpenLDAP
    
 OpenLDAP Add-On
  


 SAE Server


  
 Env

  

    
 Java Runtime Environment
    
 Python Runtime Environment
  


 


  
 SAE System

  

    
 SAE
    
 System Management Agent
  


 Policy Server


  
 Juniper Policy Server



 Application and Web Server


  
 Env

  

    
 Java Runtime Environment
  

  
 Application and Web Server

  

    
 JBoss
  


 NIC Server


  
 Env

  

    
 Java Runtime Environment
    
 Python Runtime Environment
  


 


  
 NIC System



 Redundancy Monitor Server


  
 Env

  

    
 Java Runtime Environment
    
 Python Runtime Environment
  


 


  
 Redundancy Monitor System



 System Configuration Editor


  
 Configuration Editor



 Captive Portal


  
 Env

  

    
 Java Runtime Environment
    
 Python Runtime Environment
  


 


  
 Captive Portal System

  

    
 IP Filter (Solaris 8 or 9); the installation program detects the Solaris version on the host and installs the appropriate IP Filter for that OS.
    
 Web Redirect
    
 omniORB
  


 Administrator WorkStation


  
 Env

  

    
 Java Runtime Environment
    
 Python Runtime Environment
  


 


  
 Admin Workstation

  

    
 Policy Editor
    
 SDX Admin
    
 omniORB
  


 Directory Server


  
 Directory Server

  

    
 OpenLDAP
    
 OpenLDAP Add-On
  


 RADIUS Server


  
 Merit RADIUS



 Integration Tools


  
 Env

  

    
 Java Runtime Environment
  

  
 Data Integration Tool



 Custom


  
 Env

  

    
 Java Runtime Environment
    
 Python Runtime Environment
  


 


  
 Application and Web Server

  

    
 JBoss
  


 


  
 SAE System

  

    
 SAE
    
 System Management Agent
  


 


  
 Juniper Policy Server



 


  
 Configuration Editor



 


  
 Admin Workstation

  

    
 Policy Editor
    
 SDX Admin
    
 omniORB
  


 


  
 Directory Server

  

    
 OpenLDAP
    
 OpenLDAP Add-On
  


 


  
 Merit RADIUS




 

Get User Input

In the Get User Input window, you can specify nonroot users or groups. The users or groups must already exist (created with the UNIX admintool), or the installation program returns an error.

NOTE: Some SDX processes, such as the SAE and the LDAP directory server, use many open files and sockets. You may need to customize the hard and soft limits for the system resources that are used by such SDX processes. Examine your system configuration information and UNIX account holder configuration that runs the SDX processes. See your Solaris system administration documentation for more information about determining the limits of your system configuration and UNIX account holder configuration. The UNIX man pages for the limit(1) command and the sysdef(1M) command also provide useful information. For example, if you are installing the SDX software in a nonroot environment in a typical Solaris 8 or Solaris 9 installation, the maximum number of file descriptors is too low for nonroot users. The hard limit is 1024, and the soft limit for nonroot users is 256. You can use the UNIX ulimit command to increase the number.

Preinstallation Summary

The Preinstallation Summary window lists the feature sets and components in those feature sets to be installed. It also shows the folder into which the components will be installed. Review the list, and if correct click Install. The installation program installs the components listed.

Installing SDX

The Installing SDX window shows the progress of the installation for the components selected. The installation program opens a UNIX window as it uses the pkgadd command to install each component. Messages in the UNIX window request confirmation or other input for installation of a package.

Install Complete

After the installation program finishes installing SDX software components, the Install Complete window displays a message that indicates whether the installation was completed successfully.