dixonsiu · February 7, 2019 02:44 · Jan 29, 2019 · Jan 28, 2019 · Jan 28, 2019 · Jan 28, 2019
diff --git a/MinimalPersoniumUnit4Testing.md b/MinimalPersoniumUnit4Testing.md
@@ -1,5 +1,8 @@
 # Why I provide this Vagrant box for Personium beginners  
 When you just want to try out Personium APIs or play around with the applications provided from Took a very long time to construct the Vagrant version. Basically it always failed to be installed in proxy environment.  
+> Tested in Windows 10, no problem.    
+> In Windows 7, powershell must be updated.  
+> In some laptop, Bios configurations are needed to run VirtualBox.  
 
 # How to install and turn on the user-friendly Personium Unit  
 ## 1. How to deploy  

diff --git a/MinimalPersoniumUnit4Testing.md b/MinimalPersoniumUnit4Testing.md
@@ -37,7 +37,7 @@ Password is "vagrant"
 
 ## 3. How to login to the Unit Manager  
 1. Access the following URL from the browser.  
-[https://localhost/app-uc-unit-manager/__/html/login.html(https://localhost/app-uc-unit-manager/__/html/login.html)  
+[https://localhost/app-uc-unit-manager/__/html/login.html](https://localhost/app-uc-unit-manager/__/html/login.html)  
 1. Login information  
     - Login URL: https://localhost/unitadmin/
     - Username: unitadmin

diff --git a/MinimalPersoniumUnit4Testing.md b/MinimalPersoniumUnit4Testing.md
@@ -37,7 +37,7 @@ Password is "vagrant"
 
 ## 3. How to login to the Unit Manager  
 1. Access the following URL from the browser.  
-`https://localhost/app-uc-unit-manager/__/html/login.html`
+[https://localhost/app-uc-unit-manager/__/html/login.html(https://localhost/app-uc-unit-manager/__/html/login.html)  
 1. Login information  
     - Login URL: https://localhost/unitadmin/
     - Username: unitadmin

diff --git a/MinimalPersoniumUnit4Testing.md b/MinimalPersoniumUnit4Testing.md
@@ -43,6 +43,9 @@ Password is "vagrant"
     - Username: unitadmin
     - Password: JeoougAiHxbBcffx
 
+That's it!!! You can start using the Personium Unit.  
+
+For those who would like to add something to the Personium Unit and release it to other users, you can check out the following procedures.  
 # Complete procedures for creating this user friendly Vagrant box  
 ## How to package the official built  
 1. Install virtual box and vagrant at home.  

diff --git a/MinimalPersoniumUnit4Testing.md b/MinimalPersoniumUnit4Testing.md
@@ -1,7 +1,8 @@
 # Why I provide this Vagrant box for Personium beginners  
 When you just want to try out Personium APIs or play around with the applications provided from Took a very long time to construct the Vagrant version. Basically it always failed to be installed in proxy environment.  
 
-# Procedures to jump start the user-friendly Personium Unit  
+# How to install and turn on the user-friendly Personium Unit  
+## 1. How to deploy  
 1. Download [personium_unit_20190128.box](https://drive.google.com/open?id=1RmU5RExwXVgXwK7cNtSti-im236qW5-A) to your computer (specify a folder).  
 1. Move to the folder and execute the following command.  
 `vagrant box add p_unit personium_unit_20190128.box`  
@@ -23,17 +24,27 @@ When you just want to try out Personium APIs or play around with the application
 1. Run vagrant up again
 1. Crtl-C to stop the process.  
 1. Check out the VirtualBox Manager, you will see a VM is running.  
+
+## 2. How to get login information    
 1. Execute the following command to SSH to the Personium Unit.  
 Password is "vagrant"  
 `vagrant ssh`  
 1. Execute the following command to gain root permission.  
 `sudo su -`  
-1. Execute the following command to get the Unit Admin password.  
+1. Execute the following command to get the Unit Admin password (e.g. "JeoougAiHxbBcffx").  
 `cat /root/ansible/unitadmin_account`  
+`unitadmin JeoougAiHxbBcffx`  
 
-# Special procedures to package the official built at home and make it user-friendly   
-The following procedures were performed to finally make it works.  
+## 3. How to login to the Unit Manager  
+1. Access the following URL from the browser.  
+`https://localhost/app-uc-unit-manager/__/html/login.html`
+1. Login information  
+    - Login URL: https://localhost/unitadmin/
+    - Username: unitadmin
+    - Password: JeoougAiHxbBcffx
 
+# Complete procedures for creating this user friendly Vagrant box  
+## How to package the official built  
 1. Install virtual box and vagrant at home.  
 1. Clone the following respository to your PC.  
 `https://github.com/personium/setup-vagrant`  
@@ -48,15 +59,19 @@ Wait for 20 minutes.
 `PasswordAuthentication yes`
 1. Exexute the following command to restart sshd service.  
 `systemctl restart sshd.service`  
+1. Special operations:  
+    - Update Unit Manager  
+    - Install and modify HomeApp (localhost)  
+    - Install and modify market  
+    - Install and modify Minimal App  
+    - Create and modify dummy user cell  
 1. Wrap up the vagrant machine using the following command.  
     - syntax  
     `vagrant package --base {{machine name as it shows in virtual box}} --output {{filename of box}}`  
     - Example  
     `vagrant package --base setup-vagrant_default_1548245529126_19233 --output d:personium_unit_20190128.box`  
 1. Upload personium_unit_20190128.box to Google Drive  
 
-
-
 ## How to enable the relayhtml option for Personium Unit  
 1. Add the following line to the file "/personium/personium-core/conf/18888/personium-unit-config.properties"  
 `io.personium.core.cell.relayhtmlurl.default=https://localhost/app-cc-home/__/index.html`

diff --git a/MinimalPersoniumUnit4Testing.md b/MinimalPersoniumUnit4Testing.md
@@ -1,6 +1,36 @@
 # Why I provide this Vagrant box for Personium beginners  
 When you just want to try out Personium APIs or play around with the applications provided from Took a very long time to construct the Vagrant version. Basically it always failed to be installed in proxy environment.  
 
+# Procedures to jump start the user-friendly Personium Unit  
+1. Download [personium_unit_20190128.box](https://drive.google.com/open?id=1RmU5RExwXVgXwK7cNtSti-im236qW5-A) to your computer (specify a folder).  
+1. Move to the folder and execute the following command.  
+`vagrant box add p_unit personium_unit_20190128.box`  
+1. Init the box on the company computer using the following command.  
+`vagrant init p_unit`  
+1. Add the following lines to the newly created Vagrantfile.  
+[Sample file](https://drive.google.com/open?id=1JJIDh8bBIQ9pxT9awNO1FVyJ5VdbkaZI)/[Sample file (behind authenticated proxy)](https://drive.google.com/open?id=1kt4UTy1ewV5mOwCBHPW7g5ZHb4vGYMKy).   
+
+    ...
+    config.vm.network "forwarded_port", guest: 443, host: 443
+    config.vm.network "private_network", ip: "192.168.33.10"
+    ...
+    config.vm.provider "virtualbox" do |vb|
+      vb.memory = "2048"
+    end
+
+1. Run vagrant up
+1. Ignore the authenticate error.   
+1. Run vagrant up again
+1. Crtl-C to stop the process.  
+1. Check out the VirtualBox Manager, you will see a VM is running.  
+1. Execute the following command to SSH to the Personium Unit.  
+Password is "vagrant"  
+`vagrant ssh`  
+1. Execute the following command to gain root permission.  
+`sudo su -`  
+1. Execute the following command to get the Unit Admin password.  
+`cat /root/ansible/unitadmin_account`  
+
 # Special procedures to package the official built at home and make it user-friendly   
 The following procedures were performed to finally make it works.  
 
@@ -49,27 +79,3 @@ Execute the following procedures to apply the fixes to your Personium Unit.
 6. Execute the following command to restart tomcat  
 `systemctl restart tomcat`  
 
-# Procedures to start the Personium Unit  
-1. Download [personium_unit_20190128.box](https://drive.google.com/open?id=1RmU5RExwXVgXwK7cNtSti-im236qW5-A) to your computer (specify a folder).  
-1. Move the folder and execute the following command.  
-`vagrant box add p_unit personium_unit_20190128.box`  
-1. Init the box on the company computer using the following command.  
-    - syntax  
-    `vagrant init {{box name}}`  
-    - Example  
-    `vagrant init p_unit`  
-1. Add the following lines to Vagrantfile  
-[Sample file](https://drive.google.com/open?id=1JJIDh8bBIQ9pxT9awNO1FVyJ5VdbkaZI)/[Sample file for authenticated proxy](https://drive.google.com/open?id=1kt4UTy1ewV5mOwCBHPW7g5ZHb4vGYMKy).   
-
-    ...
-    config.vm.network "forwarded_port", guest: 443, host: 443
-    config.vm.network "private_network", ip: "192.168.33.10"
-    ...
-    config.vm.provider "virtualbox" do |vb|
-      vb.memory = "2048"
-    end
-
-1. Run vagrant up
-1. Ignore the authenticate error.   
-1. Run vagrant up again
-1. Crtl-C to stop the process.  
diff --git a/MinimalPersoniumUnit4Testing.md b/MinimalPersoniumUnit4Testing.md
@@ -59,7 +59,8 @@ Execute the following procedures to apply the fixes to your Personium Unit.
     - Example  
     `vagrant init p_unit`  
 1. Add the following lines to Vagrantfile  
-
+[Sample file](https://drive.google.com/open?id=1JJIDh8bBIQ9pxT9awNO1FVyJ5VdbkaZI)/[Sample file for authenticated proxy](https://drive.google.com/open?id=1kt4UTy1ewV5mOwCBHPW7g5ZHb4vGYMKy).   
+
     ...
     config.vm.network "forwarded_port", guest: 443, host: 443
     config.vm.network "private_network", ip: "192.168.33.10"

diff --git a/MinimalPersoniumUnit4Testing.md b/MinimalPersoniumUnit4Testing.md
@@ -0,0 +1,74 @@
+# Why I provide this Vagrant box for Personium beginners  
+When you just want to try out Personium APIs or play around with the applications provided from Took a very long time to construct the Vagrant version. Basically it always failed to be installed in proxy environment.  
+
+# Special procedures to package the official built at home and make it user-friendly   
+The following procedures were performed to finally make it works.  
+
+1. Install virtual box and vagrant at home.  
+1. Clone the following respository to your PC.  
+`https://github.com/personium/setup-vagrant`  
+1. Execute the following command to construct your server.  
+Wait for 20 minutes.  
+`vagrant up`  
+1. Execute the following command to SSH to your Personium Unit.  
+`vagrant ssh`  
+1. Execute the following command to gain root permission.  
+`sudo su -`
+1. Uncomment the following line in "/etc/ssh/sshd_config".  
+`PasswordAuthentication yes`
+1. Exexute the following command to restart sshd service.  
+`systemctl restart sshd.service`  
+1. Wrap up the vagrant machine using the following command.  
+    - syntax  
+    `vagrant package --base {{machine name as it shows in virtual box}} --output {{filename of box}}`  
+    - Example  
+    `vagrant package --base setup-vagrant_default_1548245529126_19233 --output d:personium_unit_20190128.box`  
+1. Upload personium_unit_20190128.box to Google Drive  
+
+
+
+## How to enable the relayhtml option for Personium Unit  
+1. Add the following line to the file "/personium/personium-core/conf/18888/personium-unit-config.properties"  
+`io.personium.core.cell.relayhtmlurl.default=https://localhost/app-cc-home/__/index.html`
+
+2. Execute the following command to restart tomcat  
+`systemctl restart tomcat`
+
+## How to apply latest fixes to Personium Unit  
+When the official release are not ready, Vagrant version will not construct Personium Unit with the latest fixes.  
+However, you can compile your own war files or ask the core member to provide the bug fixed war files to you.  
+Execute the following procedures to apply the fixes to your Personium Unit.  
+
+1. Download the war files (personium-core.war, personium-engine.war, etc) provided by the core members.  
+2. Upload the war files to your Personium Unit (usually under the your home directory "/home/vagrant/")  
+3. SSH to your Personium Unit (vagrant ssh or use mobaxterm)  
+4. Execute the following command to gain root permission  
+`sudo su -`  
+5. Copy the war files (personium-core.war, personium-engine.war, etc) to the following folder.  
+`/opt/tomcat/webapps/`   
+6. Execute the following command to restart tomcat  
+`systemctl restart tomcat`  
+
+# Procedures to start the Personium Unit  
+1. Download [personium_unit_20190128.box](https://drive.google.com/open?id=1RmU5RExwXVgXwK7cNtSti-im236qW5-A) to your computer (specify a folder).  
+1. Move the folder and execute the following command.  
+`vagrant box add p_unit personium_unit_20190128.box`  
+1. Init the box on the company computer using the following command.  
+    - syntax  
+    `vagrant init {{box name}}`  
+    - Example  
+    `vagrant init p_unit`  
+1. Add the following lines to Vagrantfile  
+
+    ...
+    config.vm.network "forwarded_port", guest: 443, host: 443
+    config.vm.network "private_network", ip: "192.168.33.10"
+    ...
+    config.vm.provider "virtualbox" do |vb|
+      vb.memory = "2048"
+    end
+
+1. Run vagrant up
+1. Ignore the authenticate error.   
+1. Run vagrant up again
+1. Crtl-C to stop the process.
No results found