Java Fundamentals

Faculty Quick Start Guide

X95176GC10
Edition 1.0 | October 2016

Learn more from Oracle University at oracle.com/education/

Authors Copyright © 2016, Oracle and/or its affiliates. All rights reserved.

Nick Ristuccia Disclaimer

Eric Jendrock This document contains proprietary information and is protected by copyright and
Michael Williams other intellectual property laws. You may copy and print this document solely for
your own use in an Oracle training course. The document may not be modified or
Luz Elena Peralta Ayala altered in any way. Except where your use constitutes "fair use" under copyright
law, you may not use, share, download, upload, copy, print, display, perform,
Eduardo Moranchel Rosales
reproduce, publish, license, post, transmit, or distribute this document in whole or in
part without the express authorization of Oracle.
Editors The information contained in this document is subject to change without notice. If
Aishwarya Menon you find any problems in the document, please report them in writing to: Oracle
University, 500 Oracle Parkway, Redwood Shores, California 94065 USA. This
Nikita Abraham document is not warranted to be error-free.
Raj Kumar
Restricted Rights Notice
Vijayalakshmi Narasimhan
Aju Kumar If this documentation is delivered to the United States Government or anyone using
the documentation on behalf of the United States Government, the following notice
is applicable:
Graphic Designer
U.S. GOVERNMENT RIGHTS
Maheshwari Krishnamurthy The U.S. Government’s rights to use, modify, reproduce, release, perform, display,
or disclose these training materials are restricted by the terms of the applicable
Oracle license agreement and/or the applicable U.S. Government contract.
Publishers
Trademark Notice
Giri Venugopal
Srividya Rameshkumar Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other
names may be trademarks of their respective owners.
Raghunath M
Table of Contents

Introduction to the Cloud Environment for the Course ............................................................................... 4

Basic Steps for Setting up an Identity Domain for a Course ..................................................................... 4
Definitions................................................................................................................................................. 4
Identity Domain Limits.............................................................................................................................. 5
Identity Domain Administrator Account Setup ............................................................................................ 6
Account Setup Email ................................................................................................................................. 6
Setup Your Account .................................................................................................................................. 6
Configuring an Identity Domain for Students............................................................................................... 7
Setting Up a User ...................................................................................................................................... 7
Setting Up Projects.................................................................................................................................... 7
Add Users to Each Project......................................................................................................................... 8
Add a Git Repository for Each Student ..................................................................................................... 8
Developer Cloud Service Configuration.................................................................................................... 9
Monitoring Cloud Resource Usage ............................................................................................................. 10
Application Container Cloud Service....................................................................................................... 10
Developer Cloud Service ......................................................................................................................... 10
Troubleshooting Tips .................................................................................................................................. 11
Problem: Users cannot deploy applications to ACCS.............................................................................. 11
Solution: Set the Replication Policy. ....................................................................................................... 11
Problem: DevCS tab does not show up in the Dashboard. ..................................................................... 11
Solution: Use a direct DevCS URL. .......................................................................................................... 11

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

Faculty Quick Start Guide for Oracle Cloud Courses 3

Introduction to the Cloud Environment for the Course
This is a configuration guide for instructors and cloud administrators. What follows is a step by step
guide for setting up student accounts for use with the cloud workforce training courses.

Basic Steps for Setting up an Identity Domain for a Course

Here are the basic steps for setting up an identity domain for a workforce cloud course.

1. Set up an Identity Domain Administrator

2. Add users to the identity domain.
3. Assign roles to the user accounts.
4. Create projects for the identity domain.
5. Assign users to a project.
6. Create a git repository for each user.

That's it. The sections that follow provide greater detail on these steps.

Definitions
Here are some of the key terms used in this configuration guide.

• Identity Domain - An identity domain is a grouping of accounts and cloud services that students
will use to complete a course. All student accounts are contained in an identity domain.
• Identity Domain Administrator (Admin) - An instructor or cloud administrator that sets up an
identity domain to be used for cloud workforce training courses.
• Developer Cloud Service (DevCS) - Developer Cloud Service provides tools for managing the
software development process. Tools include:
o Git repositories for source code management
o Wikis for documentation
o Automated build and deployment tools
o Issue tracking and code management
• Project - All DevCS activities are contained in a project. A project is composed of development
artifacts including Git repositories, wikis, and student accounts. For the identity domains used in
workforce training, there is a maximum of 3 projects per identity domain. Each student account
is assigned to one project. All artifacts in a project are shared.
• Student Account - The account a student will use to perform the cloud based labs. Each account
is identified by first name, last name, and email address.
• Oracle Application Container Cloud Service (ACCS) - The application cloud service that students
deploy their cloud application to. ACCS is a cloud service based on Docker that supports multiple
programming languages and environments.
• Storage Cloud Service - The file storage service for Oracle Cloud Services. The service is not used
directly in the courses.

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

Faculty Quick Start Guide for Oracle Cloud Courses 4

 • Compute Cloud Service - A service that is a back end of most Oracle Cloud Services. The service
is not used directly in the courses.

Identity Domain Limits

The identity domain accounts used in this program have some limitations. The following is a list of key
limitations for each identity domain.

• A maximum of 3 DevCS projects per identity domain.

o Every student account is assigned to 1 private project.
o Students can only see artifacts in the projects they are a member of.
o For ease of use and security, assign 1 person to each project. This means there are 3
students per identity domain.
• A maximum of 16 ACCS instances per identity domain.
o With 16 instances there is a maximum of 16 unique applications that can run
simultaneously.
o Therefore, each student can run a maximum of 5 instances at one time.
• All student accounts have administrator rights to ACCS.
o This means any student can delete any other student's running application.
o Students need to be aware of this and encouraged to play nice.
• A maximum of 3GB of disk storage for the entire identity domain.
o Given the small size of the project source code, this would seem an unlikely limit to hit.
o However, with the automation of builds and deliverables the amount of disk space used
can grow quickly.

Note: The above limits are true as of October 2016. Because Oracle Cloud Services is constantly
changing, these numbers should be checked and updated on a regular basis.

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

Faculty Quick Start Guide for Oracle Cloud Courses 5

Identity Domain Administrator Account Setup
As the identity administrator, you will configure the identity domain for students to use. The first step in
the process is for you to set up your own account.

Account Setup Email

The first step in the process is you receive an email message welcoming you to Oracle Cloud service. The
email contains:

• Your user name. This is your email address.

• Your temporary password.
• The identity domain. (e.g., ouopcXXX)
• Your data center ID. (e.g., em2)

Write down all of this information. You will need it later for login and configuration.

At the bottom of the email is a link to access the account. Use that link in the next section.

Setup Your Account

Next, click on the link in the e-mail and setup your account. You are prompted for the following:

• Enter your temporary password.

• Enter a new password.
• Repeat the new password.
• Answer three security questions.
• Click Submit.

After this you should be logged into the Oracle Cloud Services dashboard. The dashboard will display all
the Oracle Cloud services available to you. As an identity domain admin you will have access to the
following cloud services.

• Developer Cloud Service

• SOA Cloud Service
• Compute Cloud Service
• Oracle Database Cloud Service
• MySQL Cloud Service
• Storage Cloud Service
• Oracle Application Container Cloud Service

Students will not have access to all of these services.

You will receive two more emails after initial setup.

• A second email to verify your email address.

• A third email to welcome you to Oracle Cloud Services.
Copyright © 2016, Oracle and/or its affiliates. All rights reserved.

Faculty Quick Start Guide for Oracle Cloud Courses 6

Configuring an Identity Domain for Students
With your admin account setup, you can now add the students to the identity domain. The following
steps detail setting up a user using the UI. You can add users using a comma separated list if you wish.
However, assigning roles can only be accomplished with the UI.

Setting Up a User
Follow these steps to add a user to an identity domain. You must be logged in as an identity domain
administrator to perform these steps.

• Log in to Oracle Cloud Services using your identity domain admin account.
• In the main dashboard, click the Users button. The User management page shows up.
• Click Add.
• Enter the following form data:
o First Name
o Last Name
o Email address
o Manager email address (Optional)

Note: The user name does not have to be the email address. There is a check box that
allows this. We recommend using the email address as the user name.

• Click the Advanced Role Selection option.

• Select the following roles for the user:
o APAAS APAASAdministrators
o Storage Storage Administrator
o Storage Storage Read Only Group
o Storage Storage Write Only Group
o developerXXXXX Developer Service User Role
• Click Add.
• Repeat this process for each user that you want to add to the identity domain.
• Click the Dashboard button to return to the main dashboard.

Note: Only use the Advanced Role Selection option. The Simple Role Selection option can cause issues
if mixed with the Advanced options per the documentation. Therefore, only used Advanced.

Setting Up Projects
The next step is to set up the projects.

• In the main dashboard, select the Developer option.

• Click Open Service Console.
• In the main DevCS page, click on New Project.
Copyright © 2016, Oracle and/or its affiliates. All rights reserved.

Faculty Quick Start Guide for Oracle Cloud Courses 7

 • On the details page:
o Enter a project name: Project 1
o Enter a description: Project 1
o Security: Private
o Preferred Language: Take Default
• Under Template, select Empty Project.
• Under Properties, select the default of Textile.
• Click Finish. It may take several minutes for the project to be set up.
• Repeat the above steps for Project 2 and Project 3.

Add Users to Each Project

With the projects setup, you can now add users to each project. Add one user to each project. Because
the projects were set up as Private, this limits students to only have access to the source code in their
project. This provides a degree of security for development.

To add a user to a project, do the following:

• Navigate to the main DevCS page. Click the Developer Cloud Service text at the top of the page
— or if you are back in the dashboard, open the service console for the service.
• Click the project you wish to update.
• On the right side of the screen there are three tabs. Click the third tab from the top. The team
list is displayed.
• Click the New Member button.
o Select Member for the role
o Select the user name from the drop-down list.
o Click Add.
• Repeat the above process for the other two projects.

Add a Git Repository for Each Student

The last step in the setup process is to create a git repository for each student.

• Navigate to the main DevCS page. Click the Developer Cloud Service text at the top of the page
— or if you are back in the dashboard, open the service console for the service.
• Click the project you wish to update.
• On the right side of the screen there are three tabs. Click the top tab. The repository list is
displayed.
• Click New Repository.
o Name: FirstnameLastinitialRepo (e.g., Jane Doe would be JaneDRepo)
o Description: First Name Last Name's Repository

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

Faculty Quick Start Guide for Oracle Cloud Courses 8

 o Initial Content: Empty Repository
o Click Create.

Note: It is important you use the empty option. The student adds a pre-existing
xisting repository
to the cloud repository..

• The repository is created.

• Repeat these steps for each student in each project.

Developer Cloud Service Configuration

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

Faculty Quick Start Guide for Oracle Cloud Courses 9

Monitoring Cloud Resource Usage
For these courses there are two main places you can monitor resource usage for your services. You must
be logged in your admin account for the DevCS options.

Application Container Cloud Service

The monitoring options are on a per application basis. For overall analysis, just open the service console
and look at the main application list. That will show you what applications are deployed, the number of
instances, and the size of the instances.

Developer Cloud Service

To monitor the disk usage of your projects, do the following:

• Click the project drop-down list that allows you to switch between projects.
• Click the pencil icon in the upper right corner of the dialog.
• Click the Projects icon.

The page shows the amount of disk usage by project. Click show details to see which tools are using the
most space.

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

Faculty Quick Start Guide for Oracle Cloud Courses 10

Troubleshooting Tips
Here are some troubleshooting tips you may find helpful.

Problem: Users cannot deploy applications to ACCS.

Users get an error when trying to deploy applications even though everything seems to be setup right.

Solution: Set the Replication Policy.

To use ACCS you have to configure a replication policy for Storage Cloud Service. To do this:

• In the dashboard, click Storage.

• Click the hamburger menu (in the top left of many pages, it looks like this ) and select
Set Replication Policy.
• Select your current data center for replication.

Chances are a replication policy has already been set for your identity domain and you will never have to
do this. However, this solution is not obvious given the behavior described in the problem statement.

Problem: DevCS tab does not show up in the Dashboard.

When a student logs into the identity domain, the Developer Cloud Service tab does not show up in the
dashboard. Therefore, there is no way for the student to navigate to DevCS.

Solution: Use a direct DevCS URL.

Sometimes this problem will resolve itself after a couple of hours. If it does not, give the student a
direct URL to their Developer Cloud Service. You can get this URL from your Admin dashboard or create
the URL using the following information:

https://developer.em2.oraclecloud.com/developerXXXXX-IdentityDomainName/

Where XXXXX is the number of your DevCS instance and IdenityDomainName is the name of your
identity domain.

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

Faculty Quick Start Guide for Oracle Cloud Courses 11