Update NERC Documentation (MB/GB/TB -> MiB/GiB/TiB)

[joachimweyl]

Motivation

currently we are displaying MB/GB/TB when technically we are using MiB/GiB/TiB.

Completion Criteria

Update customer facing documents to display what we are actually using.

Description

• [x] Update Invoicing Requirements
• [x] Update Calculator
• [x] Update ColdFront Quota Attributes for OpenStack and OpenShift along with SU label
• [x] Update NERC Web documents

Completion dates

Desired - 2024-05-29 Required - TBD

[knikolla]

For storage, we are charging based on quota.

For object storage, we are setting the quota[0] per GB.

For volume storage, we are setting the quota on GiB for both OpenStack[1](as that is the only unit accepted) and OpenShift[2].

When it comes to charging, the advertised price in the docs is written per TB. Until now, I have been dividing that price of $0.009 by 1000 to come up for the per GB value.

That means that for object storage we are charging per TB of storage with the advertised price of $0.009/TB, whereas for volume storage we are charging $0.009/1000GiB.

We should update the documentation and investigate a path to consistency.

0. https://github.com/nerc-project/coldfront-plugin-cloud/blob/ae311f876143a78ad822f6398ad37b134283279f/src/coldfront_plugin_cloud/openstack.py#L22
1. https://docs.openstack.org/api-ref/block-storage/v3/#show-quota-classes-for-a-project
2. https://github.com/nerc-project/coldfront-plugin-cloud/blob/ae311f876143a78ad822f6398ad37b134283279f/src/coldfront_plugin_cloud/openshift.py#L15-L16

[knikolla]

@joachimweyl @Milstein Let me know if I captured correctly the outcome of May 22, 2024 meeting

• Pricing advertised in rates page is per TiB rather than per TB, so the price per GiB is adjusted to $0.009/1024 from $0.009/1000 that it currently is in the billing scripts.
• We should move to GiB for object storage too. Need to create an issue to capture this code change and migration. UPDATE: Created https://github.com/nerc-project/coldfront-plugin-cloud/issues/162
• This will be effective for the June billing cycle.

[Milstein]

@knikolla @joachimweyl: Can we confirm this statement is correct in our nerc docs:

Storage is charged separately at a rate of $0.009 TiB/hr or $9.00E-12 KiB/hr at a granularity of KiB/hr. For ease of reporting, storage SUs are shown in GiB but calculated in KiB.

[knikolla]

@knikolla @joachimweyl: Can we confirm this statement is correct in our nerc docs:

Storage is charged separately at a rate of $0.009 TiB/hr or $9.00E-12 KiB/hr at a granularity of KiB/hr. For ease of reporting, storage SUs are shown in GiB but calculated in KiB.

• The granularity is at the level of GiB. Storage SUs are calculated in GiB. I'm not aware of anywhere we're converting those values to KiB.
• We are currently billing as I described in the comment above, and starting with June we will be billing by what you describe here, yes.

[joachimweyl]

documents updated, waiting on some screenshots. the PR will automatically close this issue.

[joachimweyl]

@Milstein can I be of assistance in gathering any of the parts you need?

[Milstein]

Upcoming NERC's RegApp & ColdFront service upgrade and maintenance [June 18, 2024 9:00 AM - 11:00 AM ET]) will include most of these changes except the screenshots update for the nerc docs.

[joachimweyl]

@Milstein let's close this out on Tuesday once the documents are live and create a new issue to track adding the screenshots.