Bug 1769802

Sahara mentions from OSP15 portal search:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html/overcloud_parameters/clustering-sahara-parameters

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/external_load_balancing_for_the_overcloud/index#sahara

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/firewall_rules_for_red_hat_openstack_platform/index#sahara_api

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html/bare_metal_provisioning/sect-baremetal-instances

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/openstack_data_processing/index

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/logging_monitoring_and_troubleshooting_guide/index#data_processing_sahara_log_files

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html/openstack_integration_test_suite_guide/chap-install-tempest#sec-list-of-plugins

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html/openstack_data_processing/createhadoopimg

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html/package_manifest/ch02

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html/upgrading_red_hat_openstack_platform/assembly-preparing_for_overcloud_upgrade#preparing_for_composable_networks

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/storage_guide/index#ch-intro-persistent

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/openstack_integration_test_suite_guide/index#sec-install-tempest-packages

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/product_guide/index#sect-components

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/external_load_balancing_for_the_overcloud/index#sahara

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/advanced_overcloud_customization/index#sect-Enabling_Disabled_Services

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/14/html-single/director_installation_and_usage/index#sect-Overcloud

One more from a manual search that didn't sow up on the portal search:
https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/14/html-single/command_line_interface_reference/index
There may be more.

Also, per gcharot's suggestion, we should look for diagrams that include Sahara. The graphics team would need to rework diagrams that include Sahara, this work can take time to organize and carry out.

Hi Luigi, 
This script-generated guide [1] includes the following the line: "This command is provided by the python-saharaclient plugin." 

Do you know if it should be taken out of the code somewhere? (because if we rerun the script it will pull the contents from the code)

Or, should it remain in the guide as is?

[1] https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/15/html-single/command_line_interface_reference/index

Thanks,
Naomi

(In reply to ndeevy from comment #4)
> Hi Luigi, 
> This script-generated guide [1] includes the following the line: "This
> command is provided by the python-saharaclient plugin." 
> 
> Do you know if it should be taken out of the code somewhere? (because if we
> rerun the script it will pull the contents from the code)

All the "openstack dataprocessing foo" commands come from python-saharaclient, which means that the entire chapter 30 should disappear.
From a technical point of view, if I read the script correctly, it extracts the documentation from all available commands, but the -fooclient packages may be available even when the service is not. My suggestion is to talk with the script's author(s) and implement a blacklist mechanism. For example, also all the "openstack database foo " commands (from python-troveclient) should not be there.

+1 on Luigi suggestion if possible.

Content updated in 16.0-Beta guides.

Hi,


I still see the data processing doc[1] available for osp16.0, and it doesn't say sahara was removed in osp16,
but still says "sahara is targeted for removal in osp16".
 
~~~
 The Data Processing service (sahara) is deprecated in OpenStack Platform version 15 and is targeted for removal in version 16. 
~~~

[1] https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.0/html/openstack_data_processing

IMO we should remove the doc if we don't support sahara, or at least update that description.
Could you again check the above documentation ?

Thank you,
Takashi

(In reply to Takashi Kajinami from comment #8)
> Hi,
> 
> 
> I still see the data processing doc[1] available for osp16.0, and it doesn't
> say sahara was removed in osp16,
> but still says "sahara is targeted for removal in osp16".
>  
> ~~~
>  The Data Processing service (sahara) is deprecated in OpenStack Platform
> version 15 and is targeted for removal in version 16. 
> ~~~
> 
> [1]
> https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.
> 0/html/openstack_data_processing

In fact that guide should be completely removed from the 16 documentation.

Hi Luigi,

Thanks for your quick confirmation.
Do you want me to file another bugzilla to remove the doc,
or will we reopen this bug to manage that removal ?

Thank you,
Takashi

@Takashi,

The Release Notes are updated to reflect Sahara is removed in 16.0, and the OpenStack Data Processing guide is removed from the docs splash page.

Hi Chuck,

Thanks for the update. I confirmed that the Data Processing guide is removed from index page.

However, I still the documentation itself[1] is still alive.
 [1] https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.0/html/openstack_data_processing/index

Will we remove the doc completely ? 

If we don't does it make sense to update the following note in Chapter 1, 
~~~
The Data Processing service (sahara) is deprecated in OpenStack Platform version 15 and is targeted for removal in version 16. 
~~~
so that it clearly mentions that we don't support sahara any more, like;
~~~
The Data Processing service (sahara) is not more supported since OpenStack Platform version 16.
~~~
just in case some users directly land to the document ?

I'm afraid it would be possible that the users find the 16 data processing guide
after they find 15 one and change the version in url, as some users do to find the correct version doc.

Thank you,
Takashi

I confirmed that the 16 guide is now completely removed.