centurylinkcloud / publickb Goto Github PK

Need meta desc field for kb, getting started + api like we do for those in publicplatform. Example:

{{#contentFor "description"}}Manage back-office functions for cloud deployments. Supports billing, permissions, re-branding and more. Designed for complex enterprise hierarchies, resellers, and ISVs.{{/contentFor}}

@timjbaumgartner the Cloudera Manager Guide (pdf) is throwing a 404. Can you pls take a look?

The verbiage in the "Licensing Impact" paragraph should be modified slightly in order to accommodate virtual cores. Per Microsoft documentation, “In a virtualized environment, the compute capacity limit is based on the number of logical processors…”
Source: https://docs.microsoft.com/en-us/sql/sql-server/compute-capacity-limits-by-edition-of-sql-server

Licensing Impact
Many vendors license and/or limit their applications and services based on any one of the 3 items above. For example, Microsoft SQL Server 2016 limits Standard Edition to the lesser of 4 Sockets or 24 cores. Thus customers who want to leverage more than 4 vCPUs on CenturyLink Cloud would need to leverage Enterprise Edition which does not impose such limits. Customers should carefully review each vendors licensing terms against the delivery model used on CenturyLink Cloud to make sure they comply with those terms and are not procuring more compute than a product is capable of consuming.
Source: https://www.ctl.io/knowledge-base/servers/platform-socket-to-vcpu-allocation

'Commvault' and 'Lagrange CloudMaestro' links on https://www.ctl.io/knowledge-base/release-notes/2015-09-01-cloud-platform-release-notes/ direct users to a 404 page.

Originally, I had written a fourth parser (in addition to the markdown parser, front matter parser, and file link parser) that checked the output of external links. I didn't include it in the Commit Analyzer because, on this repo, the build made Travis CI timeout. (Max time for a build is 50 minutes.)

@mattfordham and I proposed tabling that parser for the time being in order to encourage a quick build. (Currently, this repo builds at 29 seconds.)

This morning, I was tinkering with the external link parser and fixed a bug in the link parser that got it down to 17 minutes on my local machine. (This will likely be a good bit slower on Travis because of the limited hardware. It's difficult to estimate just how much slower, but I don't believe it would be more than 2x.) That puts it, in my opinion, in the realm of consideration.

There are likely more optimizations I could make to get that time down further. Is that something you'd be interested in investing some hours into, or should we leave it as is? Is there a ballpark build time that you'd like to try to stay within, so we could consider if it was even possible to get the link parser to run within that time budget?

Further, If we decide to leave the link parser as is, then should it be added it to the commit analyzer, or should we keep it out for the sake of speedy builds? You'd have to weigh whether the trade off of the time-to-build was worth it.

Worst case, here is a link to a gist of the output of the external link parser. That could at least give you a sense of what needs fixing, and then you could decide if it's worth trying to add it to the build, or just decide to place the onus of link checking on the authors.

(This issue was added to this repo because of the three that contain the commit analyzer, this has the greatest number of files.)

cc @nathanyoung

Edit

An optimization I just tried in this commit dropped the build time to 13:18. That was the low-hanging fruit. More optimizations could be done, I'm sure, but not without a good bit more investment.

source file: https://github.com/CenturyLinkCloud/PublicKB/blob/master/Object%20Storage/s3cmd-object-storage-management-for-linux-machines.md

Broken link is: <a href="../Object Storage">CenturyLink Cloud Object Storage</a>, I think this link should actually ../../object-storage?

all safehaven kbs are 404 on search per slack note

@mattfordham think you fellows have always helped us get the commit analyzer back up when we've seen issues. Who can @jim-phillips work w/ to learn more about it so we can self manage?

Thanks,
Rich

This will make it much easier to find the most recent release notes.

https://github.com/CenturyLinkCloud/PublicKB/blob/master/Blueprints/using-blueprint-script-to-call-api.md

https://www.ctl.io/knowledge-base/blueprints/using-blueprint-script-to-call-api/

We're finally collecting data on all Eco Blueprint deployments and looking at making this available to partners (and ourselves) via a partner portal.

I'd like to collect data on Eco KB impressions that we can display alongside the deploy data.

What are your thoughts on just including a link to an off-site image with a unique URL so we can capture this data? This is independent of any other existing tracking systems operational for the overall ctl.io site.

https://www.ctl.io/knowledge-base/lbaas/ is missing from the main kb page list.

PublicKB/Accounts & Users/role-permissions-matrix.md

Scroll bar for role permissions matrix is at bottom of very long list.
When I first opened this matrix, I needed to see a column that was off to the right.
I scrolled to the bottom of the document to expose the scroll bar at the bottom to use my mouse to scroll to the right. I lost track of the section that I was trying to verify when scrolling back up because the 1st column had scrolled off the screen, now it was just permissions with no context.

The article: AFv1/how-to-migrate-an-application.md, the following links:

• Enable AppFog in the Control Portal
• Setup Custom Domain for Application
  Both links are adding "afv1" when resolving, as in:
  https://www.ctl.io/knowledge-base/afv1/AppFog/getting-started-with-appfog.md/
  https://www.ctl.io/knowledge-base/afv1/AppFog/setup-custom-domain-for-appfog-app.md/

the main kb library/icons have nothing for LBaaS linking to https://www.ctl.io/knowledge-base/lbaas

the ticket prioritization matrix update doesn't have a break delineating the service task matrix area from the support request area. the table just jumps without a header break which is confusing when viewing as you have no idea why this new table just appeared and what its clearly for. we should add a ### Service Task header or something ahead of it

https://www.ctl.io/knowledge-base/appfog/blue-green-deployments/#put-update-application-into-main-rotation

our public website lays out the support phone numbers by country:
https://www.ctl.io/support/

for some reason our kb documents such as https://www.ctl.io/knowledge-base/support/how-do-i-report-a-support-issue/ don't show the phone numbers as an option. seems to be overlooked in our kb support areas. please have the support org update these documents with phone information already on our public website.

The following KBs are missing in the new repo:

[ ] https://t3n.zendesk.com/entries/61959224-Using-Self-Service-VM-Import
[ ] https://t3n.zendesk.com/entries/61494074-Server-Naming-Convention
[ ] https://t3n.zendesk.com/entries/62174590-Blueprints-Best-Practices
[ ] https://t3n.zendesk.com/entries/62174810-Templates-Best-Practices
[ ] https://t3n.zendesk.com/entries/61376134-Packages-Best-Practices
[ ] https://t3n.zendesk.com/entries/62819470-Getting-Started-with-Orchestrate-Blueprint
[ ] https://t3n.zendesk.com/entries/60786784-Getting-Started-with-FoundationDB-Blueprint
[ ] https://t3n.zendesk.com/entries/62217230-Getting-Started-with-Acumatica-ERP-Blueprint
[ ] https://t3n.zendesk.com/entries/61456054-Getting-Started-with-Dynatrace-Blueprints
[ ] https://t3n.zendesk.com/entries/62544270-Getting-started-with-Centerity-Blueprints
[ ] https://t3n.zendesk.com/entries/62819470-Getting-Started-with-Orchestrate-Blueprint

See:

https://www.ctl.io/blog/post/chef-provisioning-vmware-vsphere-driver-new-open-source/

Missing space before the #'s

the following page is throwing a 404:
https://www.centurylinkcloud.com/knowledge-base/ecosystem-partners/migrate-appfog-addon-to-addon-engine/

Can we get a Linux vs Windows subcategory in the Servers section to at least filter or minimize the amount of articles in the section? There are 60 articles to browse through and while we can always search, having an area for those base OS's would be helpful.

Everything after "Please see additional KB articles "Creating and applying Autoscale policies"" is a hyperlink:

https://www.ctl.io/knowledge-base/release-notes/2013/2013-09-03-cloud-platform-release-notes/

https://github.com/CenturyLinkCloud/PublicKB/blob/master/Release%20Notes/2013/2013-09-03-cloud-platform-release-notes.md

Note use the VM Dicovery tool enbeeded in the SafeHaven console to get the required information when the customer environment is VMware.

"Dicovery tool enbeeded" should be "Discovery tool embedded"

https://www.centurylinkcloud.com/knowledge-base/ecosystem-partners/getting-started-with-owncloud-blueprint/

the script referenced in this KB is not available globally. "Install ownCloud on Linux" thus this is non-functional

the visio stencils kb @ https://www.centurylinkcloud.com/knowledge-base/general/centurylink-cloud-visio-stencils/ is 404. the repository has the .md file in general (centuryLink-cloud-visio-stencils.md) and I'm not aware of any updates so i'm unclear why its missing from the live site

Hi all,
Please see https://www.ctl.io/knowledge-base/ecosystem-partners/ecosystem-partner-list/, URL for Hyper accurate time services is broken. Please see attached.
Thanks
Gavin

https://www.centurylinkcloud.com/knowledge-base/ecosystem-partners/getting-started-with-apex-datacom-call-me-essentials-edition-blueprint/

the numbering in this kb is off. next to images a new step number shows up when i believe you are just illustrating via image the previous step.

in the area deploy apex datacom call me essentials edition blueprint area of the KB you can see this, it also carries down into areas like step 15 which is not even a step but a note (this happens a ton in this KB). this whole kb needs better formatting as having 40 steps doesn't seem logical for something so basic.

Per this ticket, https://t3n.zendesk.com/agent/tickets/1113636, the list in the following article isn't rendering correctly in Chrome. It counts out the items 1, 6, 4.

https://www.centurylinkcloud.com/knowledge-base/support/how-do-i-report-a-support-issue/

Thing is, when viewed in Explorer, and in GitHub, the list renders correctly as 1, 2, 3: https://github.com/CenturyLinkCloud/PublicKB/edit/master/Support/how-do-i-report-a-support-issue.md

Both the AbanteCart and JBoss links on https://www.centurylinkcloud.com/knowledge-base/ecosystem-partners/ecosystem-partner-list/ result in 404 Page Not Found errors

Will the knowledge base be translated to multiple languages as the site now supports? Currently it only supports English regardless of the CTL site selection.

knowledge-base/release-notes/2013/2013-09-03-cloud-platform-release-notes/

Last link under 'New Features(1)'

The attachment download link below "6. Upload the script to the control portal." is broken

Found in this file: https://github.com/CenturyLinkCloud/PublicKB/blob/master/Blueprints/using-blueprint-script-to-call-api.md

https://www.ctl.io/knowledge-base/managed-services/managed-operating-system-frequently-asked-questions/
"After creating a VM for management or after deploying the blueprint to convert an existing VM to a managed one, the VM will be 'Under Construction' while background processes are completed. You will not have access to the server during that time; you will receive a notification via email once the operation has completed. Please allow up to a 60 minutes."

https://www.ctl.io/knowledge-base/managed-services/created-a-managed-server-now-what/
"You will not have access to the server during that time; you will receive a notification via email once the operation has completed (allow up to a 30 minutes)"

i'm not sure what we publicly want as the formal statement on this but my experience is that we rarely hit < 60 min. its generally in excess of 60 minutes in most situations.

@jruckle

Searching the blog is returning both actual articles and the browse pages. I wouldn't expect the later.

For example:
https://www.ctl.io/blog/search/?cx=004518466626182738981%3A66-q7451vko&ie=UTF-8&q=dynatrace+site%3Ahttps%3A%2F%2Fwww.ctl.io%2Fblog%2F

The Orchestrate team has a great thing setup - self-registration of a community help channel. Thinking of the same to supplement our developer central site so folks have real-time access into a slack community.

What are some thoughts on getting this added into the Developer Center site?

<script async defer src="http://ctl-community-slackin.useast.appfog.ctl.io/slackin.js"></script>

Default minimized:

Default expanded on click:

Please have redirect on CAM KB Root page
https://www.ctl.io/knowledge-base/cloud-application-manager/ to go to
https://www.ctl.io/knowledge-base/cloud-application-manager/getting-started/#1

The following pages are missing from KB

https://www.ctl.io/knowledge-base/cloud-application-manager/autodiscover-clc-instances/
https://www.ctl.io/knowledge-base/cloud-application-manager/autodiscover-ec2-instances/

Please restore them under https://www.ctl.io/knowledge-base/cloud-application-manager/deploying-anywhere/

Found under 'New Features(3)'

"Creating Bi-Directional Firewall Policies." is broken

https://www.ctl.io/knowledge-base/afv1/memcached-cloud/

Find beneath Using Memcached with Python

my table in kb https://www.ctl.io/knowledge-base/network/centurylink-cloud-guide-to-openvpn-access-server/ section "Configuring LDAP Authentication" doesn't seem to render. github preview it renders fine but it comes out wrong live. can you let me know what you see? from the code it all appears fine.

https://www.ctl.io/knowledge-base/ecosystem-partners/partner-integration-resources/ecosystem-program-resources-blueprints/

Link is foudn under 'Core Documentation'

Go to https://www.ctl.io/knowledge-base/mail/#1 and click either article - both seem to either fail or redirect back to the KB home

Search for SMTP and then click one of the top two results - both seem to either fail or redirect back to the KB home

Currently whatever parser we are using requires that there be a space between the # and text to generate a proper H tag. It is valid markdown if there is no space and most editors will generate it like that so we are seeing lots of PR where they have to fix this. We should just allow it.

@mattfordham how big of a change is this, just as a spit ball?

2a91298 might have missed one:

###This sounds too good to be true…

https://github.com/CenturyLinkCloud/PublicKB/blob/master/AFv1/the-developers-toolkit-ender-js.md

Hi SafeHaven team,
In KB (https://www.ctl.io/knowledge-base/disaster-recovery/build-safehaven-base-image-template-from-ubuntu/), the URL https://www.dropbox.com/sh/7837hqfwe31wzrh/AADGn34eQ25IDLw4_VOmsRWya/SH3.1.1-u1-Testing/baseInstaller-SafeHaven3.1.1-u1.tar.gz?dl=0 is not valid anymore.
Should this still be valid or a new version is available at another location?
Thanks
Gavin

in https://www.centurylinkcloud.com/support/ it states on developer support "Response Time to tickets: Less than 8 hours by a pool of shared engineers"

but that doesn't seem reflected in our ticket matrix which shows only normal & high levels of ticket priority. https://www.centurylinkcloud.com/knowledge-base/support/ticket-prioritization-matrix/; with normal a 1 hour response. there is nothing noted about 8 hours at all.

it seems the developer service is misaligned as it really doesn't make it clear in the matrix that we have up to 8 hours on developer support per our SLA & website: https://www.centurylinkcloud.com/legal/sla/

this seems to be a problem with the matrix itself in the kb and is confusing. the matrix should match our SLA 100% in my view

https://www.ctl.io/knowledge-base/network/june-2014-bandwidth-model-change-faq/

if you search for 'bandwidth' this kb shows up but its been removed on purpose from our system due to being outdated. we need to get it out of cache/search

file: https://github.com/CenturyLinkCloud/PublicKB/blob/master/AFv1/custom-domain-names.md

link is found under ###Command-ine Tool heading

@bmathews discovered an issue in a code snippet at https://www.ctl.io/knowledge-base/afv1/logentries/

require dirname(FILE) . '/le_php-master/logentries.php';

The markdown parser mistakenly transforms __FILE__ to FILE

The solution we propose for this is to set the frontmatter flag contentIsHTML to true and replace all markdown with HTML. The majority of the content of this file and many of its siblings is HTML, so the update wouldn't be too much of a hassle (certainly less than modifying the markdown parser to handle this single case).

@nathanyoung we wanted to bring this to your attention. We're happy to make the update if needed.

@mattfordham ping