APTARE StorageConsole 5.0.1x to 5.1.

03 Upgrade Notes for UNIX

NOTE: The follow instructions assume that the database and the portal server components are on the same system. They also assume you have a standard install environment. If you have made any customizations to your environment (e.g. multiple tomcat agent instances), or your database runs on a separate server, please contact support for additional upgrade instructions. These instructions also assume the current version you are running is 5.0.10 or greater. If you are on a version prior to 5.0.10, please contact APTARE customer support to discuss the upgrade procedure for your environment.

5.0.1x to 5.1.03 Upgrade Preparation

The upgrade from 5.0 to 5.1.03 includes a new version of Oracle 10g. To upgrade the database structures to the new Oracle 10g format, the database must be exported, the oracle tablespaces recreated, and the database imported again. Since the existing database structures will be destroyed prior to re-creation, it is imperative that you have a valid backup of your Oracle database environment prior to performing this upgrade. To back up the database files, ensure Oracle is first fully shutdown, and then backup the files in the /data0X directories (where X can be 1-7). You should also ensure you have a valid full backup of the Portal file systems. Check the available disk space under /opt for the new Oracle 10g binaries that will be installed there. Make sure that you have at least 1.5GB of free disk space under /opt. The upgrade process will create a new UNIX group (dba) and update group membership for the aptare user. Please ensure that user accounts and groups are managed locally and not centrally, otherwise the groupadd and usermod statements in the upgrade scripts may fail. Download the 5103 product ISO file from the appropriate link and then burn a CD from the ISO image: www.aptare.com/customercare/downloads/5103/storageconsoleSOL.iso (for Solaris portal) or www.aptare.com/customercare/downloads/5103/storageconsoleLIN.iso (for Linux portal) Download the 5103 upgrade script tar file from: www.aptare.com/customercare/downloads/5103_upgrade_scripts.tar and place it in the /opt/aptare/releases directory on the portal server. You may have to create this directory if it does not exist. Untar the upgrade scripts file as follows: su - root cd /tmp gtar1 xvf /opt/aptare/releases/5103_upgrade_scripts.tar Verify the names of the tablespaces used by the portal as follows: su oracle sqlplus portal/portal_password2 select unique tablespace_name from user_tables;
1 2

For solaris, you may have to specify /opt/aptare/utils/solaris/gtar Default password is portal

Prepared by: APTARE, Inc. Use pursuant to company instructions Page 1 of 8 Modified on: 4/10/2006 1:37:00 PM ALL RIGHTS RESERVED Copyright 2003 - 2006 APTARE, Inc. NOTICE OF OWNERSHIP: THIS DOCUMENT IS THE EXCLUSIVE PROPERTY OF APTARE, INC.

APTARE StorageConsole 5.0.1x to 5.1.03 Upgrade Notes for UNIX

quit If the tablespace names begin with APTARE then you may proceed. Otherwise please contact APTARE support with the output from the SQL command for further instructions.

FOR LINUX SYSTEMS: Ensure that the libaio and libaio-devel RPMs are installed on the system by executing the command as shown below. If the RPMs are not installed, you will have to download and install them before beginning the upgrade. # rpm -q libaio libaio-devel libaio-0.3.96-5 libaio-devel-0.3.96-5 Some upgrade reminders: 1. A new version of Oracle (10g) will be installed. Oracle will be installed in the /opt/aptare/oracle directory and the oracle application will now run as UNIX user aptare rather than oracle. 2. The agents on your master servers will need to download the latest aptare.jar file from the portal

Performing the Upgrade

Enable logging via the Unix script command or via any logging capabilities of your terminal emulation software to capture upgrade session output. This can be helpful later when troubleshooting any upgrade issues. 1. Export the contents of your current Oracle database: Locate a file system with approx 1-5GB of free space. Space required will depend on the size of your database. Make a directory in this file system called database_backup. Update the FILE parameter in the file /tmp/5103_upgrade/export_scdb.par with the pathname to the file system you identified and make sure the oracle user has permission to write to the database_backup directory. Update the FILE parameter in the file /tmp/import_scdb.par with the same value. su oracle exp parfile=/tmp/5103_upgrade/export_scdb.par ENSURE THE EXPORT COMPLETES WITH NO ERRORS 2. Shutdown APTARE StorageConsole: su - root /opt/aptare/bin/aptare stop 3. Make a backup copy of the current 5.0.x install directory: cp -pr /opt/aptare /opt/aptare_50 4. Mount the product CD in your portal server CD-ROM drive: 5. Install the updated front end Web Portal components such as the new JDK and XML reporter module: cd /
Prepared by: APTARE, Inc. Use pursuant to company instructions Page 2 of 8 Modified on: 4/10/2006 1:37:00 PM ALL RIGHTS RESERVED Copyright 2003 - 2006 APTARE, Inc. NOTICE OF OWNERSHIP: THIS DOCUMENT IS THE EXCLUSIVE PROPERTY OF APTARE, INC.

APTARE StorageConsole 5.0.1x to 5.1.03 Upgrade Notes for UNIX

/tmp/5103_upgrade/aptareInstaller.sh When prompted for the location of the CD, enter the path to the mounted CD. e.g. (/mnt/cdrom) Please ensure that the CD labelled "StorageConsole Portal Software" is mounted. Hit return to continue Unable to find CD. Where is it mounted? (currently /tmp/5103_upgrade) /mnt/cdrom Follow other prompts for information as required. 6. Install the new Oracle 10g binaries: <path_to_cdrom>/install_oracle.sh 7. Re-create the Oracle database in the 10g format : NOTE: THIS STEP WILL DESTROY YOUR EXISTING DATABASE. PLEASE ENSURE YOU HAVE A BACKUP COPY OF THE DATABASE AS WELL AS AN ERROR FREE EXPORT FROM STEP 1 BEFORE CONTINUING. su - aptare /tmp/5103_upgrade/create_aptare_database.sh Follow the prompts as required. 8. Create the queue structures cd /opt/aptare/database/setup sqlplus portal/portal_password @setup_notify_queues.plb quit 9. Import the data from the database export into the new 10g database: imp parfile=/tmp/5103_upgrade/import_scdb.par The import process will generate some warnings toward the end regarding message queues. These can be ignored. Please verify that the import succeeded with only warnings and no errors. For an example of a successful import, see Appendix A at the end of this document. 10. Upgrade the database to the 5.1.03 format: cd /opt/aptare/database/upgrade_scripts cp /tmp/5103_upgrade/release_5103.plb . sqlplus portal/portal_password @release_5103.plb quit Verify there are no errors during the execution of the script 11. Re-compile and validate the stored procedures: cd /opt/aptare/database/setup sqlplus portal/portal_password @base_pkg.plb @nbu_pkg.plb @../tools/validate_sp
Prepared by: APTARE, Inc. Use pursuant to company instructions Page 3 of 8 Modified on: 4/10/2006 1:37:00 PM ALL RIGHTS RESERVED Copyright 2003 - 2006 APTARE, Inc. NOTICE OF OWNERSHIP: THIS DOCUMENT IS THE EXCLUSIVE PROPERTY OF APTARE, INC.

APTARE StorageConsole 5.0.1x to 5.1.03 Upgrade Notes for UNIX

exit; 12. Change ownership permissions on the database log files: su root chown aptare:dba /tmp/scon.* 13. Re-start APTARE StorageConsole components su root /opt/aptare/bin/aptare restart 14. Convert the ldap passwords : /opt/aptare/utils/encryptPassword.sh all 15. Login and test the portal application 16. Under guidance from APTARE support, re-apply any customizations made to the previous 5.0.x to the 5.1 environment (e.g. custom reports, multiple tomcat agents, increased memory settings etc.) The 5.0.x settings can be found in the /opt/aptare_50 directory. In particular you may want to check the following files: /opt/aptare/bin/aptare /opt/aptare/oracle/dbs/initscdb.ora
3

This step is not required if you were previously live and running on version 5.0.14 or greater.

Prepared by: APTARE, Inc. Use pursuant to company instructions Page 4 of 8 Modified on: 4/10/2006 1:37:00 PM ALL RIGHTS RESERVED Copyright 2003 - 2006 APTARE, Inc. NOTICE OF OWNERSHIP: THIS DOCUMENT IS THE EXCLUSIVE PROPERTY OF APTARE, INC.

APTARE StorageConsole 5.0.1x to 5.1.03 Upgrade Notes for UNIX

Upgrading the agent on the master servers

Edit the file /opt/aptare/datarcvrconf/reload.conf. Ensure there is an entry in this file for each of your master servers. Update each entry as follows:

<master_server_name>=<YYYYMMDD> For Example: APTARE-SUN1=20060130

This will trigger the agent on the master server to automatically download the latest aptare.jar file and restart itself. After a couple of hours, you should check the agent status via the Command Center Dashboard report in the Portal Web GUI and ensure the status of each agent is green.

Prepared by: APTARE, Inc. Use pursuant to company instructions Page 5 of 8 Modified on: 4/10/2006 1:37:00 PM ALL RIGHTS RESERVED Copyright 2003 - 2006 APTARE, Inc. NOTICE OF OWNERSHIP: THIS DOCUMENT IS THE EXCLUSIVE PROPERTY OF APTARE, INC.

APTARE StorageConsole 5.0.1x to 5.1.03 Upgrade Notes for UNIX

APPENDIX A
An example of a successful import follows. The warnings in bold can be ignored. If you receive any other warnings or errors, please contact APTARE customer support.
-bash-2.05b$ imp parfile=/tmp/import_scdb.par Import: Release 10.2.0.1.0 - Production on Wed Apr 5 16:26:47 2006 Copyright (c) 1982, 2005, Oracle. All rights reserved.

Connected to: Oracle Database 10g Release 10.2.0.1.0 - Production Export file created by EXPORT:V09.02.00 via conventional path import done in US7ASCII character set and UTF8 NCHAR character set import server uses UTF8 character set (possible charset conversion) . importing PORTAL's objects into PORTAL . . importing table "APT_CLIENT_FILE" 0 rows imported . . importing table "APT_CLIENT_PRODUCT" 0 rows imported . . importing table "APT_COLLECTOR_PROPERTIES" 0 rows imported . . importing table "APT_DISCOVERY_CURRENT_RUN" 1 rows imported . . importing table "APT_DISCOVERY_DEVICE" 0 rows imported . . importing table "APT_DISCOVERY_EXCL_POLICY" 0 rows imported . . importing table "APT_DISCOVERY_FILESYS" 0 rows imported . . importing table "APT_DISCOVERY_FILESYS_COVERAGE" 0 rows imported . . importing table "APT_DISCOVERY_FILESYS_LOG" 0 rows imported . . importing table "APT_DISCOVERY_INCL_POLICY" 0 rows imported . . importing table "APT_DISCOVERY_POLICY" 0 rows imported . . importing table "APT_DISCOVERY_PROPERTIES" 1 rows imported . . importing table "APT_EXPIRATION_POLICY" 13 rows imported . . importing table "APT_JOB" 0 rows imported . . importing table "APT_JOB_FILE" 0 rows imported . . importing table "APT_JOB_MESSAGE_LOG" 0 rows imported . . importing table "APT_JOB_TAPE_MEDIA" 0 rows imported . . importing table "APT_LAST_CLIENT_JOB" 0 rows imported . . importing table "APT_LAST_NBU_BACKUP" 0 rows imported . . importing table "APT_MODULE" 1 rows imported . . importing table "APT_NBU_JOB" 0 rows imported . . importing table "APT_NBU_JOB_DISK_MEDIA" 0 rows imported . . importing table "APT_NBU_JOB_FILE" 0 rows imported . . importing table "APT_NBU_JOB_STATE" 0 rows imported . . importing table "APT_NBU_JOB_TAPE_MEDIA" 0 rows imported . . importing table "APT_NBU_JOB_TRY" 0 rows imported . . importing table "APT_NBU_LAST_DISK_STAGING" 0 rows imported . . importing table "APT_NBU_RESTORE_BACKUP_JOB" 0 rows imported . . importing table "APT_NBU_RESTORE_JOB" 0 rows imported . . importing table "APT_NBU_TAPE_DRIVE" 0 rows imported . . importing table "APT_NBU_TAPE_LIBRARY" 0 rows imported . . importing table "APT_NBU_TAPE_MEDIA" 0 rows imported . . importing table "APT_NOTE" 0 rows imported . . importing table "APT_PRODUCT_MESSAGE" 91 rows imported . . importing table "APT_RESTORE_LOG" 0 rows imported . . importing table "APT_RESTORE_REQUEST" 0 rows imported . . importing table "APT_SCRATCH_TAPE_LOG" 0 rows imported . . importing table "APT_SKIPPED_BACKUP_FILE" 0 rows imported . . importing table "APT_TAPE_DRIVE" 0 rows imported . . importing table "APT_TAPE_DRIVE_LOG" 0 rows imported . . importing table "APT_TAPE_LIBRARY" 0 rows imported . . importing table "APT_TAPE_MEDIA" 0 rows imported . . importing table "APT_TIMEZONE" 561 rows imported . . importing table "APT_TOP_JOB_FILE" 0 rows imported . . importing table "PTL_AGENT_STATUS" 0 rows imported . . importing table "PTL_BACKUP_CYCLE" 7 rows imported . . importing table "PTL_BACKUP_POLICY" 0 rows imported . . importing table "PTL_BILLING_POLICY" 0 rows imported . . importing table "PTL_DEVICE_MEDIA_SERVER" 0 rows imported Prepared by: APTARE, Inc. Use pursuant to company instructions Page 6 of 8 Modified on: 4/10/2006 1:37:00 PM ALL RIGHTS RESERVED Copyright 2003 - 2006 APTARE, Inc. NOTICE OF OWNERSHIP: THIS DOCUMENT IS THE EXCLUSIVE PROPERTY OF APTARE, INC.

APTARE StorageConsole 5.0.1x to 5.1.03 Upgrade Notes for UNIX

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . importing importing importing importing importing importing importing importing importing importing importing importing importing importing importing importing importing importing importing importing importing importing table table table table table table table table table table table table table table table table table table table table table table "PTL_DURATION_SLA_POLICY" "PTL_ENUM" "PTL_ENUM_MEMBER" "PTL_GROUP" "PTL_GROUP_MEMBER" "PTL_GROUP_PARAMETER" "PTL_GROUP_POLICY" "PTL_HOMEPAGE_SETTING" "PTL_INDEX_REBUILD" "PTL_MENU_ITEM" "PTL_NBU_CALENDAR_SCHED" "PTL_INCLUDE_DATES" "PTL_NBU_POLICY" "PTL_NBU_POLICY_CLIENT" "PTL_NBU_POLICY_FILE" "PTL_NBU_RETENTION_LEVEL" "PTL_NBU_SCHEDULE" "PTL_SCHEDULE_EXCLUDE_DATES" "PTL_NBU_SCHEDULE_COPY" "PTL_NBU_STORAGE_UNIT" "PTL_NBU_TAPE_CAPACITY" "PTL_NOTIFY_POLICY" 0 7 61 4 3 0 0 0 1 58 0 0 0 0 0 0 0 0 0 0 0 1 rows rows rows rows rows rows rows rows rows rows rows rows rows rows rows rows rows rows rows rows rows rows imported imported imported imported imported imported imported imported imported imported imported imported imported imported imported imported imported imported imported imported imported imported

IMP-00060: Warning: Skipping table "PORTAL"."PTL_NOTIFY_QUEUE_TABLE" because object type "SYS"."AQ$_JMS_USERPROPARRAY" does not exist or has different identifier
. . importing table . . importing table . . importing table "PTL_NOTIFY_REPORT_POLICY" "PTL_PIVOT" "PTL_REPORT_INSTANCE" 0 rows imported 501 rows imported 1 rows imported

IMP-00060: Warning: Skipping table "PORTAL"."PTL_REPORT_QUEUE_TABLE" because object type "SYS"."AQ$_JMS_USERPROPARRAY" does not exist or has different identifier
. . . . . . . . . . . . . . . . . . . . . . . . importing importing importing importing importing importing importing importing importing importing importing importing table table table table table table table table table table table table "PTL_SERVER" "PTL_SLA_GROUP_POLICY" "PTL_START_TIME_SLA_POLICY" "PTL_STORAGE_UNIT_GROUP" "PTL_SU_GROUP_MEMBER" "PTL_SYSTEM_PARAMETER" "PTL_SYSTEM_VERSION" "PTL_TAPE_MEDIA_INFO" "PTL_USER" "PTL_USER_PERM" "PTL_VOLUME_GROUP" "PTL_VOLUME_POOL" 0 0 0 0 0 0 1 22 2 0 0 0 rows rows rows rows rows rows rows rows rows rows rows rows imported imported imported imported imported imported imported imported imported imported imported imported

IMP-00017: following statement failed with ORACLE error 6502: "BEGIN " "SYS.DBMS_AQ_IMP_INTERNAL.IMPORT_QUEUE_TABLE('PTL_NOTIFY_QUEUE_TABLE',1,8,2," "0,0,'Queue table for Notification Policies');" "COMMIT; END;" IMP-00003: ORACLE error 6502 encountered ORA-06502: PL/SQL: numeric or value error: character string buffer too small ORA-06512: at "SYS.STANDARD", line 595 ORA-06512: at line 2 IMP-00017: following statement failed with ORACLE error 6502: "BEGIN " "SYS.DBMS_AQ_IMP_INTERNAL.IMPORT_QUEUE_TABLE('PTL_REPORT_QUEUE_TABLE',1,8,2," "0,0,'Queue table for Report Notification Policies');" "COMMIT; END;" IMP-00003: ORACLE error 6502 encountered ORA-06502: PL/SQL: numeric or value error: character string buffer too small ORA-06512: at "SYS.STANDARD", line 595 ORA-06512: at line 2
About to enable constraints... Import terminated successfully with warnings. -bash-2.05b$

Prepared by: APTARE, Inc. Use pursuant to company instructions Page 7 of 8 Modified on: 4/10/2006 1:37:00 PM ALL RIGHTS RESERVED Copyright 2003 - 2006 APTARE, Inc. NOTICE OF OWNERSHIP: THIS DOCUMENT IS THE EXCLUSIVE PROPERTY OF APTARE, INC.

APTARE StorageConsole 5.0.1x to 5.1.03 Upgrade Notes for UNIX

APPENDIX B
The following statements are for reference only. You can ignore these unless instructed otherwise by APTARE customer support. alter tablespace alter tablespace alter tablespace alter tablespace alter tablespace alter tablespace APTARE_TBS_DATA_1M APTARE_TBS_DATA_20M APTARE_TBS_DATA_200M APTARE_TBS_IDX_1M APTARE_TBS_IDX_10M APTARE_TBS_IDX_100M rename to tbs_data1; rename to tbs_data2; rename to tbs_event_file_data; rename to tbs_idx1; rename to tbs_idx2; rename to tbs_event_file_idx;

alter tablespace tbs_data1 alter tablespace tbs_data2 alter tablespace tbs_event_file_data alter tablespace tbs_idx1 alter tablespace tbs_idx2 alter tablespace tbs_event_file_idx

rename to APTARE_TBS_DATA_1M; rename to APTARE_TBS_DATA_20M; rename to APTARE_TBS_DATA_200M; rename to APTARE_TBS_IDX_1M; rename to APTARE_TBS_IDX_10M; rename to APTARE_TBS_IDX_100M;

Prepared by: APTARE, Inc. Use pursuant to company instructions Page 8 of 8 Modified on: 4/10/2006 1:37:00 PM ALL RIGHTS RESERVED Copyright 2003 - 2006 APTARE, Inc. NOTICE OF OWNERSHIP: THIS DOCUMENT IS THE EXCLUSIVE PROPERTY OF APTARE, INC.