4.2.4 Installation

This section describes the installation procedures for the Solaris, Linux, HP-UX, and AIX editions of Agent.

Solaris

Activate the system in single user mode.

[ok prompt] boot -s

Information

Input the following command at the ok prompt.

Type Ctrl-d to proceed with normal startup.
(or give root password for system maintenance): superuser password

Mount the local file system.
# /usr/sbin/mountall -l
Mount the CD-ROM(Agent Program) for this software product.
# mount -F hsfs -o ro /dev/dsk/c0t4d0s0 <CD-ROM mount point>
Information
The device name of the CD-ROM device differs for different devices.
When you execute swsetup (Installation command) for this software, multiple packages are installed at one time. The swsetup command calls the pkgadd command, and installs all the packages (Agent functions) listed in "A.1 Solaris Platform" of "Program Components of AdvancedCopy Manager"
# cd <CD-ROM mount point>/agent/solaris # ./swsetup
The following configuration is not necessary if the easysetup command is used.
- Settings for the installation destination directory
- Registering the port number in the /etc/services
  # cd <CD-ROM mount point>/agent/solaris # ./easysetup [-o] or # ./easysetup -p port-number [-o]
- If the option is not specified
  Use the default value (1226) for the port number used in the Storage Server.
  If the stgxfws service port number is already registered in the /etc/services, then the existing port number is used -this is why the registration of the port number is skipped.
- If the option is specified
  Specify one of the options as required.
  - -p option
    Use this option to change the port number used for the Storage Server.
    The range of the port number is from 1024 to 65535.
    If the stgxfws service port number is already registered in the /etc/services, then the existing port number is used-this is why the registration of the port number is skipped.
  - -o option
    Specify this option if the port number and installation destination directory are to be specified by the interactive setup.
    If the stgxfws service port number is already registered in the /etc/services or the -p option is specified with this option, the port number will not be asked during the interactive setup, as the existing port number will be used.
Point
- The default value is used for the installation destination directory.
  Refer to the step 7 and after for the default value.
- The port number is not registered if the stgxfws service port number or the port number specified by the -p option is already registered by other software.
  Refer to "Port number setting (/etc/services)" to register the port number manually.
If SystemWalker/StorageMGR, AdvancedCopy Manager or ETERNUS SF AdvancedCopy Manager has been installed, either of the following messages is displayed, and processing is terminated.
# swsetup: ERROR: SystemWalker/StorageMGR is already installed.
# swsetup: ERROR: AdvancedCopy Manager is already installed.

The install directory category type and the initial value of the install directory name are displayed. To change the following information, input "y." To leave the information as is, input "n" or press the Return key, and then go to step 10.

Table 4.9 Installation directory (Default value)
# ./swsetup swsetup: Installer is preparing for installation... +-----------------------------------------------------------+ \| ETERNUS SF AdvancedCopy Manager \| \| 14.2 \| \| Copyright FUJITSU LIMITED 2010 \| +-----------------------------------------------------------+ Welcome to Setup. This program will install "AdvancedCopy Manager" on your system. Agent setup... Default installation settings for this setup are as follows: Program install directory : /opt Fixed configuration directory : /etc/opt Modifying configuration directory : /var/opt Do you want to change the installation settings? (default: n) [y,n,?,q]

Table 4.9 Installation directory (Default value)

# ./swsetup
swsetup: Installer is preparing for installation...
+-----------------------------------------------------------+
|            ETERNUS SF AdvancedCopy Manager                |
|                           14.2                            |
|                  Copyright FUJITSU LIMITED 2010           |
+-----------------------------------------------------------+

Welcome to Setup.
This program will install "AdvancedCopy Manager" on your system.

Agent setup...
Default installation settings for this setup are as follows:
        Program install directory           : /opt
        Fixed configuration directory       : /etc/opt
        Modifying configuration directory   : /var/opt

Do you want to change the installation settings? (default: n) [y,n,?,q]

Install directory for the packages (Program install directory)
The initial parent path value is /opt.
Install directory for the environment setup file (Fixed configuration directory)
The initial parent path value is /etc/opt.
Install directory for the files to be modified, such as log file or temporary file (Modifying configuration directory)
The initial parent path value is /var/opt.

When you specify "y" in step 7, also specify the install directory category type and the install directory name.

Please specify install directory: (default: /opt) [?,q] /opt

Please specify fixed configuration directory: (default: /etc/opt) [?,q]  /etc/opt

Please specify variable configuration directory: (default: /var/opt) [?,q] /var/opt

To confirm the message, input "n," or press the Return key. To make any other changes, input "y."

Installation settings for this setup are as follows:
        Program install directory           : /opt
        Fixed configuration directory       : /etc/opt
        Modifying configuration directory   : /var/opt

Do you want to change the installation settings? (default: n) [y,n,?,q]

To confirm the final message and start the installation, input "y." To cancel the installation, input "n."
Do you want to continue with the installation of this package? [y,n,?]

Installation begins. An example of the display is shown below.

swsetup: Starting installation of AdvancedCopy Manager...
. . .

When the installation completes successfully, the system displays the following message.
swsetup: AdvancedCopy Manager was installed successfully.
Execute the following commands, and then press the eject button to remove the CD-ROM of this software from the drive.
# cd / <RETURN> # umount <CD-ROM mount point>
Reboot the system.
# /usr/sbin/shutdown -y -i6 -g0
For details on how to set up the environment, see "5.2 Solaris/Linux/HP-UX/AIX Platform" of "Customization of Storage Server".

Linux

Log in to the system as a root (super user).
This software CD-ROM (agent program) is inserted.
It is an example as follows for doing the mount to /dev/cdrom (It is set to /etc/fstab as a default mount of cd media).
# mount /dev/cdrom
When you execute swsetup (Installation command) for this software, multiple packages are installed at one time. The swsetup command calls the rmp command, and installs all the packages (Agent functions) listed in "A.2 Linux Platform" of "Program Components of AdvancedCopy Manager"
[System environment of v. 4 for x86 and v. 4 for EM64T]
# cd <CD-ROM mount point>/agent/linux/linux4_x86 # ./swsetup
[System environment of v. 4 for Itanium]
# cd <CD-ROM mount point>/agent/linux/linux4_ia64 # ./swsetup
[System environment of 5 for x86]
# cd <CD-ROM mount point>/agent/linux/linux5_x86 # ./swsetup
[System environment of 5 for Intel64]
# cd <CD-ROM mount point>/agent/linux/linux5_x64 # ./swsetup
[System environment of 5 for Intel Itanium]
# cd <CD-ROM mount point>/agent/linux/linux5_ia64 # ./swsetup
The following configuration is not necessary if the easysetup command is used.
- Settings for the installation destination directory
- Registering the port number in the /etc/services
  # cd <CD-ROM mount point>/agent/linux/(each OS directory) # ./easysetup [-o] or # ./easysetup -p port-number [-o]
- If the option is not specified
  Use the default value (1226) for the port number used in the Storage Server.
  If the stgxfws service port number is already registered in the /etc/services, then the existing port number is used-this is why the registration of the port number is skipped.
- If the option is specified
  Specify one of the options as required.
  - -p option
    Use this option to change the port number used for the Storage Server.
    The range of the port number is from 1024 to 65535.
    If the stgxfws service port number is already registered in the /etc/services, then the existing port number is used-this is why the registration of the port number is skipped.
  - -o option
    Specify this option if the port number and installation destination directory are to be specified by the interactive setup.
    If the stgxfws service port number is already registered in the /etc/services or the -p option is specified with this option, then the port number will not be asked during the interactive setup as the existing port number will be used.
Point
- The default value is used for the installation destination directory.
  Refer to the step 7 and after for the default value.
- The port number is not registered if the stgxfws service port number or the port number specified by the -p option is already registered by other software.
  Refer to "Port number setting (/etc/services)" to register the port number manually.

The default value for the installation destination directory is displayed. To change the following information, input "y". To leave the information as is, input "n" or press the Return key, and then go to step 7.

Table 4.10 Installation directory (Default value)
# ./swsetup swsetup: Installer is preparing for installation... +-----------------------------------------------------------+ \| ETERNUS SF AdvancedCopy Manager \| \| 14.2 \| \| Copyright FUJITSU LIMITED 2010 \| +-----------------------------------------------------------+ Welcome to Setup. This program will install "AdvancedCopy Manager" on your system. Agent setup... Default installation settings for this setup are as follows: Program install directory : /opt Fixed configuration directory : /etc/opt Modifying configuration directory : /var/opt Do you want to change the installation settings? (default: n) [y,n,?,q]

Table 4.10 Installation directory (Default value)

# ./swsetup
swsetup: Installer is preparing for installation...
+-----------------------------------------------------------+
|            ETERNUS SF AdvancedCopy Manager                |
|                            14.2                           |
|                  Copyright FUJITSU LIMITED 2010           |
+-----------------------------------------------------------+

Welcome to Setup.
This program will install "AdvancedCopy Manager" on your system.

Agent setup...
Default installation settings for this setup are as follows:
        Program install directory           : /opt
        Fixed configuration directory       : /etc/opt
        Modifying configuration directory   : /var/opt

Do you want to change the installation settings? (default: n) [y,n,?,q]

Install directory for the packages (Program install directory)
The initial parent path value is /opt.
Install directory for the environment setup file (Fixed configuration directory)
The initial parent path value is /etc/opt.
Install directory for the files to be modified, such as log file or temporary file (Modifying configuration directory)
The initial parent path value is /var/opt.

When you specify "y" in step 4, also specify the install directory category type and the install directory name.

Please specify install directory: (default: /opt) [?,q] /opt

Please specify fixed configuration directory: (default: /etc/opt) [?,q]  /etc/opt

Please specify modifying configuration directory: (default: /var/opt) [?,q] /var/opt

To confirm the message, input "n" or press the Return key. To make any other changes, input "y".

Installation settings for this setup are as follows:
        Program install directory           : /opt
        Fixed configuration directory       : /etc/opt
        Modifying configuration directory   : /var/opt

Do you want to change the installation settings? (default: n) [y,n,?,q]

To confirm the final message and start the installation, input "y". To cancel the installation, input "n"
Do you want to continue with the installation of this package? [y,n,?]

Installation begins. An example of the display is shown below.

swsetup: Starting installation of AdvancedCopy Manager...
swsetup: Starting installation of package. : FJSVswstf

./cmd/swpkgadd.sh FJSVswstf /opt/swstorage/etc/swinst.res


FJSVswstf RPM installing......
rpm -ivh --nodeps ./pkg/FJSVswstf-14.2-01.i386.rpm
Preparing...                ########################################### [100%]
   1:FJSVswstf              ########################################### [100%]


swsetup: Package is successfully installed. : FJSVswstf

swsetup: Starting installation of package. : FJSVswtrc

./cmd/swpkgadd.sh FJSVswtrc /opt/swstorage/etc/swinst.res

When the installation completes successfully, the system displays the following message.
swsetup: AdvancedCopy Manager was installed successfully.
Execute the following commands, and then remove the CD-ROM from the drive.
# cd / # umount /dev/cdrom # eject
Reboot the system.
# shutdown -r now
For details on how to set up the environment, see "5.2 Solaris/Linux/HP-UX/AIX Platform" of "Customization of Storage Server".

HP-UX

Log in as root (super user) and execute the following commands.
# /usr/sbin/pfs_mountd & # /usr/sbin/pfsd &
Create the CD-ROM mount destination /cdrom. If /cdrom already exists, this step is not required.
# mkdir -p /cdrom
Mount the CD-ROM(Agent Program). In the following example, the CD-ROM device file name is specified as /dev/dsk/c1t2d0, and the mount point name is specified as /cdrom.
# /usr/sbin/pfs_mount -t rrip -x unix /dev/dsk/c1t2d0 /cdrom
Execute the following command and start installing Agent of AdvancedCopy Manager.
# cd /cdrom/agent/hp-ux # ./swsetup
If the easysetup command is executed, there is no need to register the /etc/services file port number.
# cd /cdrom/agent/hp-ux # ./easysetup [-o] or # ./easysetup -p port-number [-o]
There is no need to specify the "-p" option when the port number used for the Storage Server is 1226 (the default value).
When the port number used for the Storage Server is not 1226, specify the "-p" option.
When the "-o" option is specified, specify the port number used for Storage Server communication and the installation destination directory during the interactive setup.
If SystemWalker/StorageMGR, Softek AdvancedCopy Manager or ETERNUS SF AdvancedCopy Manager has been installed, either of the following messages is displayed, and processing is terminated.
# swsetup: ERROR: SystemWalker/StorageMGR is already installed.
# swsetup: ERROR: AdvancedCopy Manager is already installed.
The SystemWalker/StorageMGR package will need to be uninstalled. See "HP-UX" of "Items to check before Installation" for additional information.

The install directory category type and the initial parent path value of the install directory name are displayed. To change the installation destination, enter y; otherwise, enter n, and then go to step 9.

Table 4.11 Installation directory (Default value)
# ./swsetup #swsetup: Installer is preparing for installation... +-----------------------------------------------------------+ \| ETERNUS SF AdvancedCopy Manager \| \| 14.2 \| \| Copyright FUJITSU LIMITED 2010 \| +-----------------------------------------------------------+ Welcome to Setup. This program will install "AdvancedCopy Manager" on your system. Agent setup... Default installation settings for this setup are as follows: Program install directory : /opt Fixed configuration directory : /etc/opt Modifying configuration directory : /var/opt Do you want to change the installation settings? (default: n) [y,n,?,q]

Table 4.11 Installation directory (Default value)

# ./swsetup
#swsetup: Installer is preparing for installation...
+-----------------------------------------------------------+
|             ETERNUS SF AdvancedCopy Manager               |
|                              14.2                         |
|                  Copyright FUJITSU LIMITED 2010           |
+-----------------------------------------------------------+

Welcome to Setup.
This program will install "AdvancedCopy Manager" on your system.

Agent setup...
Default installation settings for this setup are as follows:
        Program install directory         : /opt
        Fixed configuration directory     : /etc/opt
        Modifying configuration directory : /var/opt


Do you want to change the installation settings? (default: n) [y,n,?,q]

Program install directory
Program installation directory. The initial parent path value is /opt.
Fixed configuration directory
Installation directory of the environment definition file. The initial parent path value is /etc/opt.
Modifying configuration directory
Installation directory of the file (log/temporary file) to be changed. The initial parent path value is /var/opt.

When you specify "y" in step 6, also specify the install directory category type and the install directory name.

Please specify install directory: (default: /opt) [?,q] /opt

Please specify fixed configuration directory: (default: /etc/opt) [?,q] /etc/opt

Please specify variable configuration directory: (default: /var/opt) [?,q] /var/opt

When the confirmation message of the entered directory name is displayed, check it and reply with "n". To change the contents again, reply with "y". If you replied with "y", step 7 is displayed again.

Installation settings for this setup are as follows:
        Program install directory         : /opt
        Fixed configuration directory     : /etc/opt
        Modifying configuration directory : /var/opt


Do you want to change the installation settings? (default: n) [y,n,?,q] n

When the last confirmation message for starting the installation is displayed, verify that there are no problems, and enter "y".

This package contains scripts which will be executed with super-user
permission during the process of installing this package.

Do you want to continue with the installation of this package[y,n,?] y

Installation starts.

swsetup: Starting installation of AdvancedCopy Manager...
swsetup: Starting installation of package. : FJSVswstf
./cmd/swpkgadd.sh FJSVswstf /opt/swstorage/etc/swinst.res
FJSVswstf
                  
                  :
swsetup: Package is successfully installed. : FJSVswstf
swsetup: Starting installation of package. : FJSVswtrc
                  
                  :
swsetup: Package is successfully installed. : FJSVswtrc
swsetup: Starting installation of package. : FJSVgrapi
                  
                  :
swsetup: Package is successfully installed. : FJSVgrapi
swsetup: Starting installation of package. : FJSVswsts
                  
                  :
swsetup: Package is successfully installed. : FJSVswsts

When the installation is completed, the following message is displayed.
swsetup: AdvancedCopy Manager was installed successfully.
Unmount the Agent of AdvancedCopy Manager CD-ROM by executing the following command.
# cd / # /usr/sbin/pfs_umount /cdrom
Reboot the system.
# /usr/sbin/shutdown -y -r now
For details on how to set up the environment, see "5.2 Solaris/Linux/HP-UX/AIX Platform" of "Customization of Storage Server".
Note
When mounting the CD-ROM, note the following points.
- If a user (usually, root) who executes the pfs_mount command belongs to nine or more groups, an error occurs, as shown below.
  pfs_mount /dev/dsk/device-name not owner. pfs_mount giving up on cdrom.
  If the user who executes the pfs_mount command belongs to nine or more groups in the /etc/group file, change the /etc/group file so that the user belongs to 8 or less groups.
- When the pfs_mount command is executed, an error may be output, as shown below.
  /usr/sbin/pfs_mount:/etc/pfs_fstab:No such file or directory
  In this case, create a /etc/pfs_fstab file in /etc.
  # touch /etc/pfs_fstab # chown root:root /etc/pfs_fstab # chmod 644 /etc/pfs_fstab
- When pfs_mount is performed, if the resolv.conf file exists under /etc, an error may occur. To prevent this error, temporarily save the resolv.conf file by following the method below and execute the pfs_mount command.
  1. After temporarily saving the file with the following command, execute the mount operation.
    # mv resolv.conf resolv.conf.org
  2. After installing Agent of AdvancedCopy Manager, restore the environment.
    # mv resolv.conf.org resolv.conf

AIX

Log in as root (super user) and create the CD-ROM mount destination /cdrom. If /cdrom already exists, this step is not required.
# mkdir -p /cdrom
Mount the CD-ROM (Agent Program). In the following example, the CD-ROM device file name is specified as /dev/cd0, and the mount point name is specified as /cdrom.
# /usr/sbin/mount -o ro -v cdrfs /dev/cd0 /cdrom
Execute the following command and start installing Agent of AdvancedCopy Manager.
# cd /cdrom/agent/aix # ./swsetup
If the easysetup command is executed, there is no need to register the /etc/services file port number.
# cd /cdrom/agent/aix # ./easysetup [-o] or # ./easysetup -p port-number [-o]
There is no need to specify the "-p" option when the port number used for the Storage Server is 1226 (the default value).
When the port number used for the Storage Server is not 1226, specify the "-p" option.
When the "-o" option is specified, specify the port number used for Storage Server communication and the installation destination directory during the interactive setup.
If AdvancedCopy Manager has been installed, either of the following messages is displayed, and processing is terminated.
# swsetup: ERROR: AdvancedCopy Manager is already installed.
Uninstall it. See "AIX" of "Items to check before Installation" if the above-mentioned message is output.

The install directory category type and the initial value of the install directory name are displayed. To change the installation destination, enter "y"; otherwise, enter "n", and then go to step 8.

Table 4.12 Installation directory (Default value)

# ./swsetup
#swsetup: Installer is preparing for installation...
+-----------------------------------------------------------+
|             ETERNUS SF AdvancedCopy Manager               |
|                              14.2                         |
|                  Copyright FUJITSU LIMITED 2010           |
+-----------------------------------------------------------+

Welcome to Setup.
This program will install "AdvancedCopy Manager" on your system.

Agent setup...
Default installation settings for this setup are as follows:
        Program install directory         : /opt
        Fixed configuration directory     : /etc/opt
        Modifying configuration directory : /var/opt


Do you want to change the installation settings? (default: n) [y,n,?,q]

Program install directory
Program installation directory. The initial parent path value is /opt.
Fixed configuration directory
Installation directory of the environment definition file. The initial parent path value is /etc/opt.
Modifying configuration directory
Installation directory of the file (log/temporary file) to be changed. The initial parent path value is /var/opt.

When you specify "y" in step 5, also specify the install directory category type and the install directory name.

Please specify install directory: (default: /opt) [?,q] /opt

Please specify fixed configuration directory: (default: /etc/opt) [?,q] /etc/opt

Please specify variable configuration directory: (default: /var/opt) [?,q] /var/opt

When the confirmation message of the entered directory name is displayed, check it and reply with "n". To change the contents again, reply with "y". If you replied with "y", step 6 is displayed again.

Installation settings for this setup are as follows:
        Program install directory         : /opt
        Fixed configuration directory     : /etc/opt
        Modifying configuration directory : /var/opt

Do you want to change the installation settings? (default: n) [y,n,?,q] n

When the last confirmation message for starting the installation is displayed, verify that there are no problems, and enter "y".

This package contains scripts which will be executed with super-user
permission during the process of installing this package.

Do you want to continue with the installation of this package[y,n,?] y

Installation starts.

swsetup: Starting installation of AdvancedCopy Manager...
swsetup: Starting installation of package. : FJSVswstf
./cmd/swpkgadd.sh FJSVswstf /opt/swstorage/etc/swinst.res
FJSVswstf
                  
                  :
swsetup: Package is successfully installed. : FJSVswstf
swsetup: Starting installation of package. : FJSVswtrc
                  
                  :
swsetup: Package is successfully installed. : FJSVswtrc
swsetup: Starting installation of package. : FJSVgrapi
                  
                  :
swsetup: Package is successfully installed. : FJSVgrapi
swsetup: Starting installation of package. : FJSVswsts
                  
                  :
swsetup: Package is successfully installed. : FJSVswsts

When the installation is successfully completed, the following message is displayed.
swsetup: AdvancedCopy Manager was installed successfully.
If the easysetup command has not been executed in step 3, the following line must be in the /etc/rc.shutdown file.
/opt/FJSVswstf/daemon/stop_smgr0
Note
Without the above configuration setting, AdvancedCopy Manager may not be stopped normally. Also, AdvancedCopy Manager may not start normally when the OS is restarted, and this would have an adverse effect on operation.
Do not use the reboot command to restart the OS, use the shutdown command with the relevant option instead.
Unmount the Agent of AdvancedCopy Manager CD-ROM by executing the following command.
# cd / <RETURN> # /usr/sbin/umount /cdrom
Reboot the system.
# /usr/sbin/shutdown -r
For details on how to set up the environment, see "5.2 Solaris/Linux/HP-UX/AIX Platform" of "Customization of Storage Server".

4.2.4 Installation

4.2.4.1 Items to check before Installation

4.2.4.2 Installation procedures