Upgrading an Instance from FMW 11.1.1.7 to FMW 11.1.1.9
To facilitate safe migration of your current instance to FMW 11.1.1.7-based binaries, use the upgrade-service-instance CLI command.
Note:
upgrade-service-instance replaces jrf-migrate-to-ps7 introduced in JCS-SaaS Extension version 17.2.3. While the former command will still work, we recommend that you use the new commands going forward and reserve the former commands only for when you need to ensure backward compatibility.
Using the Command
Note:
This command only works with instances created with JCS-SaaS Extension 16.4.1 and earlier../javacloud -user userName -id identityDomain -si serviceInstance -upgrade-service-instance| Parameter (Alias) | Description |
|---|---|
user (-u)
|
The name used to authenticate the user. |
identitydomain (-id)
|
The name of the identity domain in which the service instance exists. |
serviceinstance (-si)
|
The name of the service instance you want to migrate. |
Note:
For a list of optional parameters:-
Navigate to the
$SDK_HOME/doc/index.htmlfile (whereSDK_HOMEis the directory containing your JCS - SaaS Extension installation) or go to the SDK documentation via the “Welcome App”. -
Click CLI-Javacloud.jar.
-
In the command list, search for
jrf-migrate-to-ps7and click it to retrieve details about the command.
For example:
$ ./javacloud -dc em2 -user joe.user@myco.com -id migration1234 -si migrationinst1234 -upgrade-service-instanceHow Migration Works
Note:
If you have an FMW 11.1.1.7-based instance and have deployed ADF-based applications, your applications are working with ADF 11.1.1.7. In this case, before migrating to FMW 11.1.1.9, you must ensure that your ADF-based applications work with the ADF 11.1.1.9 (FMW 11.1.1.9) in a local Weblogic environment.upgrade-service-instance switches the instance to work with FMW 11.1.1.9 binaries, restarts the domain to let the change take effect, sets the configuration required to migrate the OWSM component and then restarts the domain again.
Migration Use Case
This use case demonstrates a typical instance migration from FMW 11.1.1.7 to FMW 11.1.1.9.
-
First, we'll use
list-configto verify that the instance we plan to migrate is in FMW 11.1.1.7; that is, uses JRF 11.1.1.7.0:
The system responds:$ ./javacloud.jar -dc em2 -user joe.user@myco.com -id migration1234 -si migrationinst1234 -list-config -sv -v -search jrf
Note that the Value is 11.1.1.7.0, indicating the JRF version is FMW 11.1.1.7.#==================================================================================================================================================================================# | Listing one Simple Config | | [Identity Domain=migrationtestid9, Service Instance=migrationtestsi9] | #=#=========================#==========#========#=======#========#================================================================================================#==========#=====# | | | | Value |Value |Restart | | | | |#| Name |Value Type|Readable|Writabl|Required| Description | Value |Label| | | | | | e | | | | | |=|=========================|==========|========|=======|========|================================================================================================|==========|=====| | | | | | | |It shows the current version of JRF which the instance is using. The possible values for this | | | |1|oracle.common.jrf.version|STRING | Y | | |config property are: (11.1.1.7.0,11.1.1.9.0). |11.1.1.7.0| | | | | | | | | | | | +-+-------------------------+----------+--------+-------+--------+------------------------------------------------------------------------------------------------+----------+-----+ -
Next, migrate the instance:
The system responds:$ ./javacloud -dc em2 -user joe.user@myco.com -id migration1234 -si migrationinst1234 -upgrade-service-instance1:Job Id - 9513 ----------- - ----------------------- -> - Properties ------------ - ----------------------- Status - NEW Identity Domain - migrationtestid9 Service Instance - migrationtestsi9 Application - Start Time - Wednesday, March 29, 2017 11:48:40 PM PDT Operation - Migrate JRF to PS7 ------------- - ----------------------- [TIP] - You can use the command "job-status" to monitor a job. -
You can see that the process returned a Job ID (9513). We'll use this number with
-list-job-logs -jobidto check see which logs have been completed for this migration. These logs are useful in tracking the activity within the process:
The system responds with this list of the three job logs produced for this migration:$ ./javacloud -dc em2 -user joe.user@myco.com -id migration1234 -si migrationinst1234 -list-job-logs -jobid 9513#========================================================================# | Listing 3 job(id=9513) logs | #=#===========================#=============================#============# |#| Log Name | Last Updated Description |Content Type| |=|===========================|=============================|============| |1|validate-instance-migration|14 minutes and 38 seconds ago|text/plain | |-+---------------------------+-----------------------------+------------| |2|switch-oracle-home-to-ps7 |14 minutes and 31 seconds ago|text/plain | |-+---------------------------+-----------------------------+------------| |3|exec-migration-script |7 minutes and 30 seconds ago |text/plain | +-+---------------------------+-----------------------------+------------+Note:
These are the only job logs produced for a migration operation. -
Next, we'll run
list-configagain to verify that the migration has completed and the instance is using JRF 11.1.1.9.0:
The system responds:$ ./javacloud -dc em2 -user joe.user@myco.com -id migration1234 -si migrationinst1234 -list-config -sv -v -search jrf
Note that the Value is 11.1.1.9.0, indicating the migration to FMW 11.1.1.9 is successful.#==================================================================================================================================================================================# | Listing one Simple Config | | [Identity Domain=migrationtestid9, Service Instance=migrationtestsi9] | #=#=========================#==========#========#=======#========#================================================================================================#==========#=====# | | | | Value |Value |Restart | | | | |#| Name |Value Type|Readable|Writabl|Required| Description | Value |Label| | | | | | e | | | | | |=|=========================|==========|========|=======|========|================================================================================================|==========|=====| | | | | | | |It shows the current version of JRF which the instance is using. The possible values for this | | | |1|oracle.common.jrf.version|STRING | Y | | |config property are: (11.1.1.7.0,11.1.1.9.0). |11.1.1.9.0| | | | | | | | | | | | +-+-------------------------+----------+--------+-------+--------+------------------------------------------------------------------------------------------------+----------+-----+ -
Finally, we'll open the configuration shell and use the
list-token-issuer-trustcommand to verify that the list of trusted token issuers hasn’t changed, thus indicating that migration was successful:
The system responds:$ ./javacloud.jar -dc em2 -user joe.user@myco.com -id migration1234 -si migrationinst1234 -config-shell
Then, enter the[INFO] - Java Cloud Service - SaaS Extension config shell. Initializing ... Please exit and re-enter the shell if the prompt does not appear within a few seconds. You can type "exit" to exit the shell.list-token-issuer-trustcommand:
The system responds:Config-shell:>list-token-issuer-trustList of trusted issuers for this type: migrationtestid9 List of trusted key(s) for this issuer: Key Identifier : cn=migration1234_javasvc,dc=#1605636c6f7564,dc=#16066f7261636c65,dc=#1603636f6d Key Type : x509certificate Value Type : dn Key Identifier : cn=cloud9ca-2,dc=#1605636c6f7564,dc=#16066f7261636c65,dc=#1603636f6d Key Type : x509certificate Value Type : dn Key Identifier : cn=migration1234_idm,dc=#1605636c6f7564,dc=#16066f7261636c65,dc=#1603636f6d Key Type : x509certificate Value Type : dn www.oracle.com List of trusted key(s) for this issuer: Key Identifier : cn=migration1234_javasvc,dc=#1605636c6f7564,dc=#16066f7261636c65,dc=#1603636f6d Key Type : x509certificate Value Type : dn Key Identifier : cn=cloud9ca-2,dc=#1605636c6f7564,dc=#16066f7261636c65,dc=#1603636f6d Key Type : x509certificate Value Type : dn Key Identifier : cn=migration1234_idm,dc=#1605636c6f7564,dc=#16066f7261636c65,dc=#1603636f6d Key Type : x509certificate Value Type : dn