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, [e-mail].
password	Specify the password of the user.
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 [e-mail] -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.