2.4.2 Uninstalling JP1/Advanced Shell (UNIX only)

Organization of this subsection

(1) Uninstalling JP1/Advanced Shell manually
(2) Using JP1/Software Distribution to uninstall JP1/Advanced Shell
(3) If you were using the user-reply functionality

(1) Uninstalling JP1/Advanced Shell manually

This subsection explains how to uninstall JP1/Advanced Shell. You uninstall JP1/Advanced Shell by following the Hitachi Program Product Installer's instructions.

Before you uninstall JP1/Advanced Shell, terminate all programs provided by JP1/Advanced Shell. If you are using the user-reply functionality, terminate the user-reply functionality's management daemon. The installer's log files and any newly created files are not deleted during uninstallation. To completely delete the environment, the user must delete these files.

To uninstall JP1/Advanced Shell:

Start the Hitachi Program Product Installer by executing the following command:
```
/etc/hitachi_setup
```
The Hitachi Program Product Installer starts and the initial window is displayed.

The following shows an example of the Hitachi Program Product Installer's initial window:
```
  Hitachi PP Installer 05-16
 
    L) List Installed Software.
    I) Install Software.
    D) Delete  Software.
    Q) Quit.
 
    Select Procedure ===>
```
In the Hitachi Program Product Installer's initial window, enter D.

A list of the software programs that can be uninstalled is displayed.
Select JP1/Advanced Shell, and then enter D.

JP1/Advanced Shell is uninstalled. To select a program, move the cursor to the target program, and then press the space bar to select it.

The following shows an example of the uninstallation window:
```
       PP-No.               VR     PP-NAME
   001 P-8112-B1AL          1010   Advanced Shell
:
:
F) Forward B) Backward J) Down K) Up Space) Select/Unselect D) Delete Q) Quit
```
<@> is displayed to the left of the selected program product. If you enter D following <@>, the following message is displayed on the last line:
```
Delete PP? (y: delete, n: cancel) ==>
```
If you enter y or Y, uninstallation begins. If you enter n or N, uninstallation is cancelled and the program product uninstallation window is displayed again.
When uninstallation is completed successfully, enter Q.

The Hitachi Program Product Installer's initial window is displayed again.
If there are any unneeded files, such as execution log and trace files, delete them.

Note that the following files are created during uninstallation as installer's logs:

/opt/jp1as/instlog/ADSH_INST_LOG
/opt/jp1as/instlog/ADSH_INST_USERLOG

If the installer's log files are not created, possible causes are as follows:

The installer's log files are not regular files.
The user does not have write permission for the directory in which the installer's log files were created.
A file with the same name already exists at the path of each log file of the installer.

A file with the same name exists in the following cases:
- "/opt" is not a directory.
- "/opt/jp1as" is not a directory.
- "/opt/jp1as/instlog" is not a directory.

Notes:

If the user-reply functionality's management daemon is running, the uninstallation process is cancelled and the following message is output to /opt/jp1as/instlog/ADSH_INST_LOG:

One or more /opt/jp1as/sbin/adshmd processes are running.
Please stop them.

When this message has been output, execute the adshmdctl command to terminate the user-reply functionality's management daemon, and then perform uninstallation again.

Uninstallation is also cancelled if the user-reply functionality's management daemon does not terminated normally. In such a case, start the user-reply functionality's management daemon and then terminate it, then perform uninstallation again.

To Page Top

(2) Using JP1/Software Distribution to uninstall JP1/Advanced Shell

For details about how to use JP1/Software Distribution to uninstall JP1/Advanced Shell, see the manuals Job Management Partner 1/Software Distribution Manager and Job Management Partner 1/Software Distribution SubManager (for UNIX systems).

To Page Top

(3) If you were using the user-reply functionality

If you were using the user-reply functionality, perform the following after uninstallation has been completed:

Delete the adapter command configuration file used for the user-reply functionality that has been set up for JP1/Base. For details about the storage directory for the adapter command configuration file used for the user-reply functionality, see 2.8.3(2) Setting up JP1/Base.
If the user-reply functionality's management daemon has been set to start and terminate automatically, disable the automatic start and termination settings.

In AIX:
1. Disable the automatic start setting for the user-reply functionality's management daemon by executing the following command:
  
  rmitab adshmd
2. If the user-reply functionality's management daemon for the logical host is set to start automatically, execute the rmitab command specifying the record of the user-reply functionality's management daemon for the logical host.
3. To disable the automatic termination function at system shutdown, delete the following code from /etc/rc.shutdown:
  
  test -x /opt/jp1as/sbin/adshmdctl && /opt/jp1as/sbin/adshmdctl stop
4. If the user-reply functionality's management daemon for the logical host is set to terminate automatically, delete the specification for automatically terminating the user-reply functionality's management daemon for the logical host from /etc/rc.shutdown.
In Linux, HP-UX, and Solaris:
1. Delete from the target directory the jp1_as_md script file that was copied from the /opt/jp1as/sample directory.
2. If you have created automatic start and termination script files for the logical host, delete them from the target directory.
3. Delete the symbolic link that was created as a link to the jp1_as_md script file.
4. If you have created symbolic links to the automatic start and termination script files for the logical host, delete them.
For details about the target directory to which the automatic start and termination script files are to be copied, see 2.8.3(1) Starting and terminating the user-reply functionality's management daemon automatically. For details about the target directory to which the automatic start and termination script files for the logical host are to be created and the target directory to which the symbolic links are to be created, see 2.9.5(2) Automatic startup and termination of the user-reply functionality's management daemon for the logical host in a non-cluster environment (UNIX only).

To Page Top