9.2.5.4 ahfctl setupload

Use the ahfctl setupload command to set upload parameters.

AHF 23.8

Starting in AHF 23.8, you will be able to upload AHF Insights report automatically if Object Store is configured as part of AHF. Uploading AHF Insights reports helps Oracle Cloud Operations to identify, investigate, track, and resolve system health issues and divergences in best practice configurations quickly and effectively.

Oracle Autonomous Database on Dedicated Exadata Infrastructure and Oracle SaaS

To set REST endpoints (Object Store's), run:
ahfctl setupload -name oss -type https -user <user> -url <object_store> -password
To upload AHF Insights report to Object Store, run: 
ahf analysis create --type insights
.

You can run the setupload command as root or a non-root user.

Syntax

ahfctl setupload 
[-h][--help] 
[-all] 
[-type TYPE] 
[-name NAME] 
[-user USER]
[-password] 
[-server SERVER] 
[-url URL]
[-proxy PROXY]
[-noauth NOAUTH]
[-https_token HTTPS_TOKEN]
[-request REQUEST]
[-header HEADER] 
[-secure SECURE]
[-connectstring CONNECTSTRING]
[-uploadtable UPLOADTABLE]
[-port PORTNUMBER]

Parameters

Table 9-21 ahfctl setupload Command Parameters

Parameter Description

all

All of the parameters.

type

Specify the type of an endpoint. For example, https, sftp, or sqlnet.

name

Specify a unique descriptive name to your configuration. For example, mosconfig to upload to My Oracle Support.

user

Specify the user who has the privileges to access the endpoint. For example, upload.user@example.com.

password

If this option is passed, AHF will prompt you to enter the password.

You can also set the password using the environment variable AHF_SERVICE_PASSWORD. For example: $ export AHF_SERVICE_PASSWORD="user_password"

server

Specify the name of the server to which you want to upload files. For example, bugsftp.example.com.

url

Specify the target URL to upload files in case of HTTPS type. For example, https://samplehost.com.

proxy

Specify the URL of the proxy server. For example, www.example.com:80.

noauth

Specify true and false. Default value is false.

If noauth is set to true, then HTTPS upload will skip authentication.

For example, upload files to PAR, Pre Authenticated URL where no user/password authentication is required.

request

Specify the request type, for example, POST.

https_token

Specify any static header values while configuring. For example, set auth tokens while configuring the HTTPS end point.

For example, ahfctl setupload -name config -type https -https_token 'abc:13'.

You can also pass dynamic headers at upload time by passing the -https_token headers command option to tfactl upload command.

For example: -H 'X-TFA-REQUESTID: 1'.

header

Stores the executionId in the ahf.properties file.

For example, to set the header:ahfctl setupload -name a1 -type https -header X-TFA-HEADERS:executionId=aeldb1db01_2020.06.16_19.20.55.15336025

secure

Specify true or false. Default value is true.

Specifying the secure value checks for certificates.

If secure is set to false, then the upload command will run an unsecure upload.

connectstring

Specify the database connect string to log in to the database where you want to upload files.

For example, (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = host)(PORT = 1521))(CONNECT_DATA =(SERVER = DEDICATED)(SERVICE_NAME = orcl))).

uploadtable

Specify the name of the table where you want to upload files as BLOB type.

For example, for uploading Oracle Orachk collections to the Collection Manager, it is set to RCA13_DOCS.

port

Specify a custom port number. If you do not specify a port, then 443 is used by default. You can set a port number in the range of 0 - 65353.
To setup MOS configuration:
ahfctl setupload -name mos -type https -user sample_user@domain.com -url https://transport.oracle.com/upload/issue
To set proxy for MOS configuration:
ahfctl setupload -name mos -type https -proxy www-proxy.server.com:80
To set a custom port:
ahfctl setupload -name my_upload -type https -url 'https://samplehost.com' -https_token "abc:13" -header Content Type:application/json -port 4545
To upload to MOS using tfactl upload:
tfactl upload -name mos -id 3-23104325631 -file /opt/oracle.ahf/data/repository/auto_srdc_ORA-00600_20200706T18:58:09_myserver1.zip
To upload to MOS using tfactl diagcollect:
tfactl diagcollect -upload mos -srdc ORA-00600 -id 3-23104325631
or
tfactl diagcollect -srdc ORA-00600 -sr 3-23104325631

Note:

Ensure that the configuration name is mos.

Parent topic: Running AHFCTL Upload Commands to Upload Diagnostics