Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions content/en/docs-v3/Overview/Flavours.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@ weight: 2

Photon OS consists of a minimal version and a full version.

The minimal version of Photon OS is lightweight container host runtime environment that is suited to managing and hosting containers. The minimal version contains just enough packaging and functionality to manage and modify containers while remaining a fast runtime environment. The minimal version is ready to work with appliances.
The minimal version of Photon OS is a lightweight container host runtime environment that is suited to managing and hosting containers. The minimal version contains just enough packaging and functionality to manage and modify containers while remaining a fast runtime environment. The minimal version is ready to work with appliances.

The Developer version of Photon OS includes additional packages to help you customize the system and create containerized applications. For running containers, the developer version is excessive. The devloper version helps you create, develop, test, and package an application that runs a container.
The Developer version of Photon OS includes additional packages to help you customize the system and create containerized applications. For running containers, the developer version is excessive. The developer version helps you create, develop, test, and package an application that runs a container.
2 changes: 1 addition & 1 deletion content/en/docs-v3/Overview/Introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Introduction to Photon OS
weight: 1
---

Photon OS, is an open-source minimalist Linux operating system from VMware that is optimized for cloud computing platforms, VMware vSphere deployments, and applications native to the cloud.
Photon OS is an open-source minimalist Linux operating system from VMware that is optimized for cloud computing platforms, VMware vSphere deployments, and applications native to the cloud.

Photon OS is a Linux container host optimized for vSphere and cloud-computing platforms such as Amazon Elastic Compute and Google Compute Engine. As a lightweight and extensible operating system, Photon OS works with the most common container formats, including Docker, Rocket, and Garden. Photon OS includes a yum-compatible, package-based lifecycle management system called tdnf.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ weight: 8

You can change the locale if the default locale does not meet your requirements.

To find the locale, run the the `localectl` command:
To find the locale, run the `localectl` command:

localectl
System Locale: LANG=en_US.UTF-8
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Customizing a Photon OS Machine on EC2
weight: 5
---

You can upload an `ami` image of Photon OS to Amazon Elastic Compute Cloud (EC2) and customize the Photon OS machine by using `cloud-init` with an EC2 data source. The Amazon machine image version of Photon OS is available as a free download on Packages URL at the location `https://packages.vmware.com/photon/`.
You can upload an `ami` image of Photon OS to Amazon Elastic Compute Cloud (EC2) and customize the Photon OS machine by using `cloud-init` with an EC2 data source. The Amazon machine image version of Photon OS is available as a free download on Packages URL at the location `https://packages.broadcom.com/photon/`.

The `cloud-init` service is commonly used on EC2 to configure the cloud instance of a Linux image. On EC2, `cloud-init` sets the `.ssh/authorized_keys` file to let you log in with a private key from another computer, that is, a computer besides the workstation that you are already using to connect with the Amazon cloud.

Expand All @@ -15,7 +15,7 @@ The cloud-config user-data file that appears in the following example contains a

- To work with EC2, obtain Amazon accounts for both AWS and EC2 with valid payment information. If you execute the below examples, you will be charged by Amazon. You must replace the `<placeholders>` for access keys and other account information in the examples with your account information.
- Install and set up the Amazon AWS CLI and the EC2 CLI tools, including `ec2-ami-tools`.
For more information, see [Installing the AWS Command Line Interface](http://docs.aws.amazon.com/cli/latest/userguide/installing.html), [Setting Up the Amazon EC2 Command Line Interface Tools on Linux](http://docs.aws.amazon.com/AWSEC2/latest/CommandLineReference/set-up-ec2-cli-linux.html) and [Setting Up the AMI Tools](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-up-ami-tools.html).
For more information, see [Installing the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html), [Installing the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) and [Setting Up the AMI Tools](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-up-ami-tools.html).
- Create SSH keys and an RSA user signing certificate and its corresponding private RSA key file.

### Procedure
Expand Down Expand Up @@ -91,7 +91,7 @@ The following are the contents of the `user-data.txt` file that `cloud-init` app

You can view the cloud-init output log file on EC2 at `/var/log/cloud-init-output.log`.

For more information on using cloud-init user data on EC2, see [Running Commands on Your Linux Instance at Launch](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html).
For more information on using cloud-init user data on EC2, see [Running Commands on Your Linux Instance at Launch](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html).

For more information on how to get Photon OS up and running on EC2 and run a containerized application in the Docker engine, see [Running Photon OS on Amazon Elastic Cloud Compute](../../../installation-guide/run-photon-aws-ec2/).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ When a cloud instance of Photon OS starts, `cloud-init` requires a data source.

The metadata gives the cloud service provider instructions on how to implement the Photon OS machine in the cloud infrastructure. Metadata typically includes the instance ID and the local host name.

The user data contains the commands and scripts that Photon OS executes when it starts in the cloud. The user data commonly takes the form of a shell script or a YAML file containing a cloud configuration. The [cloud-init overview](https://launchpad.net/cloud-init) and [cloud-init documentation](https://cloudinit.readthedocs.org/en/latest/) contains information about the types of data sources and the formats for metadata and user data.
The user data contains the commands and scripts that Photon OS executes when it starts in the cloud. The user data commonly takes the form of a shell script or a YAML file containing a cloud configuration. The [cloud-init overview](https://launchpad.net/cloud-init) and [cloud-init documentation](https://cloudinit.readthedocs.org/en/latest/) contain information about the types of data sources and the formats for metadata and user data.

On Photon OS, `cloud-init` is enabled and running by default. You can use the following command to check the status:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@ The example in this section shows how to create a Photon OS instance on Google C

### Prerequisites

- You must have set up a GCE account and are ready to pay Google for its cloud services. The GCE-ready version of Photon OS is licensed as described in the Photon OS [LICENSE guide](https://github.com/vmware/photon/blob/master/LICENSE.md). GCE and other environment-specific Packages are stored in the open using the following URL pattern: `https://packages.vmware.com/photon/<release>/<revision>/gce`
- You must have set up a GCE account and are ready to pay Google for its cloud services. The GCE-ready version of Photon OS is licensed as described in the Photon OS [LICENSE guide](https://github.com/vmware/photon/blob/master/LICENSE.md). GCE and other environment-specific Packages are stored in the open using the following URL pattern: `https://packages.broadcom.com/photon/<release>/<revision>/gce`

For example, the current GA revision of the 4.0 release would be located at the following URL: [https://packages.vmware.com/photon/4.0/GA/gce/](https://packages.vmware.com/photon/4.0/GA/gce/), and the 3.0 GA version would be located at: [https://packages.vmware.com/photon/3.0/GA/gce/](https://packages.vmware.com/photon/3.0/GA/gce/).
For example, the current GA revision of the 4.0 release would be located at the following URL: [https://packages.broadcom.com/photon/4.0/GA/gce/](https://packages.broadcom.com/photon/4.0/GA/gce/), and the 3.0 GA version would be located at: [https://packages.broadcom.com/photon/3.0/GA/gce/](https://packages.broadcom.com/photon/3.0/GA/gce/).

The GCE-ready image of Photon OS contains packages and scripts that prepare it for the Google cloud to save you time as you implement a compute cluster or develop cloud applications. The GCE-ready version of Photon OS adds the following packages to the [packages installed with the minimal version](https://github.com/vmware/photon/blob/master/common/data/packages_minimal.json):

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1008,7 +1008,7 @@ Delete a server from the DNS servers list associated with an interface.

**Description**

Get the the DNS servers list for the interface.
Get the DNS servers list for the interface.

**Declaration**
~~~~
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,12 @@ On Photon OS, the existing repositories appear in the `/etc/yum.repos.d` directo
photon-updates.repo
photon.repo

To view the the format and information that a new repository configuration file should contain, see one of the `.repo` files. The following is an example:
To view the format and information that a new repository configuration file should contain, see one of the `.repo` files. The following is an example:

cat /etc/yum.repos.d/lightwave.repo
[lightwave]
name=VMware Lightwave 1.0(x86_64)
baseurl=https://packages.vmware.com/photon/1.0/lightwave
baseurl=https://packages.broadcom.com/photon/1.0/lightwave
gpgkey=file:///etc/pki/rpm-gpg/VMWARE-RPM-GPG-KEY
gpgcheck=1
enabled=1
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ The following repositories appear in /etc/yum.repos.d/ with `.repo` file extensi
photon.repo


You can list the the repositories by using the `tdnf repolist` command. Tdnf filters the results with `enabled`, `disabled`, and `all`. Running the command without specifying an argument returns the enabled repositories:
You can list the repositories by using the `tdnf repolist` command. Tdnf filters the results with `enabled`, `disabled`, and `all`. Running the command without specifying an argument returns the enabled repositories:

tdnf repolist
repo id repo name status
Expand All @@ -38,7 +38,7 @@ The `photon-iso.repo`, however, does not appear in the list of repositories beca

cat /etc/yum.repos.d/photon-iso.repo
[photon-iso]
name=VMWare Photon Linux 2.0(x86_64)
name=VMware Photon Linux 2.0(x86_64)
baseurl=file:///mnt/cdrom/RPMS
gpgkey=file:///etc/pki/rpm-gpg/VMWARE-RPM-GPG-KEY
gpgcheck=1
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ To list enabled repositories, run the following command:

Total installed size: 210.15 M

**remove**: This command removes a package. When removing a package, tdnf by default also removes dependencies that are no longer used if they were was installed by tdnf as a dependency without being explicitly requested by a user. You can modify the dependency removal by changing the `clean_requirements_on_remove` option in /etc/tdnf/tdnf.conf to `false`.
**remove**: This command removes a package. When removing a package, tdnf by default also removes dependencies that are no longer used if they were installed by tdnf as a dependency without being explicitly requested by a user. You can modify the dependency removal by changing the `clean_requirements_on_remove` option in /etc/tdnf/tdnf.conf to `false`.

tdnf remove packagename

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ weight: 2

To control services on Photon OS, use `systemctl` command.

For example, instead of running the `/etc/init.d/ssh` script to stop and start the OpenSSH server on a init.d-based Linux system, run the following `systemctl` commands on Photon OS:
For example, instead of running the `/etc/init.d/ssh` script to stop and start the OpenSSH server on an init.d-based Linux system, run the following `systemctl` commands on Photon OS:

systemctl stop sshd
systemctl start sshd
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Building a Package from a Source RPM
weight: 5
---

This section describes how to install and build a package on the full version of Photon OS from the package's source RPM. Obtain the source RPMs that Photon OS uses from the Packages location, [https://packages.vmware.com/photon](https://packages.vmware.com/photon)
This section describes how to install and build a package on the full version of Photon OS from the package's source RPM. Obtain the source RPMs that Photon OS uses from the packages location, [Broadcom packages repository](https://packages.broadcom.com/photon)


## Prerequisites
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Once you have the name of the key, you can view information about the key with t
Build Host : localhost
Relocations : (not relocatable)
Packager : VMware, Inc. -- Linux Packaging Key -- <linux-packages@vmware.com>
Summary : gpg(VMware, Inc. -- Linux Packaging Key -- <linux-packages@vmware. com>)
Summary : gpg(VMware, Inc. -- Linux Packaging Key -- <linux-packages@vmware.com>)
Description :
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: rpm-4.11.2 (NSS-3)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Default Firewall Settings
weight: 1
---

The design of Photon OS emphasizes security. On the minimal and full versions of Photon OS, the default security policy turns on the firewall and drops packets from external interfaces and applications. As a result, you might need to add rules to iptables to permit forwarding, allow protocols like HTTP, and open ports. You must configure the firewall for your applications and requirements.
The design of Photon OS emphasizes security. On the minimal and full versions of Photon OS, the default security policy turns on the firewall and drops packets from external interfaces and applications. As a result, you might need to add rules to iptables to permit forwarding, allow protocols like HTTP, and open ports. You must configure the firewall for your applications and requirements.

The default iptables on the full version have the following settings:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Build Prerequisites
weight: 2
---

Before you build the ISO, verify that you have the performed the following tasks:
Before you build the ISO, verify that you have performed the following tasks:

* Installed a build operating system running the 64-bit version of Ubuntu 14.04 or later version.

Expand Down
10 changes: 5 additions & 5 deletions content/en/docs-v3/installation-guide/cloud-images.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ weight: 13
---


The [Packages URL](https://packages.vmware.com/photon/) contains the following cloud-ready images of Photon OS:
The [Packages URL](https://packages.broadcom.com/photon/) contains the following cloud-ready images of Photon OS:

1. GCE - Google Compute Engine

Expand Down Expand Up @@ -38,7 +38,7 @@ If you want, you can build all the cloud images by running the following command

<!-- ###How to build Photon bosh-stemcell

Please follow the link to [build](https://github.com/cloudfoundry/bosh/blob/develop/bosh-stemcell/README.md) Photon bosh-stemcell
Please follow the link to [build](https://github.com/cloudfoundry/bosh-linux-stemcell-builder) Photon bosh-stemcell
-->

## How to create running instances in the cloud
Expand Down Expand Up @@ -71,7 +71,7 @@ For more information, see [Running a Photon OS Machine on GCE](../run-photon-on-

### AWS EC2

Install the [AWS CLI](http://docs.aws.amazon.com/cli/latest/userguide/installing.html#install-bundle-other-os) and [EC2 CLI](http://docs.aws.amazon.com/AWSEC2/latest/CommandLineReference/set-up-ec2-cli-linux.html) tools.
Install the [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html#install-bundle-other-os) and [EC2 CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) tools.

####Bundle the image

Expand Down Expand Up @@ -109,7 +109,7 @@ The OVA image uses an optimized version of the 4.4.8 Linux kernel. Two ova files

#### OVA Prerequisites

[VDDK 6.0](https://developercenter.vmware.com/web/sdk/60/vddk)
[VDDK 6.0](https://developer.broadcom.com/sdks/vmware-virtual-disk-development-kit-vddk/6.7)

To utilize the VDDK libraries the following procedure may be used, this extracts the libraries and temporarily exports them to the LD_LIBRARY_PATH for the *current session*. (tested on Ubuntu 1404 & 1604) If you wish to make this permenant and system-wide then you may want to create a config file in /etc/ld.so.conf.d/.

Expand All @@ -120,7 +120,7 @@ To utilize the VDDK libraries the following procedure may be used, this extracts
rm /usr/lib/vmware/libstdc++.so.6
export LD_LIBRARY_PATH=/usr/lib/vmware

[OVFTOOL](https://my.vmware.com/group/vmware/details?downloadGroup=OVFTOOL410&productId=491)
[OVFTOOL](https://developer.broadcom.com/tools/open-virtualization-format-ovf-tool/latest)

OVF Tool should be downloaded and installed on the host.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ You can install Photon OS 3.0 on Dell Gateway 300X. You can download Photon OS a
1. Verify that you have the following resources:
- Dell Edge Gateway 300x.
- USB pen drive. Format the pen drive with FAT32 with at least 8 GB of space.
2. Download the Photon OS ISO image from [Bintray](https://bintray.com/vmware/photon/).
2. Download the Photon OS ISO image from [Download web page](https://github.com/vmware/photon/wiki/downloading-photon-os).

## Installing the ISO Image for Photon OS

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Connect to the Photon instance by using SSH and to launch a web server by runnin

ssh -i ~/.ssh/mykeypair root@<public-ip-address-of-instance>

For complete instructions, see [Connecting to Your Linux Instance Using SSH](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstancesLinux.html).
For complete instructions, see [Connecting to Your Linux Instance Using SSH](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstancesLinux.html).

1. Run Docker

Expand All @@ -33,7 +33,7 @@ Connect to the Photon instance by using SSH and to launch a web server by runnin

1. Test the web server

On your local workstation, open a web browser and go to the the public address of the Photon OS instance running Docker. The following screen should appear, showing that the web server is active:
On your local workstation, open a web browser and go to the public address of the Photon OS instance running Docker. The following screen should appear, showing that the web server is active:

![Nginx](../../images/Nginx.jpg)

Expand Down
Loading