Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Deployment and Upgrade : Upgrading TIBCO ActiveMatrix Runtime UDDI Server

Upgrading TIBCO ActiveMatrix Runtime UDDI Server
If you have installed TIBCO ActiveMatrix Runtime UDDI Server 3.0.0 on your computer, you may need to upgrade it to version 3.1.0.
Apache-ant-1.7.1 must be pre-installed and set into the system path if you want to use Ant-based commands to upgrade TIBCO ActiveMatrix Runtime UDDI Server.
If you want to upgrade TIBCO ActiveMatrix Runtime UDDI Server from 1.0.0 to 3.1.0, you need to upgrade it from 1.0.0 to 3.0.0 first.
If you do not want to keep the configuration in the version 3.0.0, you can run one of the following commands to configure TIBCO ActiveMatrix Runtime UDDI Server version 3.1.0:
run ant -f srvconfig.xml in the TIBCO_HOME/RuntimeUDDIServer/3.1/scripts/server directory,
or
Run srvconfig in the TIBCO_HOME/RuntimeUDDIServer/3.1/bin directory to configure TIBCO ActiveMatrix Runtime UDDI Server.
For detailed information about how to configure TIBCO ActiveMatrix Runtime UDDI Server, refer to Chapter 2, Configuring TIBCO ActiveMatrix Runtime UDDI Server.
During the configuration, you need to answer the question below:
Would you like to automatically create database tables when deploying the .war file?
Choose Yes to upgrade your existing 3.0.0 database automatically after the TIBCO ActiveMatrix Runtime UDDI Server is deployed.
Choose No to upgrade your existing 3.0.0 database manually after the TIBCO ActiveMatrix Runtime UDDI Server is deployed. For detailed information about how to manually upgrade the database, refer to Manually Upgrading the Database.
If you want to keep the configuration of the version 3.0.0, run one of the following commands 3.0.0 using the silent mode first,
In the TIBCO_HOME/RuntimeUDDIServer/3.1/bin directory, run
srvconfig -Dinput_war_folder=TIBCO_HOME/RuntimeUDDIServer/3.0/war/dist/yourWebContainer/yourDatabase -Ddefault.schema=XXX
or
In the TIBCO_HOME/RuntimeUDDIServer/3.1/scripts/server directory, run
ant -f srvconfig.xml -Dinput_war_folder=TIBCO_HOME/RuntimeUDDIServer/3.0/war/dist/yourWebContainer/yourDatabase -Ddefault.schema=XXX
The input_war_folder attribute indicates the location for 3.0.0 uddi/uddisc war files.
The default.schema attribute indicates the schema that is used for the database.
In version 3.0.0, if you have configured the product name and the product logo for Administration Console and Service Console using the .gif and uibranding.properties files, do not rename or move these files.
Then upgrade the databases used for version 3.0.0.
If you created the database tables automatically during the version 3.0.0 uddi.war file configuration, the database will upgrade automatically after the version 3.1.0 uddi.war file is deployed.
If you created the database tables manually during the version 3.0.0 uddi.war file configuration, you must manually upgrade the database. For detailed information about how to manually upgrade the database, refer to Manually Upgrading the Database.
Upgrading Database
To upgrade the database used in TIBCO ActiveMatrix Runtime UDDI Server 3.1.0, choose one of the following methods:
*E
3.
Check the allow nulls by default checkbox under the Options tab.
Automatically Upgrading the Database
In the Configuring the UDDI Server in the Interactive Mode section, you can choose to create database tables automatically.
While deploying TIBCO ActiveMatrix Runtime UDDI Server, the database tables will be automatically upgraded.
Manually Upgrading the Database
In the Configuring the UDDI Server in the Interactive Mode section, you can choose to create database tables manually.
After configuring the uddi.war file, you will find the upgrade.sql file in TIBCO_HOME/RuntimeUDDIServer/3.1/war/dist/CONTAINER_TYPE/
DATABASE_TYPE. Execute the upgrade.sql file before deployment.
The content in the upgrade.sql file may be different according to a specified database type.
For example, the content in the upgrade.sql file for MySQL is shown below:
Error Handling
If you have not successfully upgraded the database tables, you will get the following error message while running Ant-based tasks in the command line or accessing the Administration Console:
You are not allowed to log in. Please upgrade the database to version XXX.XXX (For example, version 001.002).

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved