In the particular case of a Dollar Universe Company upgrade from V5 32 bits to V6 64 bits, refer to section Upgrade 32-bit / 64-bit.
The upgrade of Dollar Universe, installed in a cluster on Windows, must be carried out in four phases:
Refer to the Dollar Universe Administration Guide for more details on Dollar Universe cluster architectures.
The installation dialog will display the following screens:
The first screen displayed is the welcome screen. No data entry is required.
The second screen displays the General Terms and Conditions of the User Software License Agreement.
The user can choose to install a new instance or upgrade an existing instance by selecting one of the options below:
"Install a new Dollar Universe instance". The next screen is the Installation Mode Selection
"Upgrade an existing Dollar Universe instance": upgrade from Dollar Universe Application Server V5.6 to V6 or V6 to V6 (i.e. the installation of cumulative patches). In the case of an upgrade:
The user must select the instance to be updated from the list to activate the Next button.
In the case of a V6 to V6 upgrade, the next screen asks if the user wants to do a full backup of the Company before the upgrade:
Click Yes to do the backup. In the directory targeted by the node setting UNI_AUTOUPD_BCK (UNI_DIR_ROOT\backup by default), the backup creates a folder named manual_upgrade_<COMPANY>_<NODE>_MM-DD-YYYY_HH_MM_SS, containing the backup file named full_backup_<COMPANY>_<NODE>_YYYYMMDD_HHMMSS.zip as well as two information files.
Or click No to continue the upgrade without doing a backup of the Company.
The next screen is the summary: refer to the section "Installation Summary".
Click Back to return to the License Agreement screen. Click Next to go forward. Click Cancel to quit the installation.
This screen proposes a choice between a typical (default) and a custom installation.
The typical installation will install with the following default values:
Click Back to return to the previous screen, or click Next to go forward to the next screen, or click Cancel to quit the installation
You must ensure that any firewall on the path to / from the DUAS is correctly configured to allow communication between the selected DUAS and UVMS ports.
For a "Typical" installation refer to section: Register to Univiewer Management Server".
This screen proposes a choice of three radio buttons.
Standard Installation
This selection installs Dollar Universe by modifying one or several default values.
Primary Cluster Installation
Refer to the Dollar Universe Administration Guide for more detailed discussion of Dollar Universe Cluster Architectures.
In an Active-Passive cluster only one node is active.
On the active node, a full Dollar Universe instance is installed on a shared disk. Binary directory however must be directed to a local disk.
Binaries must be on a local disk since Windows does not allow Windows Services to be created for binaries which are not stored locally.
Primary Cluster Installation sets the variable UNI_INST_CLUSTER to PRIMARY in the local settings (values.xml) to indicate the installation is of type cluster. This variable is displayed for information only and must not be changed.
Secondary Cluster Installation
Refer to the Dollar Universe Administration Guide for more detailed discussion of Dollar Universe Cluster Architectures.
In an Active-Passive cluster only one node is active.
A secondary installation verifies that the values.xml file is of the cluster installation type. It does not modify this file.
A data-less Dollar Universe instance is installed. Dollar Universe Settings and binaries will be installed locally.
The notion of Secondary Cluster Installation allows you to install the necessary elements of Dollar Universe without having to switch the shared disk back and forth.
Click Back to return to the previous screen. Click Next to go forward to the next screen. Click Cancel to quit the installation.
This screen appears only if Secondary Cluster Installation was requested on the Custom Mode Selection screen.
Key in the access path to the values.xml file.
Secondary Cluster Node installation requires access to the values.xml file which contains the instance settings. Values.xml is stored in the \data sub-directory normally located on the shared disk. If the shared disk is not currently accessible from the secondary node, it will be necessary to copy the values.xml from the primary cluster node to a work directory (e.g. C:\temp) on the secondary node, key in C:\temp\values.xml for example.
The copy is only necessary for the duration of the secondary node installation and can be deleted afterwards.
Click Back to return to the previous screen. Click Next to go forward to the “Installation Summary” screen. Click Cancel to quit the installation.
This screen is common to all installations.
Register with Univiewer Management Server now
Check Yes or No.
Details of the Dollar Universe Application Server V6 installation must be registered on the Univiewer Management Server. The DUAS will then be added to the Univiewer Node List and connection status will be displayed. This avoids both manual declaration and bulk import of Dollar Universe nodes to the UVMS Nodes List.
You must ensure that the firewall on the DUAS path is properly configured to allow communication between the selected ports of DUAS and UVMS.
Changes to Univiewer Management Server Node List, logins and roles will be distributed to known Dollar Universe Application Servers via the synchronization engine.
If the Univiewer Management Server is reachable check: Yes. If it is not reachable, registration should be carried out later using the unims –register command. Refer to section: Register Manually to UVMS.
When Dollar Universe V6 is installed in upgrade mode, the V6 node is registered to UVMS with the information in the mgr\uxsrsrv.sck file of the V5 node.
Server Hostname
Enter the Host name of the Univiewer Management Server. The name must comply with RFC 952.
Server Port
Enter the TCP Port number used by the Univiewer Management Server. The port number was specified during installation of the Univiewer Management Server, it is by default 4184.
Login Name
This is the administrator login specified during installation of the Univiewer Management Server.
Password
This is the administrator login password specified during installation of the Univiewer Management Server.
Click Back to return to the previous screen. Click Cancel to quit the installation. Click Next to go forward to the DUAS Instance Definition screen: connection to the UVMS will be verified with the values entered and an error message will be displayed if any of the values prove to be incorrect.
Company Name
Enter the name of the Company to install. This code must be exactly 6 uppercase characters. The default is UNIV67. The authorized characters are A to Z, 0-9 and “_”.
In a network configuration, all Dollar Universe instances should use the same Company Name, failing which they will not be able to communicate with each other.
Node Name
Enter the Dollar Universe Node Name (maximum 64 alphanumeric characters). The authorized characters are A to Z, 0-9, _ (underscore) and – (dash). Space characters and all other characters are forbidden.
Several instances of the same Company may be installed on the same host; they must use different Node Names.
Click on Validate. At this point a request is sent to the Univiewer Management Server which checks Univiewer Management Server registration requirements:
If any of the above cannot be verified, an error message will be displayed indicating the source of the failure. You may either correct the problem and move forward or cancel the installation.
By default, the Dollar Universe Application Server directory tree will be created in
C:\Program Files\AUTOMIC\DUAS\<COMPANY>_<NODE>
DUAS can be installed on a path containing the space character.
If you wish to install the product elsewhere either enter the path to the directory or click Browse… to point to an alternative installation directory in the file system.
The directory entered will replace the entire default path, so if for example you enter:
D:\UNIV65
The directory specified must be nonexistent or empty.
The procedure will create:
D:\UNIV65
D:\UNIV65\bin
D:\UNIV65\data
D:\UNIV65\log
In a custom installation, the product binaries could be directed elsewhere, by default:
C:\Program Files\AUTOMIC\DUAS\<COMPANY>_<NODE>\bin
Click Back to return to the Univiewer Management Server Declaration screen. Click Cancel to quit the installation. Click Next:
The root directory entered above must be empty or nonexistent. If this is not the case, an error message is displayed.
Dollar Universe V6 Managers are integrated with Dollar Universe. Some of them can be installed and activated or deleted during installation.
Usage of Manager for SAP Solutions
For the activation of Dollar Universe V6 Manager for SAP Solutions, the user can enter the name of the directory containing the uxjcs.ini configuration file, and it will be immediately taken into account. If this directory is not entered, it can be using the Univiewer Console.
Prerequisites must be met to install or upgrade Dollar Universe Manager for SAP Solutions; please refer to section "Software".
Usage of ODB, EJB, JMS, WSC Managers (Activation of Java Service)
For the activation of the Java service, the user can enter the path of the folder of a valid JRE/JDK service, and it will be immediately taken into account.
Dollar Universe reserves 19 consecutive TCP port numbers. The default range starts at 10600 (base port number) and is attributed as shown in the table below:
|
Espace |
IO |
EEP |
BVS |
SAP | OAPP (UNIX) |
CDJ |
DQM |
JEE |
GSI |
|---|---|---|---|---|---|---|---|---|---|
|
X |
10600 |
10604 |
10605 |
10609 | 10610 |
10611 |
10615 |
10616 |
16018 |
|
S |
10601 |
|
10606 |
10612 |
|
|
|||
|
I |
10602 |
|
10607 |
10613 |
|
|
|||
|
A |
10603 |
|
10608 |
10614 |
|
|
In a typical installation only the Production Area (X) is enabled, in this case only ports 10600, 10604, 10605, 10611, 10615 and 10618 are actually used.
If the sequence 10600 to 10618 is unavailable, click the Custom Value radio button and enter an alternative base port number (with the 19 free consecutive TCP port numbers).
It is no longer required that nodes within the same Company share the same TCP port sequence to be able to communicate. Node information is maintained centrally on the UVMS and regularly synchronized across all Dollar Universe Application Servers. Refer to the Dollar Universe Administration Guide for more details about synchronization.
The system local host name will be displayed here by default. There is normally no need to change this with the exception of logical hosts in a cluster attached to floating IP addresses. The name must comply with RFC 952.
Node tags are free text identifiers that characterize a node. If you specify a tag that is included in a Node View, the DUAS being installed will be dynamically included in the corresponding Node View for operations monitoring.
In a Typical installation, only the Production Area is enabled. If additional Areas are required, a custom installation is necessary. Check the additional Areas that you want to enable.
Areas can be enabled after installation with the unims command, refer to section "Update".
Click Back to return to the previous screen. Click Next to go to the next screen. Click Cancel to stop the installation.
Installation Directories
Binary directory sharing is not available on Windows platforms. The binary directory should only be redirected (to a local disk) in the case of a Primary Cluster installation.
Click Browse to select an empty or nonexistent directory on a local disk. The "\bin" sub-directory will be created by the installation program.
The log directory should only be redirected (to a local disk) in the case of a Primary Cluster installation.
Click Browse to select an empty or nonexistent directory on a local disk. The "\log" sub-directory will be created by the installation program.
Click Back to return to the previous screen (when possible). Click Next to go forward to the next screen. Click Cancel to quit the installation.
The installation / upgrade summary resumes all the parameters entered during the installation dialog or recovered in the existing instance in the case of an update:
Click Back to return to the previous screen. Click Cancel to quit the installation. Click Install> to start the installation.
In case of an upgrade only: If the user clicks the Cancel button while the update is running. This will abort the upgrade procedure and a manual restoration of a previous backup will be needed in order to restore the DUAS node.
Installation finishes with the message "Setup is completed". Click OK to close the dialog box.
An upgrade of V5 to V6 ends with the message: "DUAS instance <COMPANY> <NODE> V6 has been installed successfully. It is partially started and ready for data upgrade."
At this point, the upgrade of V5 to V6 has not completed, there are other required steps: security import, design and production data import, validation. It is recommended to refer to the Dollar Universe Upgrade Guide for the complete description of the version 5 to version 6 upgrade.
As of version 6.10.41, documentation new updates are posted on the Broadcom Techdocs Portal.
Look for Dollar Universe.