Browse code

Procedure for installing PhotonOS on Dell Gateways

Change-Id: Iae8451c9b6f44e23b6bf19b987c321e707489b08
Reviewed-on: http://photon-jenkins.eng.vmware.com:8082/6546
Reviewed-by: ashwin h <ashwinh@vmware.com>
Reviewed-by: Keerthana K <keerthanak@vmware.com>
Tested-by: Tapas Kundu <tkundu@vmware.com>
Reviewed-by: Anish Swaminathan <anishs@vmware.com>

Vidya Vasudevan authored on 2019/01/22 14:01:45
Showing 5 changed files
... ...
@@ -50,6 +50,9 @@
50 50
         - [Prerequisites for Running Photon OS on Raspberry Pi 3](photon_installation/photon-os-rpi3-prerequisites.md)
51 51
         - [Installing Photon OS on Raspberry Pi 3](photon_installation/installing-the-iso-image-for-photon-os-30-rpi3.md) 
52 52
     - [Deploying a Containerized Application in Photon OS](photon_installation/deploying-a-containerized-application-in-photon-os.md)
53
+    - [Installing Photon OS on Dell Gateways](photon_installation/Installing-Photon-OS-on-Dell-Gateways.md)
54
+        - [Installing Photon OS on Dell Edge Gateway 500X](photon_installation/Installing-Photon-OS-on-Dell-500X.md)
55
+        - [Installing Photon OS on Dell Edge Gateway 300X](photon_installation/Installing-Photon-OS-on-Dell-300X.md)
53 56
     - [Installing and Using Lightwave on Photon OS](photon_installation/Installing-and-Using-Lightwave-on-Photon-OS.md)
54 57
         - [Installing the Lightwave Server and Configuring It as a Domain Controller on a Photon Image](photon_installation/Installing-Lightwave-Server-and-Setting-Up-a-Domain.md) 
55 58
         - [Installing the Lightwave Client on a Photon Image and Joining the Client to a Domain](photon_installation/Installing-Lightwave-Client-and-Joining-a-Domain.md)
56 59
new file mode 100644
... ...
@@ -0,0 +1,69 @@
0
+# Installing Photon OS on Dell Edge Gateway 300X
1
+
2
+You can install Photon OS 3.0 on Dell Gateway 300X. You can download Photon OS as an ISO file and install it.
3
+
4
+- [Prerequisites](#prerequisites)
5
+- [Installing the ISO Image for Photon OS](#installing-the-iso-image-for-photon-os)
6
+
7
+## Prerequisites
8
+
9
+1.	Verify that you have the following resources:
10
+    - Dell Edge Gateway 300x.
11
+    - USB pen drive. Format the pen drive with FAT32 with at least 8 GB of space.
12
+2.	Download the Photon OS ISO image from [Bintray](https://bintray.com/vmware/photon/).
13
+
14
+## Installing the ISO Image for Photon OS
15
+
16
+1.	Mount the ISO image.
17
+    
18
+    For example, run the following command on macOS:
19
+
20
+    `hdiutil mount photon-3.0-ec12f2c.iso` 
21
+
22
+    Use a similar command in other operating systems.
23
+
24
+1. Copy the contents of the ISO image to a writable directory so that you can edit files.
25
+    For example, run the following commands on macOS.
26
+        
27
+    ```
28
+mkdir -p /tmp/photonUsb
29
+    
30
+    cp /Volumes/PHOTON_<timestamp>/* /tmp/photonUsb/
31
+    ```
32
+
33
+    where, `/Volumes/PHOTON_<timestamp>` is the directory where the ISO is mounted with the command in the step above.
34
+
35
+1. Edit the `grub.cfg` file to use the kickstart config file:
36
+    
37
+    `cd /tmp/photonUsb`
38
+
39
+    Add the below (highlighted) parameters to the linux cmd line in `boot/grub2/grub.cfg`
40
+    
41
+    `linux /isolinux/vmlinuz root=/dev/ram0 loglevel=3 photon.media=UUID=$photondisk` **`ks=cdrom:/isolinux/sample_ks.cfg console=ttyS0,115200n8`**
42
+
43
+1. Edit the `isolinux/sample_ks.cfg`  as follows:
44
+
45
+    - Change `"disk": "/dev/sda”,` to **`"disk": "/dev/mmcblk0",`**
46
+    - Change `"echo \"Hello World\" > /etc/postinstall"` to **`"sed -i 's/PermitRootLogin no/PermitRootLogin yes/g' /etc/ssh/sshd_config"`**
47
+    
48
+1. Format the pen drive with FAT-32 and copy all the contents of `/tmp/photonUsb` to the pen drive. 
49
+
50
+1. Create a `UsbInvocationScript.txt` file in the root of the pen drive with below content:
51
+
52
+    ```
53
+usb_disable_secure_boot noreset;
54
+usb_one_time_boot usb nolog;
55
+```
56
+
57
+1. Insert the pen drive in the Dell Gateway 300X and power on the gateway. 
58
+    
59
+    Photon OS installs automatically.
60
+
61
+1. After the installation is complete, insert a network cable into the ethernet port and find the IP address corresponding to the MAC address of the Dell Gateway 3000X ethernet port through the DHCP Server or a network analyzer. The MAC address is available on the Dell Gateway 3000X.
62
+
63
+1. You can then use `ssh` to access the gateway with the above IP address.
64
+
65
+
66
+
67
+
68
+
0 69
new file mode 100644
... ...
@@ -0,0 +1,23 @@
0
+# Installing Photon OS on Dell Edge Gateway 500X
1
+
2
+You can install Photon OS 3.0 on Dell Gateway 500X. You can download Photon OS as an ISO file and install it.
3
+
4
+- [Prerequisites](#prerequisites)
5
+- [Installing the ISO Image for Photon OS](#installing-the-iso-image-for-photon-os)
6
+
7
+## Prerequisites
8
+
9
+1.	Verify that you have the following resources:
10
+    - Dell Edge Gateway 500x.
11
+    - USB pen drive. Format the pen drive with FAT32 with at least 8 GB of space.
12
+2.	Download the Photon OS ISO image from [Bintray](https://bintray.com/vmware/photon/).
13
+
14
+## Installing the ISO Image for Photon OS
15
+
16
+1. Format the pen drive with FAT-32 and copy the ISO image to it.
17
+1. Insert the pen drive in the Dell Gateway 500X and power it on. 
18
+1. From the boot options, select the pen drive option. 
19
+
20
+**Result**: Photon OS is installed on the Dell Gateway 500X.
21
+
22
+
0 23
new file mode 100644
... ...
@@ -0,0 +1,11 @@
0
+# Installing Photon OS on Dell Gateways
1
+
2
+You can isntall Photon OS on Dell Edge Gateways 500X and 300X. 
3
+
4
+Dell Edge Gateways are devices that aggregate, secure, analyze, and relay data from diverse sensors and equipment at the edge of the IOT network.
5
+
6
+
7
+- [Installing Photon OS on Dell Edge Gateway 500X](Installing-Photon-OS-on-Dell-500X.md)
8
+- [Installing Photon OS on Dell Edge Gateway 300X](Installing-Photon-OS-on-Dell-300X.md)
9
+
10
+For more information about Dell Gateways, see [Dell Edge Gateways for IOT](https://www.dell.com/en-us/work/shop/gateways-embedded-computing/sf/edge-gateway)
... ...
@@ -44,6 +44,9 @@
44 44
         - [Prerequisites for Running Photon OS on Raspberry Pi 3](photon-os-rpi3-prerequisites.md)
45 45
         - [Installing Photon OS on Raspberry Pi 3](installing-the-iso-image-for-photon-os-30-rpi3.md) 
46 46
     - [Deploying a Containerized Application in Photon OS](deploying-a-containerized-application-in-photon-os.md)
47
+    - [Installing Photon OS on Dell Gateways](Installing-Photon-OS-on-Dell-Gateways.md)
48
+        - [Installing Photon OS on Dell Edge Gateway 500X](Installing-Photon-OS-on-Dell-500X.md)
49
+        - [Installing Photon OS on Dell Edge Gateway 300X](Installing-Photon-OS-on-Dell-300X.md)
47 50
     - [Installing and Using Lightwave on Photon OS](Installing-and-Using-Lightwave-on-Photon-OS.md)
48 51
         - [Installing the Lightwave Server and Configuring It as a Domain Controller on a Photon Image](Installing-Lightwave-Server-and-Setting-Up-a-Domain.md) 
49 52
         - [Installing the Lightwave Client on a Photon Image and Joining the Client to a Domain](Installing-Lightwave-Client-and-Joining-a-Domain.md)