Installation Guide October 2006
eHealth® Installation Administration Tasks Reference (UNIX) This guide describes administrative tasks that relate to installing and upgrading eHealth® on Solaris and HP-UX systems. TASKS BEFORE
YOU INSTALL OR UPGRADE
eHEALTH:
•
Add swap space (virtual memory paging file).
•
Check and modify kernel requirements.
•
Mount the CD drive.
•
Unmount the CD drive.
•
Copy the CDs to a disk.
TASKS AFTER •
YOU INSTALL OR UPGRADE
eHEALTH:
Change the web server port number. Note: Before installing the eHealth software, you must create an eHealth administrator account. To create a user group and the eHealth administrator account on your system, see your system administrator. For general guidelines, see the New Installations of eHealth 6.0 (UNIX) guide.
Add Swap Space Swap Space Swap space (or virtual memory storage file) is temporary storage used when a system’s memory requirements exceed the size of available RAM. Systems swap processes and data files between the swap space and the physical memory as needed. The amount of swap space a system has is dependent upon the system configuration. Use the eHealth sizing wizard to determine your system requirements. If your system has less than the recommended amount of available swap space, you must add more swap space by locating additional unused disk space. The sum of your current swap space and the unused disk space must equal the swap space requirements for your configuration. For more information, see the Using the eHealth Sizing Wizard guide. Note: Several of these procedures require root privileges. If you do not know the password for root, ask your UNIX® system administrator for assistance. To add swap space to a Solaris system 1.
Log on to the eHealth system as root and enter the following command to locate disks with unused space: df -k
A list of disks appears. 2.
Enter the following command: mkfile size [k|m|b] swapFilePath/swapFileName
eHealth® Installation Administration Tasks Reference (UNIX)
where size is the number of bytes to be allocated, but it can be flagged as KB, MB, or blocks, with the k, m, or b suffixes, respectively. swapFilePath/swapFileName is the full path and file name for the additional swap file. 3.
Edit the /etc/vfstab file to add the following line: swapFilePath/swapFileName - - swap - no -
4.
Enter the following command to enable the new swap file: swap -a swapFilePath/swapFileName
The swap file is now in use. 5.
Enter the following command to confirm the swap space settings: swap -l
Swap space is added. For details on allocating additional swap space, see the administration manual provided with your Solaris system. To add swap space to an HP-UX system
Use the SAM tool to add swap space to an HP-UX system. For complete instructions, see the administration manual provided with your system. 1.
Log on to the eHealth system as root and start the SAM tool by entering the following command: /usr/sbin/sam
2.
Select Disks and File Systems, Swap, Actions, Add File System Swap. A list of file systems appears.
3.
Select the file system to use for swap from the list.
4.
Specify values for Minimum Swap (Mbytes) and Maximum Swap (Mbytes). The value is specified.
5.
Specify the swap priority. Swap priority is set.
6.
Specify the time at which you want to enable swap and click OK. Swap space is added to the system. For details on allocating additional swap space, see the administration manual provided with your HP-UX system.
Check and Modify Kernel Requirements Before you install eHealth Release 6.0, run the prerequisite checker program to determine if your system meets the minimum requirements. The checker verifies that the kernel parameter values on your system are configured for at least the required minimums. If they are not, the checker generates a list of recommended configuration adjustments. For information about running the prerequisite checker, see the New Installations of eHealth 6.0 (UNIX) guide. If your kernel parameters are not set for the required minimums, you need to modify them. This section describes how to modify kernels on Solaris and HP-UX systems. For more information about modifying kernels on your system, see your system documentation.
2
eHealth® Installation Administration Tasks Reference (UNIX)
Modify a Solaris Kernel To simplify the process of setting kernel parameters on Solaris systems, eHealth provides a template file on the eHealth Software CD containing the appropriate kernel settings. By using the template file as described in this section, you reduce the chances of making a simple syntax or formatting error that might cause the installation to fail. To modify your kernel parameters, do one of the following: •
Replace your existing system configuration file with the template etc_system.SunOS file, and edit the file as necessary to define other parameters required for your site. (This method is recommended if you have made few changes to your etc_system.SunOS file.)
•
Copy and paste kernel settings from the template file to your existing etc_system.SunOS file (this may be easier if you have made many changes to your etc_system.SunOS file).
Note: If you are running Solaris 2.10, the recommended way of setting IPC resource control limits is now through projects. Edits made to the etc_system.SunOS file are still valid but force a reboot to enable the parameters. For additional information, see your system documentation or contact your system administrator. 1.
Log in to your system as root.
2.
Mount the eHealth Software CD as described in the section Mount the CD Drive.
3.
Enter the following command to create a backup of your kernel parameter file, where date is today’s date: cp /etc/system /etc/system.orig.date
4.
Do one of the following to make a copy of the template file: •
If you use Solaris with Volume Management, run the following command, including the CD label after /cdrom. For example:
cp /cdrom/cdLabel/etc_system.SunOS /etc/system
•
Otherwise, use the following command: cp /cdrom/etc_system.SunOS /etc/system
5.
Using a text editor, check the /etc/system.orig.date file for any parameters that are not defined in the new etc_system.SunOS file. Copy and paste these parameters into the new etc_system.SunOS file.
6.
Save your changes to the etc_system.SunOS file. IMPORTANT! In the etc_system.SunOS file, spaces before or after commands or empty lines at the end of the
file will cause the script to fail. Remove any spaces or empty lines before saving the file. 7.
Enter the following command to reboot the system and reconfigure the Solaris kernel: shutdown -i6 -g1 -y
To copy and paste kernel settings from the template file 1.
Log in to your system as root.
2.
Mount the eHealth Software CD as described in the section Mount the CD Drive.
3.
Enter the following command to create a backup of your kernel parameter file, where date is today’s date: cp /etc/system /etc/system.orig.date
4.
Do one of the following to append the contents of the template file to the existing system file. •
If you use Solaris with Volume Management, use the following command, including the CD label after /cdrom. For example:
cat /cdrom/cdLabel/etc_system.SunOS >> /etc/system
•
Otherwise, use the following command: cat /cdrom/etc_system.SunOS >> /etc/system
3
eHealth® Installation Administration Tasks Reference (UNIX) 5.
Using a text editor, review the contents of the etc_system.SunOS file. The kernel parameters defined for eHealth appear after the following text: # Added for eHealth
Confirm that these kernel parameters are not defined elsewhere in the file. If a parameter is already defined in the file, insert an asterisk (*) before that line to disable it. 6.
Save your changes to the etc_system.SunOS file. IMPORTANT! In the etc_system.SunOS file, spaces before or after commands or empty lines at the end of the
file will cause the script to fail. Remove any spaces or empty lines before saving the file. 7.
Enter the following command to reboot the system and reconfigure the Solaris kernel: sync; sync; shutdown -i6 -g1 -y
Modify an HP-UX Kernel On HP-UX systems, eHealth requires that you use a 64-bit kernel. This section describes how to verify that you are using a 64-bit kernel and how to modify the HP-UX configuration kernel. To modify HP-UX kernels, use the System Administration Manager (SAM) tool, which is an optional package for HP-UX. Note: Before you modify the configuration, you must load the package containing the SAM tool. If you did not load this package, refer to the system administration manual that was provided with your HP-UX system. To verify that you are using a 64-bit kernel 1.
Log in to the eHealth system as root.
2.
Enter the following command: getconf KERNEL_BITS
•
If the command returns 64, you are using a 64-bit kernel and you should verify the configuration of it.
•
If the command returns a different value, you need to upgrade to a 64-bit kernel. For more information, refer to your HP-UX documentation.
To modify the configuration of an HP-UX kernel 1.
Log on to your system as root.
2.
Start the SAM tool by entering the following command: /usr/sbin/sam
3.
Select Kernel Configuration, Configurable Parameters.
4.
Change the value of a parameter by selecting it from the list and selecting Actions, Modify Configurable Parameter.
5.
Press Enter to apply the changes, and click OK.
6.
Select Actions, Create a New Kernel.
7.
When the system prompts you to reboot the kernel, click Yes.
Mount the CD Drive To ensure that your system can access the CD, mount the CD drive on a directory. After inserting the CD into the drive, use the mount command and specify that directory. You should mount a CD drive on the existing /cdrom directory. If that directory does not exist, you must create it.
4
eHealth® Installation Administration Tasks Reference (UNIX)
Verify That the CD Directory Exists The CD is normally mounted to the /cdrom directory. To verify that the /cdrom directory exists on your system, enter the ls / command. This command lists the files and directories under the root directory. If the /cdrom directory exists on your system, it appears in the list of directories. If the /cdrom directory is not listed, you need to create it. To create the /cdrom directory 1.
Log on to the eHealth system as root.
2.
Enter the following command in a terminal window: mkdir /cdrom
The directory is created.
Verify That the CD Drive is Mounted Before you can install eHealth, you must mount the CD drive on the /cdrom directory. Note: Before you perform this procedure on a Solaris system, turn off Volume Management. To verify that the CD drive Is mounted 1.
Display the list of mounted file systems by entering the following command: /etc/mount
2.
Verify whether the CD drive is mounted on your system by confirming the output that the mount command produces. Use the following commands as guidelines, depending on your system: •
Solaris: /dev/sr0 on /cdrom
•
HP-UX: /cdrom on /dev/dsk/c201d2s0 readonly on date
Note: /dev/sr0 and c201d2s0 are the standard default names for the CD device drivers. If the CD drive is mounted from a remote system, the mount command displays output similar to the following, where server is the name of the remote system: server:/cdrom on /cdrom 3.
Do one of the following: •
If the CD drive is mounted, begin the software installation process described in New Installations of eHealth 6.0 (UNIX)
•
If the CD drive is not mounted, do one of the following: – If the drive is connected to your system, mount it by following the instructions in the section Mount the CD Drive Locally. – If the drive is connected to another system, mount it by following the instructions in the section Mount the CD Drive from a Remote System.
Mount the CD Drive Locally This section describes how to mount the CD drive on HP-UX and Solaris systems. To mount a CD drive that is locally connected to an HP-UX system 1.
Log on to the eHealth system as root and determine the device_file by entering the following command: ioscan -fun -C disk
2.
Identify the line (or pair of lines) of output similar to "CD-532E-B" and note the output similar to the format /dev/dsk/c#t#d#. You will use this device information in the pfs_mount command. (Depending on your system, you may use a command other than pfs_mount.)
5
eHealth® Installation Administration Tasks Reference (UNIX) 3.
Confirm the mount point by entering the following command: ls -ld /cdrom
The mount point is verified. 4.
Create the mount point if it is not found by entering the following command: mkdir /cdrom
The mount point is created. 5.
Start the PFS daemons by entering the following two commands: nohup /usr/sbin/pfs_mountd & nohup /usr/sbin/pfsd &
The PFS daemons starts. 6.
Insert the eHealth InstallPlus CD into the CD drive and mount the CD by entering the following command: /usr/sbin/pfs_mount -t rrip -x unix device /cdrom
where device is the output in the format /dev/dsk/c#t#d# noted in Step 2. The CD is mounted. Begin the software installation process as described in the New Installations of eHealth 6.0 (UNIX) or Upgrading eHealth 5.6.5 or 5.7 to eHealth 6.0 (UNIX) guides. To mount a CD drive that is locally connected to a Solaris system 1.
Log on to the eHealth system as root and insert the eHealth InstallPlus CD into the CD drive.
2.
Create a CD mount point, if necessary, by entering the following command: mkdir /cdrom
where cdrom is the mount point. The CD mount point is created. 3.
Mount the CD drive. Use the following command as a guideline, depending on your system: /etc/mount -F hsfs -r /dev/sr0 /cdrom
Note: /dev/sr0 or /dev/dsk/c0t6d0s0 are the default names for the Solaris CD device driver. Depending upon your system setup, you may need to contact your UNIX system administrator to obtain the appropriate CD device driver name. If the mount command fails, see your system documentation for the appropriate command. The CD drive is mounted. 4.
Confirm that the drive is mounted correctly by entering the /etc/mount command. Confirm that /cdrom appears in the list of mounted file systems. The CD drive mount is confirmed.
5.
Begin the software installation process as described in the New Installations of eHealth 6.0 (UNIX) or Upgrading eHealth 5.6.5 or 5.7 to eHealth 6.0 (UNIX) guide. If the system does not recognize the CD after you have followed these instructions (the system displays a device busy message), reboot the system and try again.
6
eHealth® Installation Administration Tasks Reference (UNIX)
Mount the CD Drive from a Remote System To mount the eHealth InstallPlus CD over a network file system (NFS), you must first examine and load the exports file on the remote system, as well as mount the CD drive on both the remote and local system. You must have root privileges on the NFS server to mount the CD. To examine and load the exports file on the remote system 1.
Log on to the remote system as root and change to the appropriate directory by entering one of the following commands: •
Solaris: cd /etc/dfs
•
HP-UX: cd /etc
The directory is changed. 2.
List the exports file on the remote system by entering one of the following commands: • •
Solaris: ls dfstab HP-UX: ls exports
The list appears. If the file is not listed, use a text editor to create the file. 3.
Confirm that the exports file contains one of the following lines: •
Solaris: share -F nfs -o ro /cdrom
•
HP-UX: /cdrom -ro
If it does not contain the line, or if you created a new file in Step 2, use a text editor to add this line to the end of the file. 4.
Load the exports file on the remote system by entering one of the following commands: •
Solaris: shareall
•
HP-UX: The file is automatically loaded. To verify, enter the following command: usr/etc/showmount -e
If the file is not loaded, enter the following: exportfs -o ro /cdrom
The exports file is loaded on the remote system. To mount the CD drive on the remote system 1.
(HP-UX systems only) Examine the contents of the /etc/checklist file by entering the following command: grep /cdrom /etc/checklist
The command produces output similar to the following: device /cdrom cdfs ro
where device is the name of the CD device driver. If this output does not appear, use a text editor to add this line to the end of the /etc/checklist file. If the line is disabled with a pound (#) character, edit the file to remove the pound character. 2.
Mount the CD drive by using the following commands as guidelines, depending on your system: •
Solaris: /etc/mount -F hsfs -r /dev/sr0 /cdrom
•
HP-UX: /etc/mount /dev/dsk/c201d2s0 /cdrom -r -t cdfs
Note: /dev/sr0 and c201d2s0 are the standard default names for the CD device drivers. If the mount command fails, see your system documentation for the appropriate device driver. 3.
Log off of the remote system. The remote system CD drive is mounted. 7
eHealth® Installation Administration Tasks Reference (UNIX) To mount the CD on your local system 1.
Log on to the local system as root.
2.
Mount the CD drive by entering the following command, where server is the name of the remote system: /etc/mount server:/cdrom /cdrom
The CD is mounted on the local system.
Unmount the CD Drive For some UNIX systems you must unmount the CD drive to eject the CD in the drive. This section describes how to unmount the CD drive on HP-UX and Solaris systems. To unmount a CD drive that is locally connected to an HP-UX system 1.
Unmount the current CD drive by entering the following command: /usr/sbin/pfs_umount /cdrom
2.
Remove the CD from the CD drive. If the CD drive is mounted on another system, unmount it by following these steps on both your system and the remote system. The CD drive is unmounted.
To unmount the CD drive on a Solaris system 1.
If your current directory is the /cdrom directory, use the cd command to move to another directory.
2.
Unmount the CD drive by entering the following command. umount /cdrom
The CD drive is unmounted. If the CD drive is mounted to a Solaris system running Volume Management, enter the eject command to eject the disk. 3.
Remove the eHealth CD from the drive. The CD drive is unmounted.
Copy CDs to a Disk If the eHealth system does not have a local CD drive, or if you want to avoid changing CDs during installation, do one of the following: •
Copy the eHealth InstallPlus CD, eHealth Software CD, Oracle® 9i Software CDs, and Oracle Upgrade CD to a disk on the local system, and then run the InstallPlus program.
•
Copy the CDs to an NFS-mounted (or network-accessible) system. This type of installation is supported on systems running Solaris 2.9 and 2.10, and HP-UX 11.11 and 11.23 systems.
Follow these guidelines when copying CDs to a disk: •
You must install the eHealth software and the Oracle software from the same source, either CD or disk directory.
•
The InstallPlus and the Oracle Upgrade installation do not have to occur from the same source.
Note: Verify that you have the latest security patches and fixes by downloading the InstallPlus software and Oracle Upgrade software from the eHealth product website at http://support.concord.com. When possible, use these downloads instead of the CDs supplied with your eHealth package. For more information, see the New Installations of eHealth 6.0 (UNIX) or Upgrading eHealth 5.6.5 or 5.7 to eHealth 6.0 (UNIX) guides.
8
eHealth® Installation Administration Tasks Reference (UNIX) To copy the contents of the eHealth InstallPlus, eHealth Software, and Oracle Upgrade CDs to a disk 1.
Mount the eHealth InstallPlus CD.
2.
Change the directory to the location in which you mounted the CD.
3.
Create a directory for the contents of the CD. For example, if the /var directory has sufficient space, enter the following command: mkdir -p /var/cdimages/installplus
The directory is created. 4.
Copy the contents of the CD to the directory that you created using the following command: find . -print | cpio -pdmv /var/cdimages/installplus
The CDs are copied to the directory. 5.
Mount the eHealth Software CD.
6.
Create a directory on a disk with at least 650 MB of free space. Note: The installation program does not support the use of spaces in directory names. If you run the installation program from a directory such as /export/green/ca software/eh60, the installation fails. The directory is created.
7.
Change to the directory on which you mounted the CD and enter the following command to copy the contents of the eHealth Software CD: find . -print | cpio -pdmv ehdata
where ehdata is the full path to the directory that you created in Step 6. The directory is changed. 8.
Mount the Oracle Upgrade CD.
9.
Create a directory for the contents of the CD.
10.
Change to the directory on which you mounted the CD.
11.
Enter the following command to copy the contents of the Oracle Upgrade CD: find . -print | cpio -pdmv orupgrade
where orupgrade is the full path to the directory that you created in Step 10. The contents of the CDs are copied. To copy the contents of the Oracle 9i Software CDs to a disk
Note: eHealth upgrades use only the Oracle Upgrade CD, not the Oracle 9i Software CDs. 1.
Identify a disk that has at least 3 GB of free space.
2.
Create a directory structure on the disk for the Oracle Software CDs in the same subdirectory named Disk1, Disk2, Disk3, (and Disk4 for HP-UX only). For example: /var/cdimages/ora/Disk1 /var/cdimages/ora/Disk2 /var/cdimages/ora/Disk3 /var/cdimages/ora/Disk4
3.
To copy the first Oracle CD, do the following: a. Mount the Oracle CD labeled 1 of 3 (Solaris) or 1 of 4 (HP-UX). b. Change directory to the location in which you mounted the CD. c.
Create a directory for the contents of the first Oracle CD. For example, if the /var directory has sufficient space, enter the following command: mkdir -p /var/cdimages/ora/Disk1
d. Copy the contents of the CD to the directory that you created:
find . -print | cpio -pdmv /var/cdimages/ora/Disk1 9
eHealth® Installation Administration Tasks Reference (UNIX) 4.
To copy each subsequent Oracle CD, do the following: a. Mount the Oracle CD. b. Change directory to the location in which you mounted the CD. c.
Create a directory for the contents of the subsequent CD. For example, if the /var directory has sufficient space, enter the following command: mkdir -p /var/cdimages/ora/Disk1
d. Copy the contents of the CD to the directory that you created. Be sure to substitute the appropriate
path to the cpio command. Note: When the eHealth installation program prompts you for the location of the Oracle 9i Software CD images, enter the full path, excluding the disk and disk number. For example, if you copied the first Oracle 9i Software CD to /var/cdimages/ora/Disk1 and followed that convention for the other CDs, you would specify /var/cdimages/ora during the installation process.
Change the Web Server Port Number During a new installation, eHealth installs and configures the Apache web server. It automatically starts upon reboot of the system. However, if another web server or process is using the default web port (80), you must specify another port number and start the server manually. To change the Apache web server port number 1.
Log on as the eHealth administrator.
2.
Edit the nethealthrc.sh.usr file to set the NH_HTTP_PORT environment variable to the port that you want to use for your web server. For example, enter this definition in the nethealthrc.sh.usr file to set NH_HTTP_PORT to use port 80: NH_HTTP_PORT="80"; export NH_HTTP_PORT
Note: You must set this variable in the nethealthrc.sh.usr file. You cannot set it directly in the httpd.conf file. 3.
Use the following command to regenerate the web server configuration file to reflect the new port number: nhHttpdCfg -user ehUser -grp group -nhDir ehealth -cfg ehealth/web/webCfg/users.cfg -outFile ehealth/web/httpd/httpd.conf
where ehUser is the name of the eHealth administrator account, ehealth is the full path of the eHealth installation directory, and group is the name of the primary group of which the eHealth administrator account is a member. Note: Enter the command on one line. Do not press Enter to match the formatting shown in the example. The file reflects the new port number. 4.
Enter the following command to start the web server: nhHttpd start
Note: If you start the web server from the command line, you must use this command to restart it when it stops or after the system reboots. The port number is changed.
Copyright © 2006 CA. All rights reserved. 10
