Upgrading from a Previous Revision of Software
To upgrade from a previous version of the IMS AAA Server or the Administrator software, perform the pkgadd command.
When you upgrade from a previous version of either the IMS AAA Server or the Administrator software, the system backs-up your existing installation. The folders/files that are backed up depend on whether you use the pkgrm command to remove the previous version of software prior to performing the pkgadd command to install the new version. If you do not remove the previous version, all folders/ files are backed-up, included all MIBs and dictionaries. If you do remove the previous version, only certain folders/files are backed-up.
In either case, the software detects the previous version, performs the folder/file back-up, and overwrites the existing installation. The software creates a directory named previous_install and saves the folder/files as a datetime.backup. Following is an example:
root@myserver:/opt/AAA/a3s/previous_install/20071029094149.backup
If you perform the pkgrm command prior to the pkgadd command, the following files are backed up (a / denotes a folder:
If you do not perform the pkgrm command prior to the pkgadd command, the following folders/files are backed-up (a / denotes a folder):
Before performing an upgrade, you should stop the server, and then the SNMP agent (if applicable) using the following commands:
If you do not stop the server, the software prompts you to stop it as shown in the following example:
root@myserver:/export/home/qa/build2156 #pkgadd -d JNPRa3s.pkg
The following packages are available:
1 JNPRa3s Juniper Networks IMS AAA Server
(sun4u) 1.0.0
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1
Processing package instance <JNPRa3s> from </export/home/qa/build2156/JNPRa3s.pkg>
Juniper Networks IMS AAA Server(sun4u) 1.0.0
This appears to be an attempt to install the same architecture and
version of a package which is already installed. This installation
will attempt to overwrite this package.
Juniper Networks, Inc.
Checking for a running a3s server...
a3s server is running with pid 24957
Stop a3s server before installing new version.
pkgadd: ERROR: request script did not complete successfully
Installation of <JNPRa3s> failed.
No changes were made to the system.
root@myserver:/export/home/qa/build2156 #
Example Output of Upgrade After Removing Existing Installation
The following example shows the output when you perform the pkgrm followed by pkgadd:
# pkgrm
The following packages are available:
1 JNPRa3s Juniper Networks IMS AAA Server
(sun4u) 1.0.0
.
.
.
... 1158 more menu choices to follow;
<RETURN> for more choices, <CTRL-D> to stop display:^D
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1
The following package is currently installed:
JNPRa3s Juniper Networks IMS AAA Server
(sun4u) 1.0.0
Do you want to remove this package? [y,n,?,q] y
## Removing installed package instance <JNPRa3s>
This package contains scripts which will be executed with super-user
permission during the process of removing this package.
Do you want to continue with the removal of this package [y,n,?,q] y
## Verifying package <JNPRa3s> dependencies in global zone
## Processing package information.
## Executing preremove script.
Removing /etc/rc2.d/S90a3s /etc/rc2.d/K90a3s /etc/rc2.d/S89snmpd /etc/rc2.d/K89snmpd
## Removing pathnames in class <none>
/usr/local/a3s/v_microsoft.dic
/usr/local/a3s/v_juniper.dic
/usr/local/a3s/v_funk.dic
/usr/local/a3s/v_3gpp.dic
/usr/local/a3s/ts32299.dic
/usr/local/a3s/ts32252.dic
.
.
.
## Executing postremove script.
All previous installations are backed up in previous_install directory and it is safe to remove them at any time
Backing up previous installation to 20071109085233.backup...
## Updating system information.
Removal of <JNPRa3s> was successful.
# ls /usr/local/a3s
previous_install
# pkgadd -d JNPRa3s.pkg
The following packages are available:
1 JNPRa3s Juniper Networks IMS AAA Server
(sun4u) 1.0.0
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1
Processing package instance <JNPRa3s> from </tmp/JNPRa3s.pkg>
Juniper Networks IMS AAA Server(sun4u) 1.0.0
Juniper Networks, Inc.
Checking for a running a3s server...
Please enter the license string: xxxx xxxx xxxx xxxx xxxx
Please enter the name of the directory where a3s should be installed, if target directory doesn't exist, it will be created [/usr/local/a3s]:
Do you want to configure a3s to be automatically launched during boot time and stopped during shutdown time [y,n]: n
You may use 'root' to log on to a3s UI at any time. In addition to that, you may choose an existing unix group.
Any unix user account in that group will be able to log on to a3s UI as administrator.
Please enter an existing unix group name[other]:
Enter a3s admin TCP port[1813]:
Enter a3s admin TCP port for snmp agent private access[6669]:
Enter listening port for snmp agent[161]:
Enter address a3s will send snmp trap to(usually a snmp trap daemon is running there)(hostname or ip address)[localhost]:
Enter listening port for snmp trap daemon[162]:
Enter community string[public]:
Using </usr/local/a3s> as the package base directory.
## Processing package information.
## Processing system information.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
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 <JNPRa3s> [y,n,?] y
Installing Juniper Networks IMS AAA Server as <JNPRa3s>
## Executing preinstall script.
All previous installations are backed up in previous_install directory and it is safe to remove them at any time
## Installing part 1 of 1.
/usr/local/a3s/S89snmpd.template
/usr/local/a3s/S90a3s.template
/usr/local/a3s/a3s.xml
/usr/local/a3s/bi-3s
.
.
.
/usr/local/a3s/v_funk.dic
/usr/local/a3s/v_juniper.dic
/usr/local/a3s/v_microsoft.dic
[ verifying class <none> ]
## Executing postinstall script.
Creating S90a3s.
Creating S89snmpd.
generating script resetDatabase.sh
generating snmpd.conf
Warning: No database to delete .. continuing
created system.xdb
created system.xdb/aaa_decorator
loaded config/aaa_decorator.xml
created system.xdb/access_group_mgr
loaded config/access_group_mgr.xml
created system.xdb/access_level_mgr
loaded config/access_level_mgr.xml
.
.
.
created system.xdb/wf_decorator
loaded config/wf_decorator.xml
created system.xdb/wx_decorator
loaded config/wx_decorator.xml
Installation of <JNPRa3s> was successful.
#
Example Output of Upgrade Without Removing Existing Installation
The following example shows the output for the pkgadd command without removing the previous version of software:
# pkgadd -d JNPRa3s.pkg
The following packages are available:
1 JNPRa3s Juniper Networks IMS AAA Server
(sun4u) 1.0.0
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1
Processing package instance <JNPRa3s> from </tmp/JNPRa3s.pkg>
Juniper Networks IMS AAA Server(sun4u) 1.0.0
This appears to be an attempt to install the same architecture and
version of a package which is already installed. This installation
will attempt to overwrite this package.
Juniper Networks, Inc.
Checking for a running a3s server...
Please enter the license string: xxxx xxxx xxxx xxxx xxxx
Please enter the name of the directory where a3s should be installed, if target directory doesn't exist, it will be created [/usr/local/a3s]:
Do you want to configure a3s to be automatically launched during boot time and stopped during shutdown time [y,n]: n
You may use 'root' to log on to a3s UI at any time. In addition to that, you may choose an existing unix group.
Any unix user account in that group will be able to log on to a3s UI as administrator.
Please enter an existing unix group name[other]: develop
Enter a3s admin TCP port[1813]:
Enter a3s admin TCP port for snmp agent private access[6669]:
Enter listening port for snmp agent[161]:
Enter address a3s will send snmp trap to(usually a snmp trap daemon is running there)(hostname or ip address)[localhost]:
Enter listening port for snmp trap daemon[162]:
Enter community string[public]:
Using </usr/local/a3s> as the package base directory.
## Processing package information.
## Processing system information.
10 package pathnames are already properly installed.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
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 <JNPRa3s> [y,n,?] y
Installing Juniper Networks IMS AAA Server as <JNPRa3s>
## Executing preinstall script.
All previous installations are backed up in previous_install directory and it is safe to remove them at any time
Backing up previous installation to 20071108090056.backup...
## Installing part 1 of 1.
/usr/local/a3s/S89snmpd.template
/usr/local/a3s/S90a3s.template
/usr/local/a3s/a3s.xml
/usr/local/a3s/bi-3s
/usr/local/a3s/bin/dcfDOM.so
.
.
.
/usr/local/a3s/v_funk.dic
/usr/local/a3s/v_juniper.dic
/usr/local/a3s/v_microsoft.dic
[ verifying class <none> ]
## Executing postinstall script.
Creating S90a3s.
Creating S89snmpd.
generating script resetDatabase.sh
generating snmpd.conf
created system.xdb
created system.xdb/aaa_decorator
loaded config/aaa_decorator.xml
created system.xdb/access_group_mgr
loaded config/access_group_mgr.xml
created system.xdb/access_level_mgr
loaded config/access_level_mgr.xml
.
.
.
created system.xdb/wx_decorator
loaded config/wx_decorator.xml
Installation of <JNPRa3s> was successful.
