Uploading large files to a Service Request using the command line in Solaris, Linux, MacOS and Windows

Asset ID:	1-71-1682567.1
Update Date:	2016-11-14
Keywords:

Solution Type Technical Instruction Sure

Solution 1682567.1 : Uploading large files to a Service Request using the command line in Solaris, Linux, MacOS and Windows

Applies to:

My Oracle Support - Version 2.0.2 and later
Oracle Exalogic Elastic Cloud X2-2 Hardware - Version X2 to X2 [Release X2]
Information in this document applies to any platform.

Goal

This documented is intended as quick instructions for uploading from Solaris to Service Requests (SRs). For more complete information see: Oracle Support Document 1547088.2 (Oracle Support File Uploads) can be found at: https://support.oracle.com/epmos/faces/DocumentDisplay?id=1547088.2

Solution

REQUIREMENTS TO UPLOAD

MY ORACLE SUPPORT USER ID WITH CREATE AND UPDATE SERVICE REQUEST PERMISSIONS:

Create and Update SR permissions must be granted by the appropriate Customer User Administrator (CUA) for each Support Identifier to users wishing to upload files
For reactive SR file uploads the Support Identifier must be in the same organization as the Support Identifier associated with the Service Request

SW REQUIREMENTS TO UPLOAD:

MOS File upload supports various methods for upload. HTTPS and FTPS. On Solaris, Diagnosis Assistant is a java client that supports upload via HTTPSand is included with the Service Tools Bundle. In addition, cURL can be used for both HTTPS and FTPS file uploads.

Option 1: Diagnostic Assistant (DA):

Diagnostic Assistant is included with Remote Diagnostic Agent (RDA) and Service Tools Bundle (STB), which includes RDA. For upload to transport, version 8.02 or later of STB is needed.

For more information about Service Tools Bundle for Solaris (including how to acquire), please see:
Oracle Support Document 1153444.1 (Oracle Services Tools Bundle (STB) - RDA/Explorer, SNEEP, ACT)
Once installed the location of the DA command is:
- /usr/lib/rda/da/da.sh

Option 2: cURL:

Solaris 11 / Linux / Mac OS X

cURL is installed by default on Solaris 11, most distributions of Linux and Mac OS X

Its location is /usr/bin/curl

Solaris 10 and earlier

For Solaris 10 and earlier, cURL is included with Explorer 8.03 and later

Oracle Support Document 1153444.1 (Oracle Services Tools Bundle (STB) - RDA/Explorer, SNEEP, ACT)
With explorer installed, cURL can be found at:

SPARC - /opt/SUNWexplo/bin/solaris/curl.sparc
x86/x64 - /opt/SUNWexplo/bin/solaris/curl.x86

Windows

cURL can be found at http://curl.haxx.se/download.html

Location of executable depends on package used for install

CONNECTION REQUIREMENTS

Ability to connect, via the internet, to transport.oracle.com
FTPS - Oracle's FTPS service is a "passive" implementation. In a passive FTPS service the initial connection is from the client to the service on a control port of 990 and the connection is then switched to a high port to exchange data. Oracle defines a possible range of the data port of 32000-42000 and depending upon your network configuration you may need to explicitly allow outbound connections on both port 990 and 32000-42000.
HTTPS - Oracle’s HTTPS diagnostic upload service uses the standard HTTPS port of 443 and does not require any additional ports to be opened.

If your firewall limits communication by target IP address, you may want to perform a lookup for the addresses of these hostnames. However, keep in mind that Oracle reserves the right to change the IP addresses of these hostnames.

INSTRUCTIONS FOR UPLOADING FILES

Using Diagnostic Assistant (DA)

DA 2.2 (included w/ RDA/Explorer/STB 8.02 and later) now supports uploads via https to MOS File Upload Service

DA can be used either via menus, explorer (Solaris only), or the command line to upload

Run diagnostic assistant menu:
1. /<linux/solaris rda home>/da/da.sh menu or
2. If installed from STB this will be:
3. /usr/lib/rda/da/da.sh menu
4. Select: 3 RDA, OCM, ADR, SR Creation/Packaging, and MOS Tools
5. Select: 4 Package, Upload Diagnostic Files
6. Select: 7 Upload File Package To SR
  You will then be prompted for your SR, credentials, and the file

To use DA to do a command line upload:
da.sh upload -p sr=<SR Number> file=<path to file>

NOTE: Where it says "<sr_number>” and “<path to file.”, do no include the "<>"

To use DA to upload with explorer
explorer -w default -T DA -SR <SR number>

Setting a proxy for DA

DA supports setting a proxy. DA stores the proxy information and you only have to do this once.

Run diagnostic assistant menu:
If installed from from RDA install
1. /<linux/solaris/macos rda home>/da/da.sh menu or
2. \<location where unzipped>rda\da\da.cmd on Windows or
If installed from STB this will be:
1. /usr/lib/rda/da/da.sh menu
Select: 2 Admin, Manage Properties, Versions, Latest Collections
Select: 2 User Property Management
Select: 2 Set/Change a user property
Select 4 and 5 to set the proxyHost (ip address or host name) and proxyPort (port number)

For more information on DA see:
Oracle Support Document 201804.1 (Diagnostic Assistant: General Information)

Using cURL

HTTPS SR File Upload Example:

$ curl -T <path_to_file> -o <output filename> -u "<user>" "https://transport.oracle.com/upload/issue/<sr-number>/"

NOTE: Where it says "<sr_number>", only include the SR number, not the "<>" and be sure to include the final "/"

Or if you choose to add the file name this will also work:

$ curl -T <path_to_file> -o <output filename> -u "<user>" "https://transport.oracle.com/upload/issue/<sr-number>/<filename>"

NOTE: Where it text is in <>, don't include those characters ex.: "<sr_number>", only include the SR number, not the "<>"

FTPS SR File Upload Example:

$ curl -T <path_to_file> -u "<user>" ftps://transport.oracle.com/issue/<sr_number>/

References

<NOTE:1153444.1> - Oracle Services Tools Bundle (STB) - RDA/Explorer, SNEEP, ACT
<NOTE:1596914.1> - My Oracle Support - How To Series -> How to Upload and Attach Files to Service Requests Using Three Options [ Video ]
<NOTE:1547088.2> - How to Upload Files to Oracle Support
<NOTE:201804.1> - Diagnostic Assistant: Information Center

Attachments

This solution has no attachment