1. REST API for Server Manager Guide
  2. changecomponent64 (Release 9.2.4)

changecomponent64 (Release 9.2.4)

API Name

changecomponent64

Description

Updates the managed instance component to a new version for 64-bit. Used for all types of component change with additional parameters for the Deployment Server and the Enterprise Server.

REST Methods

POST

Precondition

Agent must be running.

Input Params

instanceName, componentName, foundationOption, jrePath, sysDBUsername, sysDBPassword, release. Note (Release 9.2.4.3): Add these additional parameters if there are duplicate instance names: agentHostName, jdeHome.

Parameters

instanceName: Name of the instance such as <machine name>_DEP or <machine name>_ENT.

componentName: Name of the .jar file used to change the component.

foundationOption: Required for the Deployment Server component change only.

Value: 0 - No MultiFoundation, component change only.

Update the system and OneWorld Client install with the contents in the .jar file.

1 - Component change and back up current system for MultiFoundation

Back up the current system and OneWorld client install in a version directory and update the system and OneWorld client install from the contents in the .jar file. Update the package build tables.

2 - Component download for MultiFoundation only

Create a version directory and copy the contents of the .jar file to the version directory to create the multi-foundation directory. Update the package build tables.

jrePath: Path to the jre location; leave blank if bitness is the same. Use only with the Deployment Server or Enterprise Server when changing the component to a different bitness such as changing from a 32-bit system to a 64-bit system. Also, use with the Deployment Server if foundationOption is set to '2' and system is 64-bit.

sysDBUsername: User name to the SYSTEM Datasource database. Required for the Deployment Server component change only and when foundationOption is set to 1' or '2'.

sysDBPassword: User password to the SYSTEM Datasourse database. Required for the Deployment Server component change only and when foundationOption is set to 1' or '2'. release: Release of the deployment server environment such as E920 or E910.

Sample Request

{ "componentName":"9.2.3.0.Release64.DS.Win64_09-13-2018_07_48.jar", "instanceName":"jdedeploy", "foundationOption":"1", "jrePath":"C:\\Program Files\\Java\\jre1.8.0_181", "sysDBUsername":"SY920", "sysDBPassword":"password", "release":"E920"} https:// jdesmc.example.com:8998/manage/mgmtrestservice/changecomponent64

This is the sample request if you have multiple instance names: { "componentName":"9.2.3.0.Release64.DS.Win64_09-13-2018_07_48.jar", "instanceName":"jdedeploy", "foundationOption":"1", "jrePath":"C:\\Program Files\\Java\\jre1.8.0_181", "sysDBUsername":"SY920", "sysDBPassword":"password", "release":"E920", "agentHostName":"jdesma.example.com", "jdeHome":"/slot/oracle/jde_agent_jas/SCFHA"}https:// jdesmc.example.com:8998/manage/mgmtrestservice/changecomponent64

Return

HTTP status 200 is returned.

Sample Response

Exception

Throws an exception if the change component operation fails for any reason.