Skip to content

Commit f822d06

Browse files
[EDI billing] Update "Syncing license usage" (#57065)
Co-authored-by: Sophie <[email protected]>
1 parent d0d05be commit f822d06

File tree

1 file changed

+19
-16
lines changed

1 file changed

+19
-16
lines changed
Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
22
title: Syncing license usage from GitHub Enterprise Server to Cloud
3-
intro: 'You can sync license usage from GitHub Enterprise Server to GitHub Enterprise Cloud to view all license usage across your enterprise in one place and ensure that people with accounts in both environments only consume one user license.'
4-
permissions: 'Enterprise owners can sync license usage between enterprise accounts on {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}.'
3+
intro: 'Sync licenses manually or with {% data variables.product.prodname_github_connect %}.'
54
versions:
65
ghec: '*'
76
ghes: '*'
@@ -15,28 +14,28 @@ redirect_from:
1514
contentType: how-tos
1615
---
1716

18-
## About synchronization of license usage
17+
A {% data variables.product.prodname_enterprise %} license allows a user to use both {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}. See [AUTOTITLE](/billing/concepts/enterprise-billing/combined-enterprise-use).
1918

20-
{% data reusables.enterprise-licensing.unique-user-licensing-model %}
19+
To view combined license details on {% data variables.product.prodname_ghe_cloud %} and ensure users only consume one license, you must sync licenses between deployments. You can do this:
2120

22-
{% data reusables.enterprise-licensing.about-license-sync %}
23-
24-
To ensure that you see up-to-date license details on {% data variables.product.prodname_ghe_cloud %}, you can sync license usage to {% data variables.product.prodname_dotcom_the_website %}{% ifversion ghecom-license-sync %} or {% data variables.enterprise.data_residency_site %}{% endif %} automatically, using {% data variables.product.prodname_github_connect %}. For more information about {% data variables.product.prodname_github_connect %}, see [About {% data variables.product.prodname_github_connect %}]({% ifversion ghec %}/enterprise-server@latest{% endif %}/admin/configuration/configuring-github-connect/about-github-connect){% ifversion ghec %} in the {% data variables.product.prodname_ghe_server %} documentation.{% elsif ghes %}.{% endif %}
25-
26-
If you don't want to enable {% data variables.product.prodname_github_connect %}, you can manually sync license usage by uploading a file from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_dotcom_the_website %}.
21+
* Automatically, using {% data variables.product.prodname_github_connect %}.
22+
* Manually, by uploading a license file from from {% data variables.product.prodname_ghe_server %} to {% data variables.product.github %}.
2723

2824
When you synchronize license usage, only the user ID and email addresses for each user account on {% data variables.product.prodname_ghe_server %} are transmitted to {% data variables.product.prodname_ghe_cloud %}.
2925

30-
{% data reusables.enterprise-licensing.view-consumed-licenses %}
31-
32-
{% data reusables.enterprise-licensing.verified-domains-license-sync %}
33-
3426
## Automatically syncing license usage
3527

3628
You can use {% data variables.product.prodname_github_connect %} to automatically synchronize user license count and usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %} weekly.
3729

3830
After you enable {% data variables.product.prodname_github_connect %}, license data will be automatically synchronized weekly. You can also manually synchronize your license data at any time, by triggering a license sync job.
3931

32+
### Enabling automatic license sync
33+
34+
To enable license sync, you must:
35+
36+
1. Enable {% data variables.product.prodname_github_connect %}. See {% ifversion ghes %}[AUTOTITLE](/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom) or [AUTOTITLE](/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-ghecom){% else %}[AUTOTITLE](/enterprise-server@latest/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom) or [AUTOTITLE](/enterprise-server@latest/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-ghecom) in the {% data variables.product.prodname_ghe_server %} documentation{% endif %}.
37+
1. Enable license sync. See {% ifversion ghes %}[AUTOTITLE](/admin/configuring-settings/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise){% else %}[AUTOTITLE](/enterprise-server@latest/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom) in the {% data variables.product.prodname_ghe_server %} documentation{% endif %}.
38+
4039
### Triggering a license sync job
4140

4241
1. Sign in to your {% data variables.product.prodname_ghe_server %} instance.
@@ -45,9 +44,7 @@ After you enable {% data variables.product.prodname_github_connect %}, license d
4544
{% data reusables.enterprise-accounts.license-tab-ghes %}
4645
1. Under "License sync", click **{% octicon "sync" aria-hidden="true" aria-label="sync" %} Sync now**.
4746

48-
If there is no **{% octicon "sync" aria-hidden="true" aria-label="sync" %} Sync now** button, you need to enable license synchronization. An information message, "License sync is disabled. You can enable it in the GitHub Connect settings" is shown. Click the "GitHub Connect settings" link. For more information, see [Enabling automatic user license sync for your enterprise]({% ifversion ghec %}/enterprise-server@latest{% endif %}/admin/configuration/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise){% ifversion ghec %} in the {% data variables.product.prodname_ghe_server %} documentation.{% elsif ghes %}.{% endif %}
49-
50-
## Manually uploading GitHub Enterprise Server license usage
47+
## Manually uploading {% data variables.product.prodname_ghe_server %} license usage
5148

5249
You can download a JSON file from {% data variables.product.prodname_ghe_server %} and upload the file to {% data variables.product.prodname_ghe_cloud %} to manually sync user license usage between the two deployments.
5350

@@ -62,3 +59,9 @@ You can download a JSON file from {% data variables.product.prodname_ghe_server
6259
{% data reusables.enterprise-accounts.licensing-tab-both-platforms %}
6360
1. Next to "Enterprise Server instances", click **Add server usage**.
6461
1. Upload the JSON file you downloaded from {% data variables.product.prodname_ghe_server %}.
62+
63+
## Next steps
64+
65+
{% data reusables.enterprise-licensing.view-consumed-licenses %}
66+
67+
To make troubleshooting easier, if you synchronize license usage and do not use {% data variables.product.prodname_emus %}, we highly recommend enabling verified domains for your enterprise account on {% data variables.product.prodname_ghe_cloud %}. See [AUTOTITLE](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise){% ifversion ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}.{% endif %}

0 commit comments

Comments
 (0)