Administering Oracle Visual Builder Classic (User-Managed) · 2019-09-17 · 2 Getting Started To...

Oracle® CloudAdministering Oracle Visual Builder Classic(User-Managed)

E89390-10September 2019

Oracle Cloud Administering Oracle Visual Builder Classic (User-Managed),

E89390-10

Copyright © 2018, 2019, Oracle and/or its affiliates. All rights reserved.

Primary Author: Oracle Corporation

This software and related documentation are provided under a license agreement containing restrictions onuse and disclosure and are protected by intellectual property laws. Except as expressly permitted in yourlicense agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify,license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means.Reverse engineering, disassembly, or decompilation of this software, unless required by law forinteroperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. Ifyou find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it onbehalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of theprograms, including any operating system, integrated software, any programs installed on the hardware,and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications.It is not developed or intended for use in any inherently dangerous applications, including applications thatmay create a risk of personal injury. If you use this software or hardware in dangerous applications, then youshall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure itssafe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of thissoftware or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks oftheir respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks areused under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron,the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced MicroDevices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products,and services from third parties. Oracle Corporation and its affiliates are not responsible for and expresslydisclaim all warranties of any kind with respect to third-party content, products, and services unless otherwiseset forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not beresponsible for any loss, costs, or damages incurred due to your access to or use of third-party content,products, or services, except as set forth in an applicable agreement between you and Oracle.

Contents

1 Preface

Audience 1-1

Related Resources 1-1

Conventions 1-1

2 Getting Started

Set Up Your Oracle Visual Builder 2-1

Supporting the Minimum Version of Oracle Visual Builder 2-1

3 Create Your Service Instance

Prerequisites for Provisioning Oracle Visual Builder 3-1

Obtain the REST Endpoint of Your Oracle Cloud Storage Instance 3-2

Provision an Oracle Database Cloud Service Instance 3-4

Create an Instance with the Provisioning Wizard 3-6

Create a Service Instance 3-7

Specify Service Instance Information 3-7

Specify the Database and Storage Details for the Instance 3-8

Confirm Your Selections 3-11

Create a Quick Start Instance with a Single Click 3-12

Create an Instance with the Oracle Cloud Stack Template 3-13

About the User Interfaces of the Oracle Visual Builder Console 3-16

Explore the Oracle Visual Builder Console 3-16

Explore the Oracle Visual Builder Console Instance Overview -18

Explore the Oracle Visual Builder Console Activity Page 3-23

Explore the Oracle Visual Builder Console SSH Access Page 3-24

4 Add Users and Assign Roles

Oracle Visual Builder Roles and Privileges 4-1

Add Users to a Cloud Account with IDCS 4-1

Add Users 4-1

iii

Assign Roles to Users 4-3

5 Administer a Customer-Managed Environment

Unsupported Tasks 5-2

Patch and Upgrade Your Environment 5-3

Typical Workflow for Patching an Oracle Visual Builder Instance 5-3

Explore the Patching Page 5-3

View Details of Approved Patches 5-4

Perform Patching Prechecks 5-5

Apply a Patch to an Oracle Visual Builder Instance 5-6

Roll Back a Patching Operation 5-6

Start and Stop Oracle Visual Builder Instances and Individual Nodes 5-7

About Stopping and Starting an Oracle Visual Builder Instance and IndividualVirtual Machines 5-7

Stop and Start an Oracle Visual Builder Instance 5-8

Stop, Start, and Restart an Individual Virtual Machine 5-9

Scale Out and Scale In an Oracle Visual Builder Instance 5-9

Overview of Scaling Tasks for an Oracle Visual Builder Instance 5-9

Scale Out an Oracle Visual Builder Cluster 5-10

Scale In an Oracle Visual Builder Cluster 5-11

View Scaling Requests 5-12

Reset the Database Password Before It Expires 5-12

Update the Database Schema Password 5-13

Back Up and Restore an Oracle Visual Builder Instance 5-13

About Backing up and Restoring Instances 5-14

Typical Workflow for Backing Up and Restoring an Instance 5-16

Explore the Backup Page 5-16

Configure Automated Backups for an Instance 5-21

Initiate an On-Demand Backup of an Instance 5-23

Delete a Backup 5-24

Disable and Enable Backups for an Instance 5-25

Restore an Oracle Visual Builder Instance from a Backup 5-25

Diagnose Problems 5-26

Use WebLogic Server Logs 5-27

Collect Database Statistics 5-27

6 Manage Instance Settings

Manage Applications in the Service Instance 6-1

Access Instance Settings 6-2

Configure Security Options for Applications 6-4

iv

Set Page Messages for Access Denied Errors 6-4

Allow Other Domains Access to Services 6-5

Add a Connection for Fusion Applications Services 6-6

Add a Connection to the Component Exchange 6-6

Manage Self-signed Certificates 6-8

v

1Preface

Describes tasks for administrators of Oracle Visual Builder.

AudienceAdministrator’s Guide for Oracle Visual Builder Cloud Service is intended foradministrators who will set up and configure the service.

Related ResourcesFor more information, see these Oracle resources:

• Oracle Public Cloud

http://cloud.oracle.com

• About Oracle Visual Builder in Developing Applications with Oracle Visual Builder

• About Oracle Cloud in Getting Started with Oracle Cloud

ConventionsThe following text conventions are used in this document:

Convention Meaning

boldface Boldface type indicates graphical user interface elements associatedwith an action, or terms defined in text or the glossary.

italic Italic type indicates book titles, emphasis, or placeholder variables forwhich you supply particular values.

monospace Monospace type indicates commands within a paragraph, URLs, codein examples, text that appears on the screen, or text that you enter.

1-1

http://cloud.oracle.com

2Getting Started

To set up an Oracle Visual Builder service, tasks such as managing subscriptions andservices, and creating service instances and user accounts need to be performed byusers with specific Oracle Cloud roles. A user can be assigned more than one role.

For example, if you are an Oracle Cloud service administrator you might not havesufficient privileges to upgrade a subscription, but sufficient privileges to provision aservice instance in an identity domain. If you are a Visual Builder administrator youmight not have sufficient privileges to provision a service instance, but sufficientprivileges to manage some of the administration tasks for a specific service instance.Create accounts for your users and assign them appropriate privileges and roles. See Oracle Cloud User Roles and Privileges in Getting Started with Oracle Cloud.

Topics

• Set Up Your Oracle Visual Builder

• Supporting the Minimum Version of Oracle Visual Builder

Set Up Your Oracle Visual BuilderHere are the steps for signing up for a Oracle Visual Builder promotion or subscriptionand creating a service instance:

1. Sign up for a free credit promotion or purchase a subscription. See Requestingand Managing Free Oracle Cloud Promotions or Buying an Oracle CloudSubscription in Getting Started with Oracle Cloud.

2. Sign in to Oracle Cloud and navigate to Oracle Visual Builder in the Oracle CloudInfrastructure Console. See Signing in to Your Cloud Account in Getting Startedwith Oracle Cloud.

3. Provision your service instance. See Create Your Service Instance.

If you choose to provision an instance with the provisioning wizard use you musthave active subscriptions to Oracle Database Cloud Service (Database as aService) and Oracle Cloud Infrastructure Object Storage Classic. You must alsohave created specific details in each service. For example, you must have createda container in Oracle Cloud Infrastructure Object Storage Classic. Be sure toreview the prerequisite steps in Prerequisites for Provisioning Oracle VisualBuilder before you create a service instance with the provisioning wizard.

4. Create accounts for your users and assign them appropriate privileges and roles.See Add Users and Assign Roles.

Supporting the Minimum Version of Oracle Visual BuilderOracle Visual Builder runs in a customer-managed environment and only providesmaintenance fixes on top of the latest software release. Therefore, when a softwareupgrade is available at the beginning of a month, it is your responsibility to manually

2-1

upgrade any existing Oracle Visual Builder instances to the latest release by applyingsoftware upgrade patches. If you are not on the latest release, you must patch yourinstance to be at the latest software release before you can apply any additionalmaintenance fixes. For example, if you provisioned Oracle Visual Builder 17.3.5, andthere have been several software upgrades since then, you must first upgrade to thelatest software release before you can apply any additional maintenance fixes.

This situation does not apply to newly provisioned instances. For Oracle Visual Builderinstances that are provisioned after the maintenance fixes are announced andavailable, they are automatically applied and available in the newly provisionedinstance. For information about applying patches from the Oracle Visual Builderconsole, see Patch and Upgrade Your Environment.

Chapter 2Supporting the Minimum Version of Oracle Visual Builder

2-2

3Create Your Service Instance

Topics:

• Prerequisites for Provisioning Oracle Visual Builder

• Create an Instance with the Provisioning Wizard

• Create a Quick Start Instance with a Single Click

• Create an Instance with the Oracle Cloud Stack Template

• About the User Interfaces of the Oracle Visual Builder Console

Prerequisites for Provisioning Oracle Visual BuilderYou must satisfy some prerequisites before provisioning Oracle Visual Builder.

There are two options for provisioning Oracle Visual Builder:

• Use the Oracle Cloud Stack templates — Enables you to complete a template thatautomatically provisions the required set of services together (Oracle VisualBuilder, Oracle Database Cloud Service, and Oracle Cloud Infrastructure ObjectStorage Classic). The prerequisite requirements listed below are satisfied duringthe process of provisioning an instance using stack templates. See Create anInstance with the Oracle Cloud Stack Template.

• Use the provisioning wizard — Provides a simple wizard in which to specify OracleDatabase Cloud Service, Oracle Cloud Infrastructure Object Storage Classic, andother details. You must satisfy the prerequisite requirements described belowbefore using the provisioning wizard.

The following prerequisites are required to provision Oracle Visual Builder.

3-1

Prerequisite Description For MoreInformation...

Provision an Oracle Cloud InfrastructureObject Storage Classic container.To create the container, you will be requiredto provide the URL of your Storage Cloudinstance when provisioning your OracleDatabase Cloud Service database instance.

An Oracle Cloud Infrastructure ObjectStorage Classic account name isautomatically created for you when youpurchase your universal credits. You mustcopy this name from within the StorageClassic tile of your Infrastructure Consolebefore provisioning Oracle Visual Builder.

You specify the name whenprovisioning Oracle Visual Builder with theprovisioning wizard or with the Oracle CloudStack templates.

You have two option for provisioningthe Oracle Cloud Infrastructure ObjectStorage Classic container:

• Automatically provision the OracleCloud Infrastructure Object StorageClassic container during Oracle VisualBuilder provisioning. You specifythe Oracle Cloud Infrastructure ObjectStorage Classic account name whenprompted in the Oracle Cloud Stacktemplates or provisioning wizard.

• Separately provision the Oracle CloudInfrastructure Object StorageClassic container beforeprovisioning Oracle Visual Builder. Inthis case, use the provisioning wizard tospecify the existing account and storagecontainer details.

See Oracle StorageCloud Service.

Provision Oracle Database Cloud Servicedatabase instance.You will be required to provide the details ofyour Oracle Database Cloud Servicedatabase instance when you provision yourOracle Visual Builder instance.

All Oracle Database Cloud Serviceconfigurations are possible.

Note: If you provision Oracle Visual Builderwith the Oracle Cloud Stack templates, anOracle Database Cloud Service databaseinstance is automatically created for you.

See Oracle DatabaseCloud Service.

Obtain the REST Endpoint of Your Oracle Cloud Storage InstanceIf you are using the provisioning wizard to provision your Oracle Visual Builderinstance, you must first provision an Oracle Cloud Infrastructure Object StorageClassic instance for the Cloud Storage container. After provisioning the Cloud Storageinstance you will need to know the REST endpoint for the instance when you provisionyour Oracle Database Cloud Service database instance.

An Oracle Cloud Infrastructure Object Storage Classic container and an OracleDatabase Cloud Service database instance are both required to use the Oracle VisualBuilder provisioning wizard. You will need to supply the REST endpoint of yourStorage Cloud instance when you provision your Oracle Database Cloud Service, andyou will need the details of your Oracle Database Cloud Service database instancewhen you provision your Oracle Visual Builder instance.

Chapter 3Prerequisites for Provisioning Oracle Visual Builder

3-2

https://cloud.oracle.com/storage

https://cloud.oracle.com/storage

https://cloud.oracle.com/database

https://cloud.oracle.com/database

Note:

If you are using Oracle Cloud Stack templates to provision your OracleVisual Builder instance, see Create an Instance with the Oracle Cloud StackTemplate.

You might want to customize the Dashboard in the Infrastructure Classic Console toinclude Oracle Cloud Infrastructure Object Storage Classic, Oracle Database CloudService and Oracle Visual Builder in your list of visible services.

Perform the following steps to obtain the REST endpoint after you create your OracleCloud Infrastructure Object Storage Classic instance:

1. Optional: If this is the first Oracle Cloud Infrastructure Object Storage Classicinstance you have created, click the menu for Storage Classic in your Dashboardand select Open Service Console.

The first time that you access the Storage Service Console you are prompted toset the georeplication policy for the service. You must set the policy to enable theREST endpoints for the service. After setting the policy it might take a few minutesfor all the REST endpoints in the service to become active.


3-3

You only need to set the policy once. After you set the policy you can return to theDashboard.

2. Click Storage Classic in the Dashboard to open the service Overview page.

3. In the Additional Information section of the Overview page, copy the full URL in theREST Endpoint field.

There are two REST endpoint fields. You want the URL for REST Endpoint field,not REST Endpoint (Permanent).

After you have copied the URL for the REST endpoint, you can use the provisioningwizard to create the Oracle Database Cloud Service database instance where you willsupply the REST endpoint as the location for the Cloud Storage Container for backupand recovery.

Provision an Oracle Database Cloud Service InstanceIf you are using the provisioning wizard to provision your Oracle Visual Builderinstance, you must first provision an Oracle Database Cloud Service instance.

An Oracle Cloud Infrastructure Object Storage Classic container and an OracleDatabase Cloud Service are both required to use the Oracle Visual Builderprovisioning wizard. You will need to supply the REST endpoint of your Storage Cloudcontainer to provision your Oracle Database Cloud Service, and you will need the


3-4

details of your Oracle Database Cloud Service to provision your Oracle Visual Builderinstance.

To create a Oracle Database Cloud Service instance:

1. Click Open Service Console in your Oracle Database Cloud Service Overviewpage.

The Instances tab in the Service Console displays a list of your databaseinstances and the resources allocated to them.

2. Click Create Instance in the Instances tab.

3. Supply the Instance Name in the Instance page of the provisioning wizard. ClickNext.

The other field in the Instance page should be populated automatically.


3-5

4. Enter the details in the Database Configuration section.

5. In the Backup and Recovery Configuration section, paste the REST endpoint URLthat you obtained from your Cloud Storage instance in the Cloud StorageContainer field.

The REST endpoint should be similar to https://<DOMAIN>/v1/Storage-storage_account_name/dbaas .

6. Confirm that Both Cloud Storage and Local Storage is selected as BackupDestination.

7. Enter the Username and Password for the user who created the Cloud Storagecontainer.

8. Enable Create Cloud Storage Container to create a container now. This isenabled by default. Click Next.

It is highly recommended that you select Both Cloud Storage and Local Storagefor the backup destination. This will allow you to specify a Cloud StorageContainer for Backup and Recovery when you create your Visual Builder instancefor backing up your WebLogic configuration data in the Java Layer Service.

9. Confirm the details are correct in the Confirm page. Click Create.

You can now use the provisioning wizard to provision your Oracle Visual Builderinstance. See Create an Instance with the Provisioning Wizard.

Create an Instance with the Provisioning WizardYou can use a provisioning wizard in the Oracle Visual Builder console to create asmany Oracle Visual Builder instances as you require up to the limits imposed by yoursubscription quotas.

Before using the provisioning wizard to create your instance you must first provisionOracle Database Cloud Service. An Oracle Cloud Infrastructure Object StorageClassic subscription and storage account are also needed. You can provision a

Chapter 3Create an Instance with the Provisioning Wizard

3-6

storage container before creating instance or in the Details step of the provisioningwizard.

• Create a Service Instance

• Specify Service Instance Information

• Specify the Database and Storage Details for the Instance

• Confirm Your Selections

Create a Service InstanceStart the provisioning process by creating an instance:

1. Sign in to your Oracle Cloud account.

2. From the Infrastructure Classic Console, click the navigation menu in the topleft corner, and then click Visual Builder Classic to open the Instances page.

The Instances tab displays a list of your service instances and the resourcesallocated to the instances. If you do not have any service instances you will see amessage with links to information on creating an instance.

3. Click Create Instance to open the Create Instance page.

Specify Service Instance InformationIn the Create Instance page of the provisioning wizard you provide the name and otherbasic details about the new Oracle Visual Builder instance.

1. Supply the details about the new service instance.

The Create Instance page of the wizard contains fields that you use to supply thedetails of the new service instance. The following table describes the fields in theCreate Instance page.

Field Description

Instance Name Specify a name to identify the new service instance. The namemust be unique within the tenant domain. You cannot have twoinstances with the same name at the same time; one instance mustbe deleted. The service name must meet the following conditions:

• Must start with a letter.• Cannot be longer than 50 characters.• Can only specify a hyphen as a special character.

Description Optionally add a description to help identify the purpose of this newservice. The description is only used during service list display.

Notification Email Enter an email address at which to be notified of instanceprovisioning progress (for example, when provisioning completes).


3-7

Field Description

SSH Public Key Select an option for accessing service host access.

This key is used for authentication when connecting to the instanceusing a secure shell (SSH) client. The same public key is used forall VMs configured for this service instance.

• Browse for the file containing the VM public key file.• Provide a value for an existing VM public key.• Create a new private/public key pair. A new key is generated

for you. When prompted, save the key as a file on your harddrive.

Tags Select available tags for assignment or click + to create new tags toassign to the service instance. You use tags to search for andcategorize your instances.

2. Click Next.

Specify the Database and Storage Details for the InstanceIn the Details page of the provisioning wizard you specify the details for OracleDatabase Cloud Service and Oracle Storage Cloud Service that your new instance willuse.

You will need to have completed the Prerequisites for Provisioning Oracle VisualBuilder to complete this step of the provisioning wizard.


3-8

The following table describes the fields that are used in the Details page of the wizard.

Field Description

Node Configuration Select the number of nodes to configure.


3-9

Field Description

Backup andRecoveryConfiguration

Specify the Oracle Cloud Infrastructure Object Storage Classiccontainer in which to store backups. You can specify an existingstorage container service or automatically create a new storagecontainer service during this provisioning session. The storagecontainer account must already exist even if the storage container hasnot yet been created.

You will not see this Backup and Recovery Configuration section if youdid not configure Oracle Cloud Infrastructure Object Storage Classicas the backup location when you created your Oracle Database CloudService. Though the fields in this section are not required, it is highlyrecommended that you specify the details for backing up andrecovering the WebLogic data for the instance.

• Cloud Storage Container: Specify the container name using thefollowing format:

Storage-storage_account_name/container_name

For example:

Storage-jsmith/JaasBackup

where:– Storage-storage_account_name: Storage container

account name. This account is automatically created whenyou purchase your universal credits..

Note:

See Prerequisites for Provisioning Oracle VisualBuilder to copy the automatically-created storageaccount name from the Storage Classic tile ofyour services page.

– container_name: Storage container name of an existingstorage container service or the name to use to create a newstorage container.

• Cloud Storage User Name: Specify the username.• Cloud Storage User Password: Specify the password.• Create Cloud Storage Container: Select this check box to

automatically create a storage container as part of theprovisioning process. If you have already provisioned an OracleCloud Infrastructure Object Storage Classic container, leave thischeck box deselected.


3-10

Field Description

DatabaseConfiguration

Specify Oracle Database Cloud Service details.

Note: You must provision Oracle Database Cloud Service before youcan use this wizard. Otherwise, no databases are available forselection from the Service Name list and you cannot proceed with theprovisioning process. Multiple Oracle Visual Builder instances canshare the same database instance.

• Service Name: Select the service name of the database you wantto use. Only the service name is displayed. The type of databaseis not displayed (for example, RAC or data guard). For specificdetails about the database, go to the Oracle Database CloudService console and look for the service name.

• Pluggable Database Service name: Optionally specify theservice name of the pluggable database (PDB). This field is onlyfor version 12c databases. A PDB is a multitenant containerdatabase (CDB) consisting of a portable collection of schemas,schema objects, and nonschema objects that appear to an OracleNet client as a non-multitenant container database (CDB). A non-CDB is a traditional Oracle database that cannot contain PDBs.

• Database Administrator User Name: Specify the user name.This value must be set to a database user with SYSDBA systemprivileges. You can use the default user SYS or any user that hasbeen granted the SYSDBA privilege.

• Database Administrator User Password: Specify the passwordfor the administration user. The administrator password wasspecified when the Oracle Database Cloud Service instance wascreated.

Do not specify a password that includes a hyphen.

InstanceResponsibility

Click to acknowledge that you are responsible for provisioning andadministering your own instance, including:

• Patching• Starting stopping instances and individual VMs• Starting/stopping Oracle WebLogic Server• Scaling in/scaling out• Backups• Database management• Operating system management, including ensuring that you have

enough swap spaceSee Administer a Customer-Managed Environment.

Confirm Your SelectionsThe confirmation page displays the configuration values you choose in theprovisioning wizard.

Review the service details and make a copy or a screen capture. If you need tochange the service details, use the navigation bar or Previous button at the top of thewizard to step back through the pages in the wizard. Click Cancel to cancel out of thewizard without creating a new service instance. If you are satisfied with your choiceson the Confirmation page, click Create.


3-11

Note:

You are notified by email when your Oracle Visual Builder instance has beencreated.

Create a Quick Start Instance with a Single ClickYou can create a quick start instance of Oracle Visual Builder with a single click. Thisinstance is useful for testing integrations. After testing is complete, you can import theintegration into a different Oracle Visual Builder instance. The quick start instancedoes not include or support the creation of an Oracle Cloud Infrastructure ObjectStorage Classic container instance. Without a container, database backups are notpossible.

To create new instances using QuickStarts:


2. From the Infrastructure Classic Console, click the navigation menu in the topleft corner, and then click Visual Builder Classic to open the Instances page.

3.

4. Click QuickStarts at the top of the Instances page.

The Create Instance page contains a field where you enter the name of the newinstance and a description of the features of the QuickStart instance.

5. Type the instance name in the Instance Name field. Click Create.

Chapter 3Create a Quick Start Instance with a Single Click

3-12

If you do not change the default generated value for the Instance Name, you willencounter an error when you attempt to create the instance.

6. Wait for the instance creation process to finish.

Create an Instance with the Oracle Cloud Stack TemplateYou can create an Oracle Visual Builder instance with the Oracle Cloud Stacktemplate.

A template consists of a set of services that are provisioned together (for example,Oracle Visual Builder, Oracle Database Cloud Service, and the Oracle CloudInfrastructure Object Storage Classic container). A stack is an actual provisionedinstance of a template. This option enables you to automatically provision an OracleDatabase Cloud Service and the Oracle Cloud Infrastructure Object Storage Classiccontainer along with Oracle Visual Builder during stack template provisioning. Thetemplate provides two options for provisioning an instance.

• Use the Oracle-provided template directly without modifications. This optioncreates an Oracle Cloud Infrastructure Object Storage Classic container andOracle Database Cloud Service instance with default settings.

• Create your own customized template by exporting an existing template,customizing the database and storage container settings, and importing it backinto the Oracle Cloud Stack. You can configure specific details such as the shape(number of nodes), number of CPUs, amount of memory, Oracle Real ApplicationsCluster (RAC) support, database version, database edition (standard (SE) orenterprise (EE), database administrator password, and more.

For more about using stack templates, see About Oracle Cloud Stack Manager.

To create an instance using the Oracle-provided stack template:


2. From the Infrastructure Classic Console, click the navigation menu in the topleft corner, and then select Oracle Cloud Stack..

3. Click the Templates tab.

4. Find the Oracle Visual Builder template named Oracle-VisualBuilder-CM-Template in the list in the Published tab. You can also search for the name.

Chapter 3Create an Instance with the Oracle Cloud Stack Template

3-13

There are two types of templates available. The template icon identifies the type oftemplate:

• : Template was created and automatically provided by Oracle.

• : Template was created by a user and imported into the Oracle CloudStack. For example, you exported the Oracle-provided template, customizedthe database and storage container settings, and imported it back into theOracle Cloud Stack.

You can click the template icon or template name to open a window with aTopology tab that displays a graphical representation of the components in thetemplate (for example, Oracle Visual Builder, Oracle Database Cloud Service, andOracle Cloud Infrastructure Object Storage Classic). The Topology tab opens inthe window by default. You can perform the following tasks from the window:

• Click the Template tab to view the contents of the template in YAML format.This is the stack template file used to create your instance. This templateprovides configuration information such as backup and recovery, databasebackup container, backup container, and database details.

• If you want to export the file for customizing, click Export. When customizing

is complete, click on the Templates page to import the file back into theOracle Cloud Stack.

• Click Done to close the graphic.

5. Click the icon at the far right of Oracle-VisualBuilder-CM-Template.

This template is provided by Oracle for creating an Oracle Visual Builder instance.In the Provision New Oracle Cloud Stack page, the template is prepopulated withinformation for provisioning Oracle Database Cloud Service and the Oracle CloudInfrastructure Object Storage Classic container specified in the template.

6. Specify the following details:


3-14

Field Description

Stack Details • Name: Enter a stack name. Upon Oracle Visual Buildercreation, the stack name points to all instances created andthe database created.

• Description: Enter a description.• Template: Displays the template used to create the stack. This

field cannot be edited.• Notification Email: Enter an email address at which to be

notified of instance provisioning progress (for example, whenprovisioning completes).

• On Failure Retain Resources: Select to retain all services,even if a failure occurs during provisioning. For example, ifselected and Oracle Database Cloud Service was successfullyprovisioned, but the Oracle Cloud Infrastructure ObjectStorage Classic container was not, both are retained. Thisaction enables you to debug service failures. If not selected, noservices are retained if a failure occurs, even those servicesthat were provisioned successfully.

Backup andRecoveryConfiguration

Enter the following details to automatically create an Oracle CloudInfrastructure Object Storage Classic container instance for backupand recovery.

• Cloud Storage Account Name: Enter the storage containeraccount name (for example, Storage-bjones). This accountis automatically created when you purchase your universalcredits. Do not enter the actual storage container namebecause the storage container is automatically created duringstack template provisioning.

Note: See Prerequisites for Provisioning Oracle Visual Builderto copy the automatically-created storage account name fromthe Storage Classic tile of your services page.

• Cloud Storage User Name: Enter the storage container username.

• Cloud Storage User Password: Enter the password for theuser name.

Service • SSH Public Key: Create a new key or upload an existing key.• Number of Nodes: Enter the number of nodes. You can add

nodes (scale out) and remove nodes (scale in) later in theOracle Visual Builder console.

7. When complete, click Next.

8. Confirm your selections, then click Confirm.

When provisioning completes, a stack is displayed, a new database is displayed,and one or two new Oracle Visual Builder instances are displayed, each in theirown respective console. You must go to these consoles to perform life cyclemanagement operations such as scaling out, scaling in, and other tasks.

Note:

To delete the stack, you must use the Oracle Cloud Stack console todelete all of the related services. For example, if you delete a stack, theOracle Database Cloud Service, Oracle Cloud Infrastructure ObjectStorage Classic container, and Oracle Visual Builder instances are alldeleted. These instances cannot be deleted individually.


3-15

About the User Interfaces of the Oracle Visual BuilderConsole

You can perform a variety of life cycle management tasks from the Oracle VisualBuilder console.

Topics:

• Explore the Oracle Visual Builder Console

• Explore the Oracle Visual Builder Console Instance Overview Page

• Explore the Oracle Visual Builder Console Activity Page

• Explore the Oracle Visual Builder Console SSH Access Page

Explore the Oracle Visual Builder ConsoleYou can use the Oracle Visual Builder console to view all existing Oracle VisualBuilder instances and to create new instances.

The following table describes the key information shown in the Oracle Visual Builderconsole.

Chapter 3About the User Interfaces of the Oracle Visual Builder Console

3-16

Element Description

(Next to the word Oracle)

Click and select a choice from the menu to open the console for one of theOracle Cloud Services to which you are subscribed.

Click to sign in to the services to which you are subscribed.

Services tab Click to navigate to the console (this page).

Activity tab Click to navigate to the Oracle Visual Builder console Activity page. See Explore the Oracle Visual Builder Console Activity Page.

SSH Access tab Click to navigate to the Oracle Visual Builder console SSH Access page. See Explore the Oracle Visual Builder Console SSH Access Page.

Welcome! Click to display the Oracle Visual Builder Welcome page.

Services (Summary panel) Number of instances in the identity domain.

OCPUs (Summary panel) Total number of Oracle Compute Units (OCPUs) allocated across all instances.

Memory (Summary panel) Total amount of memory in GBs allocated across all instances.

Storage (Summary panel) Total amount of block storage in GBs allocated across all instances.

Public IPs (Summary panel) Total number of IP reservations allocated across all instances.

Services (heading) All instances in the identity domain.

Enter a full or partial service instance name to filter the list of service instancesto include only the services that contain the string in their service name.

Create Service Create a new service instance. See Create a Service Instance.

Service instance. Click this icon to view more details.

Status icon indicating that the instance is being created.

Status icon indicating the instance is undergoing maintenance or terminating.

Status icon indicating that the instance has failed to be created. This icon canalso indicate that the service instance has stopped. See the Activity page.

service-name Name of the instance. Click the name to view more details.

Version Version of Oracle WebLogic Server configured for the instance.

Nodes Number of nodes allocated for the instance.

Created On When provisioning is complete, that date and time in UTC at which the instancewas created.

OCPUs Number of OCPUs allocated for the instance.

Memory Amount of memory in GBs allocated for the instance.

Storage Amount of storage in GBs allocated for the instance.


3-17

Element Description

The Menu icon can provide the following options based on the service typesyou have provisioned:

• Open Fusion Middleware Control—Open Fusion Middleware Control.• Instance Friendly URL—Open the instance at a URL that can be

recognized, for example, https://service1–domain1/, which is set byadministrator.

• Open Visual Builder Home Page—Open the home page for the serviceinstance.

• Instance Permanent URL—Open the instance at the actual URL.• Open WebLogic Server Console—Open the Oracle WebLogic

Administration Console.• Start— Start Oracle Visual Builder.• Stop— Stop Oracle Visual Builder.• Access Rules—Open the Access Rules page, which enables you to

create and manage access rules for selected sources and destinations.• SSH Access—Add public SSH keys to the VMs that make up this service

instance.• Delete—Delete the service instance. In the Delete Service dialog box that

opens, set the following options and click Delete:– Force Delete—(Optional) Select this checkbox if you want the service

instance to be deleted even if the database deployment cannot bereached to delete the database schemas. If enabled, you may need todelete the associated database schemas manually on the databasedeployment if they are not deleted as part of the service instancedelete operation.

– Database Administrator User Name—Enter the name of thedatabase administrator user that was specified when the databasedeployment was created. This user owns the instance’s repository andschemas. If you have specified two databases, specify the name of theadministrator for the database deployment for the Oracle requiredschema.

– Database Administrator User Password—Enter the databaseadministrator user password for the database deployment thatcontains the Oracle required schema.

Service Create and DeleteHistory

Shows details about created or deleted service instances.

• Range—Specifies a range of days for which you are interested in viewingcreated and failed service instances.

• Show only failed attempts—Check this box if you want to see failedattempts only.

• Details—Displays system messages logged during the creation or deletionprocess. Messages include information about auto-retry attempts.

Explore the Oracle Visual Builder Console Instance Overview PageYou can use the Overview tile on the Instance page to view overview information for aspecific instance. To access this page, click an instance name or icon in the OracleVisual Builder console.


3-18

The following table describes the key information shown on the Overview tile.

Element Description

• Click the expand icon next to the service name to expose the followinginformation about the service instance:

– Location– Description– Identity Domain– Metering Frequency– Created By– Created On

• Click the text Visual Builder Cloud Service to return to the main console.• Lists the name of the selected service instance.


3-19

Element Description

(adjacent to the serviceinstance name)

The Menu icon can provide the following options based on the service typesyou have provisioned:

• Open Service Bus Console — Open the Oracle Service Bus Console.• Open Fusion Middleware Control — Open Fusion Middleware Control to

administer your application environment.• Open Load Balancer Console — Open the console to administer the load

balancer.• Open WebLogic Server Console — Open the Oracle WebLogic Server

Administration Console to administer your application environment.• Start — Start the instance.• Stop — Stop the instance.• Scale in — Remove nodes from the instance.• Scale out — Add nodes to the instance.• Disable Load Balancer — Disable the load balancer.• Access Rules — Opens the Access Rules page, which enables you to

create and manage access rules for selected sources and destinations.• SSH Access—Add public SSH keys to the VMs that make up this service

instance.• View Activity—View activities that have occurred in your identity domain.

Click the start/stop/scale/monitor icons to:• Start the VMs for the administration server, managed servers, and load

balancer.• Stop the VMs for the administration server, managed servers, and load

balancer.• Add a node.• Displays monitoring data:

– Date and time each node was last started.– For each server, the percent of heap space used as compared to the

total heap space in GBs available. If you click the percentage number,the heap usage graph is displayed.

Click to refresh the page. The date and time the page was last refreshed aredisplayed adjacent to this button.

Click the Overview tile to access the Instance Overview page (this page) atanytime. The Overview tile displays information about the service instance. Itcontains the following four sections:• Service Overview — Overview information about the service instance• WebLogic Component — Information about the underlying Oracle

WebLogic Servers• Oracle Load Balancer — Information about the Oracle Load Balancer• Associations — Information about the database deployment used by the

service instance

Service Overview section Overview information about the instance.

Nodes (Service Overviewpanel)

Total number of Oracle CPUs allocated for the instance.

OCPUs (Service Overviewpanel)

Total number of Oracle Compute Units (OCPUs) allocated across all instances.


3-20

Element Description

Memory (Service Overviewpanel)

Total amount of memory in GBs allocated for the instance.

Storage (Service Overviewpanel)

Total amount of block storage in GBs allocated for the instance.

Other overview information • Status — The service instance’s status.• Open Sample Application — Click Show More to show a link to the Oracle

Identity Cloud Service Console to add users and assign roles. See AddUsers and Assign Roles

• Version — The version of Oracle WebLogic Server configured for theinstance.

• JDK — The supported Java Developer Kit version.

WebLogic Component section Information about the underlying Oracle WebLogic Servers.

General information • State — The cluster’s state• Cluster Name — The name of the cluster• Admin Server Name — The name of the administration server• Domain Name — The name of the domain

Resources Information about the virtual machines for the administration server andmanaged server(s).

Information about the administration server or managed server(s):• Host Name• Public IP address• Instance name (managed server)• Instance name (administration server)• Number of Oracle CPUs allocated (OCPU)• The amount of memory allocated to the node• The amount of storage available to the node

Oracle Load Balancer section Information about the Oracle Load Balancer server(s).

General information • State — The cluster’s state• Enable listener port — Set to true or false depending on whether it is

enabled.• Privileged listener port• Secured Listener port• Admin port• Listener port• Privileged secure listener port

Resources Information about the virtual machines for the load balancer server(s).

Information about the administration server or managed server(s):• Host Name• Public IP address• Number of Oracle CPUs allocated (OCPU)• The amount of memory allocated to the node• The amount of storage available to the node


3-21

Element Description

Associations section Information about the Oracle Database Cloud Service database deploymentused by the instance. If the instance is based on two database deployments(one for the Oracle required schema and the second for the applicationschema), information for both database deployments is displayed.

• Service Name — The name of the Oracle Database Cloud Servicedatabase deployments used by the instance. The name was specifiedduring the process of creating the instance.

• Connect Descriptor — Specifies the connect string for the databasedeployment.

• Type — The only available value is Oracle Database Cloud Service• Status — The status of the database deployment.

Click the Administration tile to backup an instance.

Backup Tab Provides status of backups and access to backup tasks.

Incremental Backups Displays the time at which incremental backups occur. For example:

Daily at 11:40:00 AM UTC

The amount of MB backed up to Oracle Cloud Infrastructure Object StorageClassic.

Full Backups Displays the time at which the full backup occurs. For example:

Every Saturday at 11:40:00 AM UTC

The volume of backup space used is also displayed.

Last Successful Backup The time at which the last successful backup occurred. For example:

Tuesday at 11:40:00 AM UTC

The percentage of the backup volume used is also displayed.

Most Recent Backup Displays the time of the last backup. If a red icon is displayed, click it for backupfailure details.

Available Backups Select the menu to display the following options:• Backup Now• Configure Backups• Disable BackupsSee Back Up and Restore an Oracle Visual Builder Instance.

Restore History


3-22

Explore the Oracle Visual Builder Console Activity PageYou can use the Activity page to search for and review cloud service activities thathave occurred in your identity domain. To access this page, click the Activity tab in theOracle Visual Builder Console.

The Activity page is divided into the following sections:

• The Search Activity pane, from which you can specify search details thatdetermine which services you see. These details include:

– Date and time range

– Operation status

– Service name and type

– Operation type

• The Results pane, which shows the results of the search operation. You can limitthe number of results to return, per page, to 5, 10, 50, or 100

The following table describes the key information shown on the Activity page.

Element Description


Services tab Click to return to the Oracle Visual Builder console.

SSH Access tab Click to navigate to the Oracle Visual Builder console SSH Access page. See Explore the Oracle Visual Builder Console SSH Access Page.

Start Time Range Filters activity results to include only operations started within a specified timerange. The range defaults to the previous 24 hours.

Operation Status Filters operations by status of the operation:• All (default value)• Scheduled• Running• Succeeded• FailedYou can select any subset of status types.

Service Name Filters the activity results to include operations only for the specified serviceinstance. You can enter a full or partial service instance name.

Service Type Filters the activity results to include operations only for instances of thespecified service type. The default value is the current cloud service.

Operation Filters the activity results to include selected types of operations. You can selectany subset of the given operations. The default value is All.

Search Searches for activities by applying the filters specified by the Start Time Range,Status, Service Name, Service Type and Operation fields, and displays activityresults in the table.

Reset Clears the Start Time Range and Service Name fields, and returns the Statusand Operation fields to their default values.

Results per page Specifies the number of results you want to view per page. The default value is10. You can sort the columns in ascending or descending order.


3-23

Element Description

Displays status messages for the given operation. Clicking on the resultingdownward arrow hides the status messages.

Operation Shows the type of operation performed on the service instance.

Service Name Shows the name of the service instance and its identity domain:

service_instance:identity_domain

Service Type Shows the type of cloud service for this instance.

Operation Status Shows the status of the operation performed on the service instance.

Start Time Shows the time the operation started.

End Time Shows the time the operation ended, if the operation is complete.

Initiated By Shows the user that initiated the operation. The user can be any user in theidentity domain who initiated the operation or, for certain operations such asautomated backup, System.

Explore the Oracle Visual Builder Console SSH Access PageYou can use the SSH Access page to view and manage public SSH keys from theOracle Visual Builder console.

The SSH Access page is divided into the following two sections:

• The Search Activity pane, from which you can specify the service name and typewhen you want to see SSH information for a specific service or group of services.

• The Results pane, which shows the results of the search operation. You can limitthe number of results to return, per page, to five, ten 50 or 100.

The following table describes the key information shown on the Activity page.

Element Description


Services tab Click to return to the Oracle Visual Builder console.


3-24

Element Description

Activity tab Click to navigate to the Oracle Visual Builder console Activity page. See Explore the Oracle Visual Builder Console Activity Page.

Service Name Filters the results to include SSH keys only for the specified service instance.You can enter a full or partial service instance name.

Search Searches for SSH keys by applying the filters specified by the Service Nameand Service Type fields, and displays the results in the table.

Service Type Filters the results to include SSH keys only for instances of the specified servicetype. The default value is the current cloud service.

Results per page Specifies the number of results you want to view per page. The default value is10.

Displays a description of an item in the results table. Clicking the resultingdownward arrow hides the description.

Service Name Shows the name of the service instance.

Service Type Shows the type of cloud service for this instance.

Last Update Shows the most recent time the SSH keys for this instance were updated.When the credential update is in progress, an hourglass icon is displayedbefore the date/time, indicating that the service instance is in maintenancemode.

Actions Click the Add New Key button to add a new SSH public key to this instance.This button is grayed out when the key is in the process of being added.


3-25

4Add Users and Assign Roles

User roles define the privileges available to a user and the tasks that the user canperform. You can grant users various roles to enable them to access, administer, anduse Oracle Visual Builder.

Topics:

• Oracle Visual Builder Roles and Privileges

• Add Users to a Cloud Account with IDCS

Oracle Visual Builder Roles and PrivilegesA role includes privileges that allow users to perform various tasks. All Oracle Cloudservices have some predefined roles for performing tasks when setting up,administering, managing, and using a service. There are predefined roles for the PaaSlayer, the application layer and Oracle Visual Builder.

The PaaS-layer roles govern access to WebLogic Server. The application-layerpredefined roles include ServiceAdministrator, ServiceMonitor, ServiceDeveloper,ServiceDeployer, and ServiceUser, but only some of these roles are used and mappedto the predefined roles used in Oracle Visual Builder. To perform tasks in OracleVisual Builder, the user must be assigned to one of the Oracle Visual Builderpredefined roles. Users can hold multiple roles depending on their responsibilities. Forexample, a user might be granted both the ServiceAdministrator and ServiceMonitorroles, but any privileges granted by the role of ServiceMonitor are ignored in OracleVisual Builder.

Add Users to a Cloud Account with IDCSIf you are using an Oracle Cloud Account with Oracle Identity Cloud Service (IDCS),then you can use Users tab on the Oracle Visual Builder console to access thefeatures of IDCS to manage users and security for your Oracle Cloud services.

Topics:

• Add Users

• Assign Roles to Users

Add UsersAfter Oracle Visual Builder is provisioned, you need to create the required useraccounts in the identity domain of your Oracle Visual Builder instance.

Only a user with the Identity Domain Administrator role or the User Administrator rolethrough delegated administration can create user accounts. When Oracle VisualBuilder is provisioned, the Identity Domain Administrator account gets created in

4-1

addition to the roles described in Oracle Cloud User Roles and Privileges in GettingStarted with Oracle Cloud.To add a user account, you need to know the first name, last name, and email addressof the user.

1. Sign in to Oracle Cloud.

2. From the Infrastructure Console, click the navigation menu in the top leftcorner, expand Platform Services, and then click Visual Builder to open theInstances page.

3. In the Oracle Visual Builder console, click Users.

4. On the User Management page in the Oracle Visual Builder console, click IdentityConsole.

5. On the User Management page in the Oracle Identity Cloud Service console, clickAdd.

6. In the First Name and Last Name fields of the Add User dialog, enter the user’sfirst and last name.

To have the user log in to Oracle Visual Builder with their email address:

a. Leave the Use the email address as the user name check box selected.

b. In the User Name/Email field, enter the email address for the user account.

To have the user log in to Oracle Visual Builder with their user name:

a. Clear the Use the email address as the user name check box.

b. In the User Name field, enter the user name that the user is to use to log in tothe Oracle Identity Cloud Service console.

c. In the Email field, enter the email address for the user account.

7. To assign the user account to a group, click Next. Otherwise, click Finish.

8. In the Add User window, select the check box for each group that you want toassign to the user account. Click Finish.

Chapter 4Add Users to a Cloud Account with IDCS

4-2

After the user account is created, the user receives an email with the sign-incredentials.

You can activate user accounts, import user accounts, and create groups and assignusers to various groups, as described in Managing Oracle Identity Cloud Service UserAccounts in Administering Oracle Identity Cloud Service.

Assign Roles to UsersThe Identity Domain Administrator must assign roles to users to specify the tasks theycan perform in Oracle Visual Builder. A user can have more than one role.

The role assigned to the user determines the privileges and tasks the user canperform in Oracle Visual Builder. See Oracle Visual Builder Roles and Privileges for adescription of the various predefined roles available in Oracle Visual Builder.

1. Sign in to Oracle Cloud.

2. From the Infrastructure Console, click the navigation menu in the top leftcorner, expand Platform Services, and then click Visual Builder to open theInstances page.

3. From the Oracle Visual Builder console, click Users and Identity Console tonavigate to the Oracle Identity Cloud Service console.

4. From the Oracle Identity Cloud Service console, click the navigation menu inthe top left corner, and then click Applications.

5. Click the link for your Oracle Visual Builder instance.

You can use the filter to help you locate your instance. For Oracle Visual Builderinstances you might want to search for the name of your instance appended with“vb” (for example, “Testvb”, or “VISUALBUILDERAUTO_Testvb”.

6. Click the Application Roles tab.

7. To grant a role to users:

a. Click the menu options icon shown next the role, and select Assign Users. Ifyou want to assign the role to a group, you need to select Assign Groups.

b. Select the check box next to the name of each user that you want to add to therole, and then click Assign.


4-3


4-4

5Administer a Customer-ManagedEnvironment

In a customer-managed environment, an administrator is responsible for maintainingthe infrastructure on which Oracle Visual Builder is built.

An administrator can apply a patch, initiate on-demand backups, schedule automatedbackups, add or remove nodes for increased or reduced load on an Oracle VisualBuilder instance. In addition, an administrator can monitor an Oracle Visual Builderinstance and export diagnostic information to resolve the problems.

Note:

Administrators are STRONGLY encourage to update the database schemapasswords within 180 days of creating the instance, and regularly thereafterbefore they expire. Services might be disrupted if passwords are not resetbefore they expire.

See Reset the Database Password Before It Expires.

Note:

Oracle does not possess the credentials for consoles such as EnterpriseManager (EM), WebLogic Server console, and Service Bus console.Therefore, a user is not blocked from performing tasks from these consoles.However, Oracle highly recommends that users DO NOT use theseconsoles.

See Unsupported Tasks.

Topics:

• Unsupported Tasks

• Patch and Upgrade Your Environment

• Start and Stop Oracle Visual Builder Instances and Individual Nodes

• Scale Out and Scale In an Oracle Visual Builder Instance

• Reset the Database Password Before It Expires

• Back Up and Restore an Oracle Visual Builder Instance

• Diagnose Problems

5-1

Unsupported TasksOracle does not possess the credentials for consoles such as WebLogic Server orEnterprise Manager. Therefore, a user is not blocked from performing tasks from theseconsoles. However, Oracle highly recommends that users DO NOT use theseconsoles.

The following lists some of the tasks that are not supported in Oracle Visual Builder.DO NOT perform these tasks unless recommended by Oracle.

• Changing load balancer (LBaaS) settings

• Changing or removing CloudGate policies through IDCS REST API.

• Changing WebLogic server topology, including adding or deleting managedservers

• Configuring SOA engine properties

• Configuring SOA MBean settings

• Changing the WebLogic JVM settings

• Configuring WebLogic resources including data sources, connection pools, JMSservers, work managers, and partitions

• Configuring WebLogic MBean settings

• Deploying composites or service bus projects

• Deleting files including temporary files

• Deploying new Java EE applications to WebLogic

• Installing or uninstalling Linux programs

• Modifying date and metadata using SQL

• Modifying or Deleting the IDCS Applications, AppID, Roles that are created out ofthe box in IDCS admin console.

• Modifying firewall rules (iptables)

• Modifying Linux operating system privileges

• Modifying MDS metadata

• Modifying OPSS permissions

• Modifying SSH keys

• Patching Oracle Linux with unsupported updates

• Restarting WebLogic Server, Managed Server, Node Managers through WebLogicServer Console.

• Tuning Linux operating system settings

• Using compute console to modify security rules or reserve IP address

• Viewing, modifying or deleting suite-generated composites, service bus projects,and folders.

Chapter 5Unsupported Tasks

5-2

Patch and Upgrade Your EnvironmentApply a patch to an Oracle Visual Builder instance, and roll back the patch asnecessary.

Topics:

• Typical Workflow for Patching an Oracle Visual Builder Instance

• Explore the Patching Page

• View Details of Approved Patches

• Perform Patching Prechecks

• Apply a Patch to an Oracle Visual Builder Instance

• Roll Back a Patching Operation

Typical Workflow for Patching an Oracle Visual Builder InstanceConsider the typical workflow for patching an Oracle Visual Builder instance, asdescribed in the following table.

Task Description More Information

Learn about approved patches View approved patches displayed onthe Patching page periodically.

View Details of Approved Patches

Perform optional prechecks Learn about problems that wouldcause patching to fail, so you canaddress those problems before you tryto apply a patch.

Perform Patching Prechecks

Apply a patch Initiate a patching operation. Apply a Patch to an Oracle VisualBuilder Instance

Roll back a patch Initiate a rollback operation to return aservice to its previous patch level.

Roll Back a Patching Operation

Explore the Patching PageYou can use the Patching page to view the available patch, initiate a patching process,and roll back a patch as necessary.

To access the Patching page, click the Administration tile on the Service Overviewpage, then click the Patching tab.

The following table describes the key information shown on the Patching page.

Element Description

Available Patches Displays patches that are available. The patch number is displayed. Therelease date and affected components are displayed. Information aboutwhether a restart is required is displayed.

Chapter 5Patch and Upgrade Your Environment

5-3

Element Description

Represents an available patch.

This menu has two choices:

• Precheck—Performs prechecks without attempting to patch, and reportsany errors found so that you can address them before you patch.

• Patch—Performs prechecks, then patches the Oracle Visual Builderinstance with the selected patch.

Represents a successful patching precheck operation.

Represents a failed patching precheck operation.

Represents a patching operation in progress.

Patch History Displays the history of patches that have been applied to the Oracle VisualBuilder instance.

Indicates a successful patching operation. Appears in the Patch History section.Click this icon to obtain more information about the patching operation.

Displayed on a tools patch, indicates that the patch version for your existingOracle Visual Builder instance is older than the current version. You will alsosee a warning stating that the service is on a deprecated tools version. Toaddress this issue, apply the latest tools patch to your instance.

Initiates an operation to roll back the instance to its patch level prior to applyingthe patch.

View Details of Approved PatchesYou can use the Patching page to view the information about the available patchesand service patch history.

To view details of approved patches:

1. In the Oracle Visual Builder console, click the name of your instance.

2. In the Service Overview page, check the Administration tile to see the number ofavailable patches, and the date and time of the previous backup.

3. If patches are available, click the Administration tile, then click the Patching tab.


5-4

4. On the Patching page, check the information in the Available Patches section.

Perform Patching PrechecksPatching performs prechecks before applying a patch, but you can perform an optionalprecheck operation before patching to identify and remedy issues first.

Prechecks occur automatically once you make a selection from the menu, thenproduce messages letting you know the results.Prechecks check for the following conditions:

• Disk space shortage

• Missing database connectivity

• Servers not running

• Storage access failure

Prechecks do not check whether another administration task (backup, restoration, orscaling) is in progress, which prevents patching.

If prechecks pass or you address all the issues identified by prechecks, you can run apatching operation that will not encounter these issues.

You can only request prechecks for an approved patch that is listed on the patchingpage.

1. Navigate to the Patching page.

2. On the Patching page, click on the menu icon to the right of the patch you wantto check.

A menu containing Precheck and Patch is displayed.

3. Select Precheck.

A message is displayed beneath the patch name: Prechecks in progress.

4. Click the Refresh icon to check whether prechecks are done.

When prechecks are done, a link is displayed: Precheck results.

• If prechecks pass, a green check mark icon is displayed.


5-5

• If prechecks fail, a red exclamation mark icon is displayed.

5. Click the Precheck results link.

The Patch Precheck Results dialog is displayed.

• If the prechecks succeed, the following message is displayed in the dialog:Precheck succeeded for patch patch_name_and version ondate_and_time. No conflicts found.

Conflicts arise when a non-approved patch was applied using opatch, forexample.

• If the prechecks fail, the following message is displayed in the dialog:Precheck failed for patchpatch_name_and_version ondata_and_time.

Error messages are displayed in the dialog as well. If there are precheckfailures, check the error messages to learn about the problems that you needto address.

The Precheck results link remains after prechecks complete.

Apply a Patch to an Oracle Visual Builder InstanceYou can use the Patching page to apply a patch of an Oracle Visual Builder instance.

To apply a patch:


2. In the Available Patches section, click the menu icon to the right of the patchyou want to apply and select Patch.

3. In the Patch Service dialog, type notes pertaining to the patch.

You must enter a note. If you do not, an error message displays and you will notbe able to patch.

4. In the Patch Service dialog, click Patch.

Roll Back a Patching OperationYou can use the Patching page to view the results of patching operations and to rollback patches.

You can roll back a patch if you find that a patch is incompatible with applicationsdeployed on your service, or for any other possible reason.

The patching history is displayed on the Patching page. The history shows the patchnumber, the name of the administrator who applied the patch, and any notes. Whenthe rollback operation is complete, the patch information stays in the patch historysection, but the Roll Back button is grayed-out. The patch information also reappearsin the list of available patches, so you can try applying the patch again.

Each patch, whether failed or successful, has a backup, which also appears on theBackup page. Rolling back a patch restores the binaries to the specific versionrecorded at the time of the backup, and leaves the domain and user data intact. Youcan restore the domain configuration after rollback by using the Backup page.

To roll back a patch:


5-6


2. In the Patch History section, click the Roll Back button to the right of the patchyou want to roll back.

3. In the Roll Back Service dialog, click Roll Back.

A message is displayed, stating that a roll back job has been submitted.

The label on the Roll Back button changes to Rolling Back... and the button isgrayed-out.

When the operation is complete, the patch entry in the Patch History section isgrayed out, preventing you from trying to roll back the patch again.

The service returns to its previous patch state.

Start and Stop Oracle Visual Builder Instances andIndividual Nodes

You can stop and start an Oracle Visual Builder instance and, when the instance isrunning, start, stop, and restart individual nodes.

Topics:

• About Stopping and Starting an Oracle Visual Builder Instance and IndividualVirtual Machines

• Stop and Start an Oracle Visual Builder Instance

• Stop, Start, and Restart an Individual Virtual Machine

About Stopping and Starting an Oracle Visual Builder Instance andIndividual Virtual Machines

You can stop and start an Oracle Visual Builder instance and stop, start, and restartvirtual machines when the instance is running.

Stopping an Oracle Visual Builder instance frees up compute resources used by theinstance’s virtual machines. Metering for those resources stops.

Storage volumes remain intact when the instance is stopped, and are reattached whenyou start the instance. IP address reservations are retained when the instance isstopped, so when you start the instance the virtual machines will have the same publicIP addresses as before.

You can monitor progress of a stop, start, or restart operation on the Activity page.

Stopping and starting an Oracle Visual Builder instance has the following results:

• Stopping the instance: The virtual machines on which the Administration Serverand Managed Servers are running are stopped. You cannot start, stop, or restartthe Administration Server or Manager Server individually while the instance isstopped.

• Starting the instance: All virtual machines on which the Administration Serverand Managed Server are running are started. You can restart the AdministrationServer and Managed Servers individually.

Chapter 5Start and Stop Oracle Visual Builder Instances and Individual Nodes

5-7

If an Oracle Visual Builder instance is running:

• You can restart the virtual machines on which the Administration Server orManaged Server are running if you are experiencing problems with the server thatwould warrant a reboot.

• You can stop the virtual machines on which the Managed Server is running to freeup resources and stop metering those resources. You might also want to stop theinstance instead of scaling, keeping the server ready for a later time.

• You can start a Managed Server if it is stopped and you want to use it again.Metering begins again.

When you try to stop an Oracle Visual Builder instance, on rare occasions it mightbecome stuck in maintenance mode due to some problem with the instance. For sixhours, the software will continue to attempt to stop the instance, then change theinstance status from maintenance state to error state. At this point, you can debug theproblem causing the error and attempt to stop the instance again.

Stop and Start an Oracle Visual Builder InstanceYou can stop and start an Oracle Visual Builder instance using the Oracle VisualBuilder console.

To stop or start an Oracle Visual Builder instance:


2. Complete one of the following actions:

• Click the Menu icon adjacent to the service name and select Start or Stop.

• Click the Start or Stop icon.

Note:

The Start and Stop options remain active while the operation is inprogress so that, if the operation gets stuck, you can try to start or stopagain.

A confirmation dialog is displayed.

3. Click OK in the confirmation dialog.

A yellow status icon is displayed adjacent to the service instance icon while theservice instance is in the process of stopping or starting.

When the operation completes, the Oracle Visual Builder instance is stopped orstarted. The yellow icon is no longer displayed. A red icon is displayed when theservice instance is stopped. On the Activity page, the entry for the service showsthat the stop or start operation has ended.

Chapter 5Start and Stop Oracle Visual Builder Instances and Individual Nodes

5-8

Stop, Start, and Restart an Individual Virtual MachineYou can stop, start, and restart a virtual machine in an Oracle Visual Builder instance.

To stop, start, or restart a virtual machine:


2. On the Instance page, click Menu icon to the right of the virtual machine andselect Stop, Start, or Restart.

3. Click OK in the confirmation dialog.

The node stops, starts, or restarts.

Scale Out and Scale In an Oracle Visual Builder InstanceScaling lets you add or remove resources for an Oracle Visual Builder instance ondemand in response to changes in load on the instance.

Topics:

• Overview of Scaling Tasks for an Oracle Visual Builder Instance

• Scale Out an Oracle Visual Builder Cluster

• Scale In an Oracle Visual Builder Cluster

• View Scaling Requests

Overview of Scaling Tasks for an Oracle Visual Builder InstanceYou perform scaling tasks for an Oracle Visual Builder instance as required.

The following table provides information about how to perform each task by using theweb-browser-based Oracle Visual Builder administration console.

Chapter 5Scale Out and Scale In an Oracle Visual Builder Instance

5-9


Scale out an Oracle Visual Buildercluster

Scale out an Oracle Visual Buildercluster to add one node to thecluster.

Scale Out an Oracle Visual BuilderCluster

Scale in an Oracle Visual Builderinstance cluster

Scale in an Oracle Visual Buildercluster to remove a selected nodefrom the cluster.

Scale In an Oracle Visual BuilderCluster

View scaling requests View scaling requests to check thestatus of ongoing scaling requests,and the success or failure ofprevious requests.

View Scaling Requests

Scale Out an Oracle Visual Builder ClusterYou can scale out an Oracle Visual Builder cluster to add one node to the cluster.When you scale out, Oracle Visual Builder instance creates a new VM running aWebLogic Server Managed Server instance.

Before scaling out a cluster, ensure that all these conditions are met:

• You have the Oracle Visual Builder Administrator role.

• The instance is not under maintenance, such as during patching or backing up.

If any of these conditions is not met, the scaling operation fails and Oracle VisualBuilder logs an error message.

Oracle Visual Builder logs a message when scaling out is started or completed, orwhen a failure is detected.

If an attempt to scale out a cluster fails, Oracle Visual Builder does the following:

• Logs any diagnostic information.

• Sets the status of the instance to RUNNING to allow other operations to continue.

• Returns the instance to its original shape.

• Deletes the VM that it created to run the additional Managed Server instance.

To scale out an instance cluster:


2. Click .

(Alternately, click the next to the instance name.)

The Scale Out dialog box is displayed.

3. To confirm you want to scale out the cluster, click Scale Out.

4. After a few moments, click the (Refresh) icon to update the page.

You might need to click the icon more than once to see any change to the page.

After a few moments of processing, the new node will appear on the Overview page.The Overview tile will show the number of nodes increased by one.


5-10

Note:

At any time during the scaling process, you can check its status by clicking

next to the instance name and the selecting View activity. The Activitypage will open and you can see the scale-out status in the activity table.

Scale In an Oracle Visual Builder ClusterYou can scale in an Oracle Visual Builder cluster to remove a selected node from thecluster. When you scale in, Oracle Visual Builder removes the selected WebLogicServer Managed Server instance and the VM that it is running on.

Before scaling in a cluster, ensure that the cluster contains at least one ManagedServer node in addition to the node for the Administration Server and first ManagedServer. You cannot scale in a cluster that contains only the node for the AdministrationServer and first Managed Server. If you no longer require that node, you must deletethe entire instance.

By default, Oracle Visual Builder scales in a cluster gracefully by shutting down theManaged Server instance before removing the Managed Server instance from thecluster and terminating its VM. To ensure that the node is removed even if theManaged Server instance is unresponsive, you can choose to forcibly scale in acluster.

If an attempt to scale in a cluster fails, Oracle Visual Builder does the following:

• Logs any diagnostic information.

• Sets the status of the instance to RUNNING to allow other operations to continue.

• Cleans up any stale resources.

If you’ve created any managed servers outside of theOracle Visual Builderprovisioning and scaling (for example, from the WebLogic console), you should eithermanually delete those servers before scaling-in a cluster, or use the force deletefeature.

1. Navigate to the Oracle Visual Builder console.

2. From the console, click the name of your instance.

3. From the Service Overview page, click for the node you want to remove and,from context menu, select Remove node.

The Remove Node dialog box is displayed.

4. In the Remove Node dialog box, click Remove Node.

5. After a few moments, click the (Refresh) icon to update the page.

You might need to click the icon more than once to see any change to the page.

After a few moments of processing, the node is removed from the Overview page. TheOverview tile will show the number of nodes decreased by one.


5-11

Note:

At any time during the scaling process, you can check its status by clicking

next to the instance name and the selecting View Activity. The Activitypage will open and you can see the scale-in status in the activity table.

View Scaling RequestsYou can view scaling requests to check the status of ongoing scaling requests, andthe success or failure of previous requests.

To view ongoing or past scaling requests:


2. On the Instance page, click the service menu ( ) at the top of the page and selectView Activity.

The Activity page of the Platform Services Console opens.

3. In the Search Activity Log panel, enter the necessary search criteria:

Option Description

Start Time Range The date and time range within which you want to seescaling activity.

Status The status of the scaling activity you want to view. Thisoption will filter out all scaling activity not in this status. Tosee all status, select All.

Service Name The name of the service instance for which you want to seescaling activity.

Service Type This should be Visual Builder.Operation The operation for which you want to see activity. In the case

of scaling, select any or all of these options:• Scale Application• Scale In• Scale Out• Scale Up/Down

4. Click Search.

All scaling activity that meets the search criteria appears in the results table. TheStatus column will indicate whether the scaling operation succeeded or failed. Tosee more details about a specific operation, click its drop-down control.

Reset the Database Password Before It ExpiresDatabase schemas are created in the Oracle Database Cloud Service (DBaaS)instance when you provision a Visual Builder instance. For security reasons, theschema passwords expire every 180 days. If the password expires, it disrupts thefunctionality of the Oracle Visual Builder instance and potentially leads to systemdowntime.

Chapter 5Reset the Database Password Before It Expires

5-12

Administrators are strongly encourage to update the database schema passwordswithin 180 days of creating the instance, and regularly thereafter before they expire toavoid disruption.

The passwords for your instance might be expired if you observe any of the following::

• When you navigate to the Visual Builder home page, Visual Builder does not openand you see the following error message :

ERROR: Error with code 500 occured while performing request to: /ic/builder/resources/application/applist

• You are unable to restart your Visual Builder instance, or the WebLogic Servicedoesn't start.

If you know or suspect that your password has expired, you will need to file a ServiceRequest (SR) and work with the DevOps team to set a new password and restoreservices.

Update the Database Schema PasswordTo avoid disruption of services, Oracle recommends that you use the service consoleto change the Oracle schema password before it expires. Changing the password inthe console also updates your service instance to use the new password.

To change the database schema password:

1. Access your service console.

2. Click the name of the service instance whose schema password you want tochange.

3. At the bottom of the Overview page, expand Associations.

4. From the list of associations for this service instance, identify the association withthese characteristics:

• Service Type - Oracle Database Cloud Service

• Type - Depends On

5. Click Manage Association for this association, and then select Update DatabaseCredentials.

6. Enter the username and password for the administrator for the selected databasedeployment.

7. Enter the new password in the New Schema Password field.

8. Click Update.

Back Up and Restore an Oracle Visual Builder InstanceYou can back up and restore your Oracle Visual Builder instances to return theirsoftware and data to a particular state.

Topics:

• About Backing up and Restoring Instances

Chapter 5Back Up and Restore an Oracle Visual Builder Instance

5-13

• Typical Workflow for Backing Up and Restoring an Instance

• Explore the Backup Page

• Configure Automated Backups for an Instance

• Initiate an On-Demand Backup of an Instance

• Delete a Backup

• Disable and Enable Backups for an Instance

• Restore an Oracle Visual Builder Instance from a Backup

About Backing up and Restoring InstancesBy backing up your Oracle Visual Builder instances, you can preserve them in aparticular state. If you later make configuration changes to a service that you don’twant, you can undo them by restoring the instance’s configuration data from a backup.

When you create an Oracle Visual Builder instance, you can choose whether or not toenable backups. These backups are recorded to local VM storage as well as to anOracle Cloud Infrastructure Object Storage Classic container.

The contents of a backup depend on whether it is a full backup or an incrementalbackup. A full backup contains all the runtime artifacts required to restore theinstance’s configuration data and An incremental backup contains changes toconfiguration data on all virtual machines since the last scheduled full backup.

Note:

All incremental backups are automated scheduled backups. You cannotcreate an incremental backup on demand.

A database backup contains Oracle database instance Oracle Fusion Middlewarecomponent schemas and application data for an Oracle Visual Builder instance. Bydefault, all scheduled automated backups of an Oracle Visual Builder instance includea database backup. .

Oracle Visual Builder stores all backups in an Oracle Cloud Infrastructure ObjectStorage Classic container. To speed up restorations from recent backups, OracleVisual Builder also keeps a local copy of any backup it has recently created.

Note:

Do not attempt to download the backup files generated by Oracle VisualBuilder. These files are encrypted and not accessible offline. You must useOracle Visual Builder to restore an instance from a backup.

By default, Oracle Visual Builder stores backups in the container that was specifiedwhen the instance was created. Oracle Visual Builder automatically deletes a backupwhen the retention period for the backup has elapsed.


5-14

Oracle Visual Builder stores local copies in a dedicated volume mounted on the blockstorage attached to the virtual machine where the Administration Server is running.

• For an incremental backup, Oracle Visual Builder stores the local copy for sevendays before deleting it.

• For a full backup, Oracle Visual Builder stores the local copy for seven days, or aslong as the local copy of its last related incremental backups was stored,whichever is longer.

After completing the day’s scheduled backup, Oracle Visual Builder deletes anybackups or local copies that are due to be deleted that day. If the scheduled backupfails because of insufficient space, backups and local copies that are due to be deletedwill still be deleted.

Note:

When an Oracle Visual Builder instance is deleted, all its backups aredeleted.

During a backup of an Oracle Visual Builder instance, the instance continues to runand all applications deployed to the instance remain available.

To prevent configuration changes during a backup, Oracle Visual Builder locks theOracle WebLogic Server domain if the administration server is running. After lockingthe domain, Oracle Visual Builder backs up files on each node. While the backup is inprogress, you cannot start any other management operation on the instance. Similarly,if the administration server is not running at the time a backup is started, do notattempt to start this server until the backup completes.

When the backup is complete, Oracle Visual Builder unlocks the Oracle WebLogicServer domain. If the backup is a scheduled backup, Oracle Visual Builder also cleansup older backups as follows:

• From local storage it deletes all backups old enough to be stored only in theOracle Visual Builder container.

• From all storage locations it deletes any remaining copies of backups whoseretention period has elapsed. The default is 30 days.

When restoration of an instance is initiated, Oracle Visual Builder shuts down theservers in the instance. After the restoration is complete, Oracle Visual Builder restartsthese servers.

If the backup’s topology and the instance’s current topology don’t match, how OracleVisual Builder handles the mismatch depends on the scenario.

If the instance contains any managed server nodes that are not in the backup, OracleVisual Builder warns you that it cannot restore these nodes. Before trying to restoreagain, you can scale in the instance to delete these nodes. If you choose to continuewithout scaling in the instance, Oracle Visual Builder asks you to confirm that youunderstand that the instance will be scaled in automatically.

If the backup contains any managed server nodes that are not currently in theinstance, Oracle Visual Builder does not attempt to remove these managed serversfrom the Oracle WebLogic Server domain. You must use the WebLogic Server to


5-15

manually remove these managed servers from the domain configuration after restoringthe instance.

Oracle Visual Builder does not automatically remove any existing Oracle WebLogicServer transaction records after restoring an instance from a backup. Therefore, youmust manually remove any transaction records after the restoration is complete.

Typical Workflow for Backing Up and Restoring an InstanceTo back up and restore an Oracle Visual Builder instance, consider this typicalworkflow.


Configure backups for an OracleVisual Builder instance

Customize the following properties ofbackups for a service instance:

• When automated backups areperformed

• Where backups are stored• How long new backups are

retained

Configure Automated Backups for anInstance

Initiate an on-demand backup of anOracle Visual Builder instance

Create a backup immediately withouthaving to wait for the next scheduledbackup.

Initiate an On-Demand Backup of anInstance

Delete a backup Delete a backup that you no longerrequire to release storage or preventan Oracle Visual Builder instancefrom being restored from the backup.

Delete a Backup

Restore an Oracle Visual Builderinstance from a backup

Undo configuration changes youdon’t want by returning an OracleVisual Builder instance to a particularstate.

Restore an Oracle Visual BuilderInstance from a Backup

Explore the Backup PageYou can use the Backup page to back up and restore an Oracle Visual Builderinstance, and to manage backups for the service instance.

Element Description

Backups on Cloud Storage The total amount of space, in megabytes orgigabytes, that backups are occupying in theOracle Cloud Infrastructure Object StorageClassic container for storing backups. Thisamount includes space that is occupied bybackups that have been manually uploaded tothe container, if any, in addition to the spaceoccupied by backups that Oracle VisualBuilder has moved there.

Backup Volume Used The total amount of space, in megabytes orgigabytes, that local copies of backups areoccupying in the backup volume on the blockstorage of the virtual machine where theAdministration Server is running.


5-16

Element Description

Backup Volume Used (%) The percentage of the available space thatbackups are occupying in the backup volumeon the block storage of the virtual machinewhere the Administration Server is running.

Incremental Backups Indicates the schedule for running incrementalbackups.

Full Backups Indicates the schedule for running fullbackups.

Most Recent Backup Indicates that the most recent backup failedand the time of its failure.

Last Successful Backup Indicates the time of the last successfulbackup.

Backup Now Click this button to create an on-demandbackup of the Oracle Visual Builder instance.

Configure Backups Click this button to update the backupschedule and where backups are stored.

Disable Backups or Enable Backups Click this toggle button to disable/enableautomated and on-demand backups.

Available Backups List of available backups. By default, onlybackups for the last seven days are listed. Usethe search field to specify a range of dates forwhich you want backups returned.

Enter the start date of the period for which youwant to filter the list of available backups or therestoration history. By default, the start date isset to seven days before the current date.

Enter the date in the format mm/dd/yyyy.

• mm is a one-digit or two-digit monthnumber, for example, 2 for February or 10for October.

• dd is a number in the range 1–31 for theday of the month.

• yyyy is a four-digit year number, forexample, 2104.

Alternatively, click the calendar icon to selectthe date from a calendar.


5-17

Element Description

Enter the end date of the period for which youwant to filter the list of available backups or therestoration history. Enter the date in the formatmm/dd/yyyy.

• mm is a one-digit or two-digit monthnumber, for example, 2 for February or 10for October.

• dd is a number in the range 1–31 for theday of the month.

• yyyy is a four-digit year number, forexample, 2104.

Alternatively, click the calendar icon to selectthe date from a calendar.

Note:

The end datemust not beearlier than thestart date.

Click to filter the list of available backups orthe restoration history to show only backups orrestorations from within the period specified bythe Search from Date field and the Search toDate field.

In-progress backup for the Oracle VisualBuilder instance. The backup will not beavailable for use in restoring the serviceinstance until it is completed.

The backup is identified by the date and timewhen the backup operation was started, whichis displayed adjacent to icon that representsthe backup.

Click the icon to see additional informationabout the backup.

Completed backup for the Oracle VisualBuilder instance. The backup is available foruse in restoring the service instance.

The backup is identified by the date and timewhen the backup was created, which isdisplayed adjacent to icon that represents thebackup.

Click the icon to see additional informationabout the backup, including its start date,complete date, expiration date and size. If adatabase backup is included, its tag ortimestamp is also displayed.


5-18

Element Description

Completed backup with a warning message.Oracle Visual Builder instance tried but failedto move or delete one or more older backups.For information about when and why OracleVisual Builder instance moves or deletes olderbackups. The backup is still available for usein restoring the service instance.

To find out why Oracle Visual Builder instancecould not move or remove the older backup,place the cursor over the icon.

The presence of the older backup may causefuture backups to fail because of insufficientspace.

The backup is identified by the date and timewhen the backup was created, which isdisplayed adjacent to icon that represents thebackup.


The backup is in the process of being deleted.


Type A comma-separated pair of words thatdescribes the type of the backup.

The first word in the pair describes the extentof the backup:

• Full—The backup contains all the runtimeartifacts required to restore the serviceinstance’s configuration data.

• Incremental—The backup containschanges to configuration data on all virtualmachines since the last scheduled fullbackup.

The second word in the pair indicates how thebackup was initiated:

• If the backup was initiated automatically atthe scheduled time, the text “scheduled" isdisplayed.

• If the backup was initiated by a user, theuser name of the user who initiated thebackup is displayed.

• If the backup was initiated in response toanother management operation by a user,the name of the user is displayed.

Available Until The date and time until which the backup willbe retained.


5-19

Element Description

Contains A row of up to two icons that indicates thecontent of the backup:•

—Indicates that the backup containsconfiguration files.

•—Indicates that the backup contains

database files. Place your mouse overthis icon for additional databaseinformation.

Notes Click the link to display the notes that wereprovided when the backup was created or therestoration was performed.

Menu icon provides the following options:

• Restore—Restore the Oracle VisualBuilder instance from the backup.

• Delete—Delete the backup.

Restore History (Last 7 Days) Click the triangle adjacent to this label todisplay a list of all the restoration operationson this service instance. By default, onlyrestoration operations for the last seven daysare listed. Use the search field to specify arange of dates for which you want restorationoperations returned.

Click Select to include unsuccessful restoreattempts to include the unsuccessfulrestoration operations in the list.

Completed restoration operation for the OracleVisual Builder instance.

The restoration operation is identified by thedate and time when it was started, which isdisplayed adjacent to icon that represents therestoration operation.

Click the icon to see additional informationabout the restoration operation.

In-progress restoration operation for theOracle Visual Builder instance.

The restoration operation is identified by thedate and time when it was started, which isdisplayed adjacent to icon that represents therestoration operation.

Click the icon to see additional informationabout the restoration operation.

Unsuccessful restoration attempt for theOracle Visual Builder instance.

The restoration attempt is identified by thedate and time when it was started, which isdisplayed adjacent to icon that represents therestoration attempt.

Click the icon to see additional informationabout the restoration attempt.


5-20

Element Description

From Backup The date and time when the backup fromwhich the service instance was restored wascreated.

Status The status of the restoration operation:

• Completed• In-Progress• FailedClick the text to see detailed status messagesfor the operation.

Contains A row of up to two icons that indicates theitems that were restored:

•—Indicates that binary files were

restored.•

—Indicates that configuration fileswere restored.

Configure Automated Backups for an InstanceYou can configure backups for an instance to customize when the Oracle VisualBuilder instance is automatically backed up and how backups are stored.

Because the changes affect only one service instance, you can configure differentvalues for these properties for each of your service instances. Specifically, you cancustomize the following properties of the service instance:

To configure automated backups for an Oracle Visual Builder instance:


2. In the Service Overview page, click the Administration tile.

3. Click the Backup tab.

The Backup page is displayed.


5-21

4. From the menu next to Available Backups, select Configure Backups.

5. In the Configure Backups dialog, set the options to configure automated backupsfor the service instance.

a. In the Schedule section, set options to configure when automated backups areperformed:

Note:

All times must be for the Coordinated Universal Time (UTC) timezone, not your local time zone.

Option Description

Full Backup From the drop-down lists, select the day of the week and thetime of day UTC when you want full backups to be performed.

IncrementalBackup

From the drop-down list, select the time of day UTC when youwant incremental backups to be performed.

b. In the Set new retention period to field, enter the number of days that youwant new incremental backups and full on-demand backups to be retained.


5-22

Note:

If you decrease the retention period, any existing backups that areolder than this period will automatically be deleted during the nextscheduled backup.

Full scheduled backups are retained until their last linked incremental backupis no longer available. The additional retention period for full scheduledbackups is fixed and you cannot change it.

6. Click Save.

Initiate an On-Demand Backup of an InstanceYou can create a full backup immediately without having to wait for the next scheduledbackup.

Create a backup when making major changes to your service instance, for example, inthese situations:

• Before any configuration changes that you may need to undo

• Before deploying an application

• After deploying an application

Note:

Do not to attempt to start the administration server while a backup is inprogress.

To initiate an on-demand backup of an Oracle Visual Builder instance:

1. In the Oracle Visual Builder Console, click the name of your Oracle Visual Builderinstance.





5-23

4. From the menu next to Available Backups, choose Back Up Now.

5. In the Back Up Now dialog box, enter the notes up to 255 characters of free-formtext to provide additional information about the backup.

This text is displayed in the Notes field for the backup in the list of availablebackups.

6. Click Back Up.

The Backup page is updated to show that the backup is in progress.While the backup is in progress, you cannot start any other management operation onthe service instance.

When the backup is complete, it is added to the list of available backups on theBackup page.

Delete a BackupYou can delete a backup that you no longer require to release storage or prevent anOracle Visual Builder instance from being restored from the backup.

You can’t delete a full backup with linked incremental backups without deleting theincremental backups. If the backup you’re deleting has linked incremental backups,Oracle Java Cloud Service asks if you want to delete both the full backup and itslinked incremental backups.

To delete a backup:





5-24


4. From the menu next to Available Backups, choose Delete.

5. When prompted, confirm that you want to delete the backup.

If the backup you’re deleting has linked incremental backups, Oracle VisualBuilder asks if you want to delete both the full backup and its linked incrementalbackups.

Disable and Enable Backups for an InstanceBackups in Oracle Visual Builder instance are enabled by default on a new serviceinstance but you can disable and enable this feature as required.

Backups are enabled on a service instance if you set the Backup Destination to avalue other than “None” when creating it. If your service instance does not yet have abackup configuration, you can manually add a backup configuration to the existinginstance after it’s provisioned.

After disabling backups for a service instance:

• Scheduled backups will not run.

• Automated backups will not run prior to patching or scaling operations.

• You cannot take an on-demand backup.

Disabling backups for a service instance does not affect any backups that were takenpreviously.




4. From the menu next to Available Backups, choose Disable Backups.

5. When prompted for confirmation click Disable Backups.

6. To enable backups again at a later time, return to the Backup page and clickEnable Backups.

Restore an Oracle Visual Builder Instance from a BackupYou can restore an Oracle Visual Builder instance from a backup to undo configurationchanges you don’t want and to return the instance to a particular state.

The instance’s configuration data is always restored, but you can also choose whetherto restore the Oracle WebLogic Server and the JDK software (binary files) to theircurrent official patch set update (PSU) level or to leave it unchanged. You may chooseto restore your instance to a previous PSU level in order to undo a change to thesoftware that you don’t want, for example:

• Some files in the software installation were accidentally deleted.

• A patch from a source other than Oracle Visual Builder instance was installed andthe software no longer works as required.


5-25

If you choose to restore the software, it is restored from an image maintained internallyto Oracle Cloud. If you are restoring from an old backup that contains a copy of thebinary files, the copy in the backup is not restored.

• If you have created a custom key store or trust store file in your instance for SSLrestoring the binary files may delete these custom files if you have not placed themin a recommended location.

If you backed up software that includes patches from a source other than OracleVisual Builder instance, those patches are not included in the restored software.

If the hosts in the backup and the instance don’t match, how Oracle Visual Builderinstance handles the mismatch depends on the cause of the mismatch.

The applications deployed to your instance will be unavailable during the restorationprocess. Therefore Oracle recommends that you disable any load balancer for theinstance before restoring a backup.

To restore an Oracle Visual Builder instance from a backup:





4. From the menu for the backup in the list of available backups, choose Restore.

You can restore an instance from an incremental backup without the need torestore the full backup to which the incremental backup is linked. Oracle VisualBuilder instance restores all the data from the linked full backup required for acomplete restoration of the instance.

5. Enter Notes up to 255 characters of free-form text to provide additional informationabout the restoration, such as, why you are restoring the instance.

6. Click Restore.

The Backup page is updated to show that the restoration is in progress. While therestoration is in progress, you cannot start any other management operation onthe instance.

When the restoration is complete, it is added to the restoration history in theBackup page.

Diagnose ProblemsOracle Visual Builder provides log files containing reports of an event, errors, warningmessages. You can diagnose problems using these log files.

Topics:

• Use WebLogic Server Logs

• Collect Database Statistics

Chapter 5Diagnose Problems

5-26

Use WebLogic Server LogsUse WebLogic Server Administration Console logs to diagnose errors.

To find the log files in WebLogic Server Administration Console:

1. Navigate to the Oracle Integration Cloud Instance Overview page.

2. Click the Menu icon and select Open WebLogic Server Console.

A new browser opens and you are redirected to the login page.

3. Enter the user name and password you provided when you created the serviceinstance.

4. In the Domain Structure area, expand Diagnostics.

5. Click Log Files.

The Log Files table is displayed.

6. Select the option to the left of the log file you want to view.

7. Click View.

The log file you selected is displayed in the table.

Note:

If you do not find the information you are looking for, click the Customizethis table link above the log file and select the Time Interval or use theother filter options available.

Collect Database StatisticsGather database statistics to diagnose performance problems by comparing statisticscaptured in a baseline to those captured during a period of poor performance.

See Gathering Database Statistics in Database Performance Tuning Guide.

Chapter 5Diagnose Problems

5-27

6Manage Instance Settings

After a Visual Builder instance is created, users with the role of Visual BuilderAdministrator can manage and set global options for applications in the instance andcreate associations between the instance and other services.

Topics:

• Manage Applications in the Service Instance

• Access Instance Settings

• Configure Security Options for Applications

• Set Page Messages for Access Denied Errors

• Allow Other Domains Access to Services

• Add a Connection for Fusion Applications Services

• Add a Connection to the Component Exchange

• Manage Self-signed Certificates

Manage Applications in the Service InstanceAn Oracle Visual Builder administrator can manage any application in the serviceinstance and does not need to be a team member to see an application on the Homepage. Administrators can perform all the tasks of a developer, including adding andremoving team members, and opening, staging and publishing applications.

The Home page displays a list of the applications in the service instance. Developerscan only see and manage an application when they are a member of the application’steam. Administrators can select the Administered by me checkbox if they want thelist of applications to include all the applications in the instance, even the applicationswhere they are not a team member. The checkbox is not visible to developers who donot have the role of administrator.

6-1

Note:

On the Home page for classic applications, administrators can select theApplications I administer checkbox in the Filter by pane to display theapplications where they are not a team member.

Access Instance SettingsAdministrators can access a page for managing the instance’s global settings. Thesettings page contains panels for configuring security settings, specifying AccessDenied messages and specifying Oracle Process Cloud Service details.

You can access the instance settings page from any Visual Builder page, but the stepsfor opening the page will depend on if you are developing visual applications or classicapplications.

To open an instance’s ettings page:

1. Click Home in the Visual Builder title bar to open the main menu.

2. Click Settings in the main menu.

If you are developing visual applications, open the main navigation pane on theHome page and select Settings.

Chapter 6Access Instance Settings

6-2

If you are developing classic applications, select Administer Visual Builder in theAdministration Options menu and then click Global Settings.

The settings available for the instance are grouped on the page.

Chapter 6Access Instance Settings

6-3

Configure Security Options for ApplicationsAdministrators can use the Security panel in the settings page to requireauthentication for all applications in the instance.

When an administrator enables the Allow only secure applications to be createdoption, all published and staged applications in the instance will require userauthentication. When the option is enabled, users must be assigned a role by theidentity domain administrator and log in to access an application. When the option isnot enabled, applications can be created that allow access to anonymous users.

When an application has the default security settings, any user with a valid login canaccess the pages in an application. A developer can modify the default securitysettings to define the roles that can access applications, pages and components.When the secure application option is enabled, an administrator can enable an optionthat users must be assigned the role of Visual Builder User in addition to any otherroles used to secure access to staged and published applications. For example,security can be configured so that users assigned the role Visual Builder Developercan access the designer but can’t access the published application and data becausethey are not assigned the role Visual Builder User.

To block access by anonymous users to all applications in the instance:

1. Open the instance’s settings page.

2. In the Security panel, enable Allow only secure applications to be created.

Anonymous users can’t access the applications when this option is enabled.

When the secure applications option is enabled, administrators can enable theOnly Visual Builder Users can access secure applications option.

Set Page Messages for Access Denied ErrorsAdministrators can use the instance’s settings page to specify a URL that users arenavigated to when they are denied access to an application or page.

Authenticated users might see an Access Denied page or message when they attemptto access an application or page in an application that their user role is not permittedto access. Administrators can set the default page or message that users see whenthey are denied access to an application or page. Access Denied messages that areset at the application level in the General Settings of an application will overridemessages set in the instance’s settings page. The default Access Denied page andmessage is used if the message options in this panel are not set.

To specify an Access Denied page or message for applications in the instance:


Chapter 6Configure Security Options for Applications

6-4

2. In the Security panel, type a URL that users are directed to when denied accessto an application.

The URL that you specify is used as the Access Denied page for all applications inthe instance and should be accessible to users who are not logged in.

Note:

If you are configuring settings for classic applications, the Access Deniedsettings are set in the Messages panel.

3. Type the message that you want users to see when they are denied access to apage.

The message that you enter will be displayed in the Access Denied page for allapplications in the instance except for those where a message was set at theapplication level in the application’s General Settings page.

Allow Other Domains Access to ServicesUse the Global Settings page to specify the domains that are permitted to interact withservices in your instance.

Cross-Origin Resource Sharing (CORS) is a mechanism that enables you to specifythe domains that are allowed to exchange data with applications in your instance. Bydefault, incoming requests from domains not on your instance’s list of allowed originsare blocked from accessing application resources.

To add a domain to the list of allowed origins:


2. In the Allowed Origins panel, click New Origin and type the URL of the domainthat you want to allow. Click Submit.

The Allowed Origins panel lists all origins that are permitted to retrieve informationfrom the instance.

Chapter 6Allow Other Domains Access to Services

6-5

Add a Connection for Fusion Applications ServicesThe list of REST services in the service catalog of visual applications is retrieved froma Fusion Applications service. The URL of the Fusion Applications service can bespecified in the Tenant Settings dialog box or in the Settings dialog box of a visualapplication.

All visual applications in the tenant space will use the Fusion Applications base URLspecified in Tenant Settings, but a visual application can be configured to use adifferent Fusion Applications service by specifying its URL in the application’s Settingsdialog box. The URL in Tenant Settings is ignored if a URL is specified in a visualapplication’s Settings dialog box.

To specify a Fusion Applications service for the tenant:


2. Enter the base URL of the Fusion Applications service.

When specifying the URL in the Tenant Settings, the administrator only needs toprovide the base URL of the Fusion Applications service to retrieve the list ofservices. The URL in the Settings dialog box for a visual application requires thefull path to the interfaceCatalogs endpoint for retrieving the list of services.

Add a Connection to the Component ExchangeThe service admin can add a connection to a Component Exchange instance bysupplying the location and credentials for accessing it in the Tenant Settings.

Access to the Component Exchange is automatically enabled by supplying the URLand credentials for the Component Exchange. When access is enabled, developerscan access Application Templates available in the exchange when creatingapplications, and components in the exchange can be added as custom componentsin the Component palette.

Chapter 6Add a Connection for Fusion Applications Services

6-6

Depending on the location of your instance, you can use the following details foradding the connection. If your instance is in the US, use the following details.

Field Value

URL https://devinstance4wd8us2-wd4devcs8us2.uscom-central-1.oraclecloud.com/profile/devinstance4wd8us2-wd4devcs8us2/s/devinstance4wd8us2-wd4devcs8us2_compcatalog_3461/compcatalog/0.2.0

Username comp.catalog

Password bXwphh6RMFjn#g

If your instance is in Europe, use the following details.

Field Value

URL https://devinstance4wd8em2-wd4devcs8em2.eucom-north-1.oraclecloud.com/profile/devinstance4wd8em2-wd4devcs8em2/s/devinstance4wd8em2-wd4devcs8em2_compcatalog_1681/compcatalog/0.2.0

Username comp.catalog

Password !!MWtu4jsQ56wM

To add a connection to the Component Exchange:

1. Open the instance’s Tenant Settings page.

2. In the Component Exchange panel, enter the URL and credentials for thecomponent exchange.

It is recommended that the credentials you provide are for a service admin. Theadmin also needs to be a member of the DCS project that hosts the ComponentExchange.

Chapter 6Add a Connection to the Component Exchange

6-7

https://devinstance4wd8us2-wd4devcs8us2.uscom-central-1.oraclecloud.com/profile/devinstance4wd8us2-wd4devcs8us2/s/devinstance4wd8us2-wd4devcs8us2_compcatalog_3461/compcatalog/0.2.0




https://devinstance4wd8em2-wd4devcs8em2.eucom-north-1.oraclecloud.com/profile/devinstance4wd8em2-wd4devcs8em2/s/devinstance4wd8em2-wd4devcs8em2_compcatalog_1681/compcatalog/0.2.0




Manage Self-signed CertificatesAdministrators can use the Certificates page to upload and manage the self-signedcertificates used by the instance to enable inbound and outbound SSLcommunications to a service’s REST APIs

When creating connections to REST services that use self-signed certificates, youmight need to add an API’s certificate to your Visual Builder instance to validate SSLconnections to that service. You can use the Certificates page to upload and removecertificate files (.pem) for services. Uploading a service’s certificate file to the keystorewill allow all applications in the instance to communicate with that service. TheCertificates page displays a list of certificates that have been added. You can click theDelete button in a row to remove the certificate.

To upload a self-signed certificate:

1. Open the Visual Builder main menu and click Certificates.

The Certificates page displays a list of the certificates already uploaded to theinstance.

2. Click Upload to open the Upload Certificate dialog box.

You use the Upload Certificate dialog box to create an alias for the certificate andupload the service’s certificate file from your local system.

Chapter 6Manage Self-signed Certificates

6-8

3. Type the alias in the Certificate Alias Name field.

The alias is used to identify the certificate in the table in the Certificates page. TheCertificate Type dropdown list is read-only because only Trust Certificates aresupported.

4. Drag the certificate file from your local system into the upload target area, or clickthe upload target area to browse your local system.

5. Click Upload to add the certificate to the service keystore.

Chapter 6Manage Self-signed Certificates

6-9

Administering Oracle Visual Builder Classic (User-Managed) · 2019-09-17 · 2 Getting Started To...

Documents

Transcript of Administering Oracle Visual Builder Classic (User-Managed) · 2019-09-17 · 2 Getting Started To...