CloudFusion Installation Guide

Transcription

1 CloudFusion Installation Guide Version InfinitiesSoft Solutions Inc.

2 Contents 1. Software and Hardware Requirements 1.1 Operating System Requirements 1.2 Hardware Requirements 2. Installation Preparation 2.1CloudFusion Root Folder Creation 2.2 Java Version Validation 2.3 PostgreSQL Database Installation 3. Installation Abstract 4. CloudFusion Installation Package Setup 5. CloudFusion Database Setup 6. CloudFusion Configuration 6.1 Pre setting notes 6.2 ActiveMQ Connection Setup 6.3 CloudFusion Database Connection Setup 6.4 QuartzDB Database Connection Setup 7. Skyport Configuration 7.1 Notes before configuration 1

3 7.2 Setting the name for Skyport 7.3 VNC CONNECTION SETUP 7.4 Skyport GUI Display Setup 8. Sequence of service activation 9. Service Activation 9.1 Apache ActiveMQ Service 9.2 Apache Tomcat Service 9.3 Infinities Skyport Service 10. Sequence to shut down the service 11. Service Shutdown 11.1 Apache ActiveMQ Service 11.2 Apache Tomcat Service 11.3 Infinities Skyport Service 12. Service Restart 12.1 Apache ActiveMQ Service 12.2 Apache Tomcat Service 12.3 Infinities Skyport Service 13. Service Status Display 13.1 Apache ActiveMQ Service 13.2 Apache Tomcat Service 2

4 13.3 Infinities Skyport Service 14. Skyport Operation 14.1 GUI Operation Setup 14.2 Web Page Operation Setup 14.3 Examples of Multi Platform Cloud Clustering 15. CloudFusion Operation Update License of CloudFusion: 16. Service Version Inquiry 16.1 Apache ActiveMQ Service 16.2 Apache Tomcat Service 16.3 Infinities Skyport Service 16.4 Infinities CloudFusion Application 17. Information Retrieval of Public Cloud Connection 17.1 IBM SoftLayer 17.2 Amazon EC Microsoft Azure 17.4 Alibaba Cloud: Aliyun 18. VM Configuration for Hybrid Cloud Access through VNC/RDP/SSH 18.1 VMware 19. Access Permission Configuration of Public Cloud API Policy 3

5 19.1 Amazon EC2 20. Frequently Asked Questions and Troubleshooting 20.1 Attention of Skyport Update 20.2 Attention of Multi Skyport Configuration 20.3 Validation of System Time Calibration 20.4 Skyport Environment Setup of the Hosts File 20.5 ActiveMQ Failure Troubleshooting 20.6 Data Synchronization Problem of CloudFusion and Skyport 20.7 Accessing VMware ResourcePool through Skyport 4

6 1. Software and Hardware Requirements Before installing CloudFusion, please check through software and hardware requirements to make sure all resources can meet the specification. 1.1 Operating System Requirements Microsoft Windows 7, Linux CentOS Desktop 5.5, SUSE Linux Enterprise 11 SP3, Linux Ubuntu Desktop 10.10, Linux Ubuntu Desktop (*All operating system packages must support GUI.) 1.2 Hardware Requirements Environment and Condition of ActiveMQ & Tomcat & Skyport Installed on Physical Machine (Host) Interworking with 1~2 Clouds Interworking with more than 2 Clouds One Machine Installation CPU: 2 cores + RAM: 4 GB + Storage: 100 GB + CPU: 4 cores + RAM: 8 GB + Storage: 100 GB + Distributed 2 or 3 Machine Installation CPU: 2 cores + RAM: 4 GB + Storage: 100 GB + CPU: 4 cores + RAM: 8 GB + Storage: 100 GB + Environment and Condition of ActiveMQ & Tomcat & Skyport Installed on Virtual Machine (Guest) Interworking with 1~2 Clouds One Machine Installation CPU: 2 cores + RAM: 8 GB + Storage: 100 GB + Distributed 2 or 3 Machine Installation CPU: 2 cores + RAM: 8 GB + Storage: 100 GB + 5

7 Interworking with more than 2 Clouds CPU: 4 cores + RAM: 16 GB + Storage: 100 GB + CPU: 4 cores + RAM: 16 GB + Storage: 100 GB + Note: Installation procedure will be illustrated by the example based on GUI supported version of Linux / Ubuntu 10.10, as well as the use of terminal commands for certain operation. 6

8 2. Installation Preparation 2.1 CloudFusion Root Folder Creation Under /home, create a folder named infinities, working as a main folder. Type the following command to create it. #mkdir /home/infinities Note: You can choose different name for the folder. Hereinafter, main folder means the folder created in this step. We will start the installation with main folder. Please change the working directory to it first. Command to change folder is #cd /home/infinities. Command to verify current working folder is #pwd. 7

9 2.2 Java Version Validation Verify if Oracle Java JDK/JRE 7.x has already been installed. Command to query Java version is #java version. 2.3 PostgreSQL Database Installation CloudFusion supports fixed version of PostgreSQL 9.3. If your operating system has installed PostgreSQL 9.3, please skip this step. There are different mirrors to download PostgreSQL for variant OS versions through URL Choose the one that suits your operating system. Look for Graphical installer item on the page, select the Download URL to download the setup. Download the suitable version according to your operating system. 8

10 9

11 Follow the instructions to proceed. 10

12 11

13 12

14 3. Installation Abstract This installation guide is applicable to specific version CloudFusion x.x.x. Steps of installation procedure are listed below: To set up CloudFusion installation package, please refer to Chapter 4. CloudFusion Installation Package Setup. To configure CloudFusion, please refer to Chapter 6 CloudFusion Configuration. To set up database for CloudFusion operation, please refer to Chapter 5 CloudFusionDatabase Setup. To configure Skyport, please refer to Chapter 7 Skyport Configuration. To activate respective service, please refer to Chapter 8 Service Activation Sequence and Chapter 9 Service Activation. To set up Skyport connection and operation, please refer to Chapter 14 Skyport Operation. 13

15 To operate on basic functions after finished with configuration, please refer to Chapter 15 CloudFusion Operation. To update CloudFusion License, please refer to Chapter 15 CloudFusion Operation. 14

16 4. CloudFusion Installation Package Setup Put the file named CloudFusion x.x.x.zip, which is found in InfinitiesSoft under main folder. After putting the file, check the main folder using command #ls al, to check whether the file exists. Decompress CloudFusion x.x.x.zip under main folder by executing the command #unzip CloudFusion x.x.x.zip. After file decompression is done, check decompressed contents under main folder by executing command #ls al CloudFusion x.x.x 15

17 CloudFusion x.x.x Installation folder structure: Folder Description activemq tomcat skyport Service for data and message exchange between ServiceCloudFusion and Skyport. tomcat skyport Web Application Server to execute CloudFusion task. CloudFusion Engine for communication with lower layer (e.g., Xen, EC2) of cloud platform. Note: Any inquiries regarding the respective service version under Installation folder, please refer to Chapter 16 Service Version Query.. 16

18 5. CloudFusion Database Setup We need to create two sets of configuration for two databases, respectively named cloudfusion, and quartzdb, illustrated as an example by pgadmin GUI. To create a new database connection setup, click the button indicated by the red square below. 17

19 Key in the required information to access database server. Note: Information Name Description Server connection name (regardless of language), e.g., CloudFusion_DB. Host IP Address of database server, e.g., Port Port number of database server, e.g., 5432 Username Password Account of database server, e.g., postgres Password of database server, e.g., ex. password 18

20 The configuration of the database is done. To create a new database, right click database then from the pop up menu select New Database. 19

21 Then create two databases named cloudfusion, and quartzdb using the New Database function. 20

22 The picture shows when the creation process is done. Note: Database name for CloudFusion should be strictly followed as it was required by the file IssInitParams.properties. In case you choose different name in this step, you need to modify IssInitParams.properties file too. Otherwise, system will not operate accordingly. To make any changes in the configuration, please refer to Chapter 6 CloudFusion Configuration. for details. 21

23 6. CloudFusion Configuration 6.1 Pre setting notes Attributes configuration file is located in tomcat/infinities folder. To configure the attributes, open and edit tomcat/infinities/issinitparams.properties. 6.2 ActiveMQ Connection Setup Configuration contents are illustrated below: # ActiveMQ attribute camel.timetolive = 3000 camel.hostname = CloudFusion brokerurl = tcp:\/\/ IP : PORT Note: Attributes IP Description Configure the IP address of ActiveMQ service. If both ActiveMQ service and CloudFusion are installed in the same location, this attribute can be set as localhost. PORT To set the port number of ActiveMQ service. If the port number of ActiveMQ service is changed, there is a need to change this attribute accordingly. Otherwise, it will not work correctly. An example of port number is

24 6.3 CloudFusion Database Connection Setup Configuration contents are illustrated below: # Jdbc attribute jdbc.initializedatabase = true jdbc.driverclassname = org.postgresql.driver jdbc.url = jdbc:postgresql:\/\/ IP : PORT \/ DB jdbc.username = ACCOUNT jdbc.password = PASSWORD jdbc.maxactive = 100 jdbc.maxidle = 30 (You May skip the rest) Note: Attributes IP Description Configure IP address of database server. If both database server and CloudFusion are installed in the same location, this attribute can be set as localhost. PORT Configure port number of database server. If port number of database server is changed, you have to change this attribute accordingly. Otherwise, it will not work correctly. An example of port number is DB Configure the name of database. If the name of database is changed, you have to change this attribute accordingly. Otherwise, it will not work correctly. An example of name for the database is cloudfusion. 23

25 ACCOUNT Configure account for database connection. Ex. postgres. PASSWORD Configure password of database connection. Ex. password. 6.4 QuartzDB Database Connection Setup Configuration contents are illustrated below: (You may skip the content above) org.quartz.jobstore.clustercheckininterval = org.quartz.datasource.myds.driver = org.postgresql.driver org.quartz.datasource.myds.url = jdbc:postgresql:\/\/ IP : PORT \/ DB org.quartz.datasource.myds.user = ACCOUNT org.quartz.datasource.myds.password = PASSWORD org.quartz.datasource.myds.maxconnections = 5 org.quartz.datasource.myds.validationquery = select 0 from qrtz_locks Note: Attributes Description IP Configure IP address of database server. If both database server and CloudFusion are installed in the same location, this attribute can be set as localhost. PORT Configure port number of database server. If port number of database server is changed, you have to change this attribute 24

26 accordingly. Otherwise, it will not work correctly. An example of port number is DB Configure the name of database. If the name of database is changed, you have to change this attribute accordingly. Otherwise, it will not work correctly. An example of database name is quartzdb. ACCOUNT Configure account for database connection. Ex. postgres. PASSWORD Configure password of database connection. Ex. password. 25

27 7. Skyport Configuration 7.1 Notes before configuration Respective attributes files are located under skyport/config folder. 7.2 Setting the name for Skyport Open and edit CamelHandler.properties file Configuration contents are illustrated below: #Skyport name must unique in cluster skyport.name= NAME consumer.jms.options=asyncstartlistener=true& asyncconsumer=true&concurrentconsumers=10& maxconcurrentconsumers=20& selector=skyportname=' NAME ' Note: Attribute Description NAME If Skyport is installed on multiple machines in the same CloudFusion management domain, you have to assign name for Skyport, and the the name must be different to avoid confusion and duplication within the same. Suppose two machines have Skyport installed. The first machine can be named 26

28 SkyportCamel Local and the second one can be named SkyportCamel Remote. 2. Name of the two attributes inside this configuration file for this machine must be the same, for example, SkyportCamel. Attention! Once Skyport is already synced with CloudFusion and initialization completed, DO NOT change Skyport name any more. Otherwise, it will cause system to operate abnormally. 27

29 7.3 VNC CONNECTION SETUP Open and edit websockify.xml File. Configure the contents as below: <?xml version='1.0' encoding='utf 8'?> <ConnectorSet> <Connector mode="local" protocol="http/1.1" ip=" IP " (You may skip the rest) Note: Attribute IP Description To configure public IP address of Skyport environment. If public IP is not set, CloudFusion will not be able to be switch on the VNC connection remotely on the virtual machine. Ex. IP configuration is

30 7.4 Skyport GUI Display Setup Open and edit skyport.properties file. Configure the contents as below: ui.enabled= TF profile.key=gsodo9hagldh09ccaxeq0w== #hazelcast or disabled cluster.delegate=disabled timezone=gmt+8\:00 limit.max=0 cache.enabled=true async.recover=true Note: Attributes TF Description 1. This attribute determines if you are able to operate Skyport through console GUI. For example, you set it to true to allow console GUI. 2. The attribute values are applied as follows: If true, you will be able to operate Skyport through console GUI. 29

31 If false, you can only operate Skyport through Web UI. Attention! By default, Skyport can be operated with Web UI. 8. Sequence of service activation Apache ActiveMQ Service Apache Tomcat Service Infinities Skyport Service 30

32 9. Service Activation 9.1 Apache ActiveMQ Service Execute following command to activate ActivateMQ service: #./CloudFusion x.x.x/activemq/bin/activemq start Note: To validate whether the service is successfully activated, please refer to Chapter 13 Service Status Display. URL to access ActiveMQ: Public IP:8161/admin/queues.js (Default login account: admin/admin) 31

33 9.2 Apache Tomcat Service Execute following command to activate Tomcat service #./CloudFusion x.x.x/tomcat/bin/startup.sh Note: To validate whether the service is successfully activated, refer to Chapter 13 Service Status Display. URL to access Tomcat: Public IP:8080/cloudfusion 32

34 9.3 Infinities Skyport Service Execute following command to activate Skyport service#./cloudfusion x.x.x/skyport/bin/skyport start Note: To validate whether the service is successfully activated, please refer to Chapter 13 Service Status Display. To set up Skyport connection and operation, please refer to Chapter 14 Skyport Operation. 33

35 10. Sequence to shut down the service Infinities Skyport Service Apache Tomcat Service Apache ActiveMQ Service 34

36 11. Service Shutdown 11.1 Apache ActiveMQ Service Execute following command to stop ActiveMQ service: #./CloudFusion x.x.x/activemq/bin/activemq stop Note: To validate whether the service is successfully stopped, please refer to Chapter 13 Service Status Display Apache Tomcat Service Execute following command to stop Tomcat service: #./CloudFusion x.x.x/tomcat/bin/shutdown.sh Note: To validate whether the service is successfully stopped, please refer to Chapter 13 Service Status Display. 35

37 11.3 Infinities Skyport Service Execute following command to stop Skyport service: #./CloudFusion x.x.x/skyport/bin/skyport stop Note: To validate whether the service is successfully stopped, please refer to Chapter 13 Service Status Display. 36

38 12. Service Restart 12.1 Apache ActiveMQ Service Execute following command to restart ActiveMQ service: #./CloudFusion x.x.x/activemq/bin/activemq restart Note: To validate whether the service is successfully stopped, please refer to Chapter 13 Service Status Display Apache Tomcat Service Execute following command sequence to restart Tomcat service: Service Shutdown Service Activation 37

39 Note: To validate whether the service has successfully restarted, please refer to Chapter 13 Service Status Display Infinities Skyport Service Execute following command to restart Skyport service: #./CloudFusion x.x.x/skyport/bin/skyport restart Note: To validate whether the service is successfully restarted, please refer to Chapter 13 Service Status Display. 38

40 13. Service Status Display 13.1 Apache ActiveMQ Service Access following URL to test: Public IP:8161 Service Activation Display is shown as following figure. 39

41 Service Shutdown Display is shown below. Users will see the browser caption: This web page is not available. 40

42 13.2 Apache Tomcat Service Access following URL to test: Public IP:8080 Service Service 41

43 13.3 Infinities Skyport Service Access following URL to test: Public IP:8085 Service Activation Display is shown as following figure. 42

44 Service Shutdown Display is shown as following figure. You will see the following browser caption: This web page is not available. 43

45 14. Skyport Operation 14.1 GUI Operation Setup Note: Procedure in this chapter will be based on TF configuration that is illustrated in Chapter 7.4 Skyport GUI Display Setup as an example To add a new cloud connection, select [Add] button indicated in red rectangle Setup of cloud connection, e.g., to connect VMWARE is illustrated below: Name: vmware Description: Test vmware Driver: vmware pool driver Server: pool manager IP, e.g., (vcenter IP) User: root (login account) Password: ******* (login password) Domain: pool manager IP,ex (vcenter IP) 44

46 Select [Test] button to verify the connection A connection success is i A failed connection will be shown like the illustration below. 45

47 46

48 If the connection is successful, click the [OK] button Execute the API named gettemplatelist to verify validity of the data. The procedure is listed below: Select [Testing]. Select [any designated cloud cluster] from the drop down menu. 47

49 Select [gettemplatelist] from the options shown. Select [Submit] button. Check the response text box. The picture shown an example of a normal connection. 48

50 Below is another example of any error detected. If the error message is shown in the response textbox, it means Skyport is under the process of data collection. You need to wait for 1~2 minutes before you check again. Error message of this case: [{"RES":"FALSE","REASON":"java.lang.IllegalStateException: collecting data, please try later"}] 49

51 14.2 Web Page Operation Setup Note: URL: Public IP:8085 admin/ Login to Skyport management interface. Default account and password is To add a new connection, select [New] item (as indicated in the red rectangle below). 50

52 VMWARE Setup configuration data for cloud cluster connection, e.g., to connect Pool name: vmware Description: Test vmware Driver: vmware pool driver Server IP: pool manager IP,ex (vcenter IP) Login name: root (login account) Password: ******* (login password) Domain: pool manager IP,ex (vcenter IP) Select [Test Connection] button to verify the connection. A connection 51

53 A connection 52

54 Once the connection is successful, click [Create Pool] button. 53

55 Execute the API named gettemplatelist to verify the data validity. The procedure is listed as below: Select [VM Pool] icon. Select [any designated cloud] item. Select [API] item. Select [gettemplatelist] API item. Select [Call API] button. Select [data] item to expand the data tree. Following figure is a example of a successful Call API execution. A connection success is illustrated as below. 54

56 Below is another example of error. If the error message appears, it means Skyport is collecting data. You need to wait for 1~2 minutes before you check again. The error in this case is: [{"RES":"FALSE","REASON":"java.lang.IllegalStateException: collecting data, please try later"}] 55

57 14.3 Examples of Multi Platform Cloud Clustering Name (Pool name) Description Driver Server (Server IP) Determined by yourself. Determined by yourself. Choose the configured hypervisor driver. cake: hypervisor IP or hostname scvmm: hypervisor IP or hostname xen: hypervisor IP or hostname vmware: hypervisor IP or hostname openstack: hypervisor IP or hostname rhev: hypervisor IP or hostname softlayer: api.softlayer.com/rest/v3 ec2: ec2 aliyun: azure: CLOUD SERVICES NAME ex. DemoServiceWin User (Login name) cake: Center login name ex. admin scvmm: scvmm login name ex. Administrator xen: Xen Server login name ex. root vmware: vcenter Server login name ex. root, *instead of ESXi host username. openstack: project login name ex. admin rhev: rhevm login name ex. admin softlayer: refer to 17.1 IBM SoftLayer. 56

58 ec2: refer to 17.2 Amazon EC2. azure: refer to 17.3 Microsoft Azure. aliyun: refer to 17.4 Alibaba Cloud: Aliyun. Password cake: configure the account and password of chosen hypervisor. scvmm: configure the account and password of chosen hypervisor. xen: configure the account and password of chosen hypervisor. vmware: configure the account and password of chosen hypervisor. openstack: configure the account and password of chosen hypervisor. rhev: configure the account and password of chosen hypervisor. softlayer: refer to 17.1 IBM SoftLayer. ec2: refer to 17.2 Amazon EC2. azure: refer to 17.3 Microsoft Azure. aliyun: refer to 17.4 Alibaba Cloud: Aliyun. Domain cake: IP scvmm: IP xen: IP vmware: IP openstack: project name rhev: internal softlayer: softlayer ec2: ec2 57

59 aliyun: cn shenzhenor or else. azure: East USor or else. 58

60 15. CloudFusion Operation Following procedure is a tutorial based on the service that has been successfully activated. For any troubleshooting regarding abnormal operation after service activation, please refer to Chapter 20 Frequently Asked Questions and Troubleshooting. Login to CloudFusion through administrator account: (administrator s account/password: admincreator / admin123) Note: The current password of administrator account (Admincreator) of CloudFusion platform is not allowed to be modified. 59

61 Update License of CloudFusion: Select [License Update] item. Click [Select File] button and select CloudFusion.ser, the software authorization file provided by InfinitiesSoft. Select [Upload] button 60

62 Skyport is an accessory software for CloudFusion. It can list the corresponding Skyport to the CloudFusion, and for Admincreator to determine which Skyport to be connected. After Skyport configuration is done, the system will synchronize Skyport with configured Pool and then define it as cloud by CloudFusion. Admincreator will be able to manage and control the cloud through this configuration for this platform by following the instruction below: Select [Hypervisor] item. Check or uncheck designated cloud. 61

63 To create a new organization configuration data and account for a company or personnel, please follow the steps below. Select [Company]. Select [New company]. Fill in information of the company. Click the [Create] button. To modify configuration of existing cloud of the company, please follow the steps below. 62

64 Select [Company]. Select [any designated company]. Select [Resource]. Check or uncheck any company shown. Specify each resource capacity for the resource pool. Select [Update] button 補充說明 : 其它相關操作說明, 可參考 CloudFusion 操作手冊 欲刪除任何雲平台之前, 平台管理者應主動告知各租戶管理者刪除通知 63

65 刪除雲平台正常流程 : 租戶取消納管雲端群 (CloudFusion 平台管理者 ) 取消訂閱雲端群 (CloudFusion 平台管理者 ) 刪除雲端群 (Skyport 平台管理者 ) 16. Service Version Inquiry 16.1 Apache ActiveMQ Service Execute the command below to check the version: #./CloudFusion x.x.x/activemq/bin/activemq version 64

66 16.2 Apache Tomcat Service Execute the command below to check the Tomcat version: #./CloudFusion x.x.x/tomcat/bin/version.sh 65

67 16.3 Infinities Skyport Service Execute the command below to check the Skyport service version: #cat CloudFusion x.x.x/skyport/config/wrapper.conf grep version 16.4 Infinities CloudFusion Application Operation procedure: Login through account of CloudFusion administrator or any user, e.g., platform administrator s account/password: admincreator / admin123. Select [Login] at the bottom of the navigation panel to expand its submenu. Select [About]. 66

68 17. Information Retrieval of Public Cloud Connection 17.1 IBM SoftLayer Management Web URL: e.g., account/password: SL123456/password 67

69 Step to acquire Skyport login name: Login to SoftLayer management interface using the registered account, e.g., SL Steps to acquire Skyport Password: Login to Softlayer management interface. Select Login name at top right corner, e.g., PITT CHEN. Look for API Access Information then copy the Authentication Key. 68

70 17.2 Amazon EC Management Web URL: e.g., account/password: 69

71 Steps to acquire information of Skyport User (Login name): Login to EC2 management interface. Select Security Credentials from the drop down menu at top right corner. Then select Access Keys (Access Key ID and Secret Access Key). 70

72 Step to acquire Skyport Password: **When creating a set of Access Keys only one Secret Access Key will be given to you. Please, keep it properly. If you ever lost it, you will have to register again to get a new key. 71

73 17.3 Microsoft Azure Management interface URL: us/account/ e.g., account/password: gmail.com/password 72

74 Procedure to acquire and input information of Skyport User (Login name): Login to Azure management interface. Select Subscriptions item at left navigation panel. Copy the content in the Subscription ID column. 73

75 Step to acquire Skyport Password: Login to Azure management interface. Access URL: System will download the credentials file immediately. After the download is finished, put the file under any folder in the Skyport, e.g., /home/cloudfusion. Input entire file address as the attribute value for Skyport Password, /home/cloudfusion/pay As You Go credentials.publishsettings Alibaba Cloud: Aliyun Management interface URL: 74

76 e.g., account/password: Step to acquire Skyport User login name: Login to Aliyun management interface. Select AccessKeys. Copy content in the Access Key ID column Procedure to acquire and input information of Skyport Password: Login to Aliyun management interface. Select AccessKeys at the menu bar. 75

77 Click the Show highlighted text at Access Key Secret column (indicated by the red rectangle below) to copy the password. 18. VM Configuration for Hybrid Cloud Access through VNC/RDP/SSH 18.1 VMware You have to switch on each esxi. Configuration is shown as follows: Select [Home] > [Hosts and Clusters] item. Select [any esxi] item. 76

78 Select [Configuration]. Select [Security Profile]. Select [Properties...]. Check [VM serial port connected over...] option. Click [OK] button. 77

79 78

80 19. Access Permission Configuration of Public Cloud API Policy 19.1 Amazon EC2 All privileges of API are all opened for main account by default. If API is accessed through another account, you must configure API access permission for that account. Configuration is shown below: Select [Services]. Select [Security & Identity] at All AWS Services column. Select [IAM] item. Select [Users] item. 79

81 Select [any account to configure for] item, e.g., issuser_qa. 80

82 Select [Permissions] Select [Attach Policy] Select [any account to configure for] Select [Attach Policy] button 81

83 20 CloudFusion 各服務及混合雲平台需要開通的 Port 資訊 20.1 CloudFusion 各服務預設使用的 Port 資訊 服務名稱 Port 說明 CloudFusion Web 8080 瀏覽器連接 CloudFusion Web 介面預設使用的 Port Skyport Web 8085 瀏覽器連接 Skyport Web 介面預設使用的 Port ActiveMQ Web 8161 瀏覽器連接 ActiveMQ Web 介面預設使用的 Port ActiveMQ 端口 透過此 Port 進行 CloudFusion 與 Skyport 的資料傳遞與接收 20.2 VMware 雲平台預設使用的 Port 資訊 服務名稱 :CloudFusion 串接 VMware 操作虛擬機連線 Port:5901 ~ 5964 說明 :CloudFusion 透過 port 呼叫 Skyport 給予虛擬機連線,Skyport 則呼叫 vcenter API 並使用 ESXi 5901~5964 其中一個 port, 再根據 vcenter 回傳的資訊建立 VNC 連線 URL, 並透過 port 回傳 CloudFusion 彈出連線視窗 20.3 RHEVM 雲平台預設使用的 Port 資訊 服務名稱 :CloudFusion 串接 RHEVM 操作虛擬機連線 Port:5901 ~ 5964 說明 :CloudFusion 透過 port 呼叫 Skyport 給予虛擬機連線,Skyport 則呼叫 RHEVM API 並使用 RHEVH 5901~5964 其中一個 port, 再根據 RHEVM 回傳的資訊建立 VNC 連線 URL, 並透過 port 回傳 CloudFusion 彈出連線視窗 82

84 20.4 Xen 雲平台預設使用的 Port 資訊 服務名稱 :CloudFusion 串接 Xen 操作虛擬機連線 Port: 說明 :CloudFusion 透過 port 呼叫 Skyport 給予虛擬機連線,Skyport 則呼叫 Xen API, 再根據 Xen 回傳的資訊建立 VNC 連線 URL, 並透過 port 回傳 CloudFusion 彈出連線視窗 20.5 OpenStack 雲平台預設使用的 Port 資訊 服務名稱 :CloudFusion 串接 OpenStack 操作虛擬機連線 Port:6081 說明 :CloudFusion 透過 port 呼叫 Skyport 給予虛擬機連線,Skyport 則呼叫 OpenStack nova API, 再根據 OpenStack 回傳的資訊建立 VNC 連線 URL(nova xvp vnc 預設 port 6081), 並透過 port 回傳 CloudFusion 彈出連線視窗 20.6 SCVMM 2012 雲平台預設使用的 Port 資訊 服務名稱 :CloudFusion 串接 SCVMM 2012 操作虛擬機連線 Port:

85 說明 :CloudFusion 透過 port 呼叫 Skyport 給予虛擬機連線,Skyport 則呼叫 SCVMM Powershell API, 再根據 SCVMM 回傳的資訊建立連線專用密碼, 並透過 port 回傳 CloudFusion 連線專用密碼 最後, 使用者可根據密碼以及額外提供的 Skyport SCVMM 連線工具來進行虛擬機連線 20. Frequently Asked Questions and Troubleshooting 20.1 Attention of Skyport Update Before you update Infinities Skyport Service, in order to prevent data inconsistency between Skyport and CloudFusion, please pay attention to the following: Please backup existing accessconfig.xml file, After you are done updating, move this backup file to the root folder of Infinities Skyport Engine. Never copy this backup file to the folder where the CloudFusion status is already synced; otherwise, it will cause the system to work abnormally. The name of Skyport must be kept the same either it is a new version or an old one. To set up Skyport, please refer to Chapter 7 Skyport Configuration Attention of Multi Skyport Configuration If you need to set up a Multi Skyport, Infinities will provide you with another installation pack. Make a copy of Infinities Skyport Engine, move it to designated location, and modify the Skyport name. You also need to remove accessconfig.xml file if there is already an 84

86 existing one, because accessconfig.xml does not belong to the location. You may activate Skyport then Validation of System Time Calibration Please keep the time of Server site and Client site in sync; otherwise, you will not be able to login to CloudFusion Skyport Environment Setup of the Hosts File In case any error occurs during the process of Skyport, try to add new host name to the corresponding IP. Configure it in the hosts file under the following path: For the Linux, i.e., /etc/hosts, e.g., localhost For Windows, i.e., C:\Windows\system32\drivers\etc\hosts, e.g., localhost 20.5 ActiveMQ Failure Troubleshooting When ActiveMQ fails to work, check activemq.xml configuration file whether port number 5672 is occupied by other application or not.... "<transportconnector name="amqp" uri="amqp:// : 5672?maximumConnections=1000&wireFormat.maxFrameSize= "/>" 85

87 20.6 Data Synchronization Problem of CloudFusion and Skyport When the administrator of CloudFusion platform registers a cloud, the system will automatically perform data synchronization with Skyport and data transfer via ActiveMQ mechanism. If it takes too long to complete data synchronization or any unusual synchronization has been observed, which causes CloudFusion not able to display the ResourcePool, Host, Template, Virtual machine (VM) and other data, etc., please check the procedure below for troubleshooting. Registration of cloud usually takes about 15~30 minutes for data synchronization. You will not be able to execute any cloud configuration until the data synchronization is finished. Access Infinities Skyport Service: URL: Public IP:8085 (Default login account: admin/1111) On the Skyport page (shown in the picture below), select Listener (indicated by the red rectangle), and you shall see a list of listeners provided. Note: The Skyport Listener menu is to check the status of ActiveMQ Service during data transfer. Currently, only Skyport page provides the Listener option. 86

88 Access Apache ActiveMQ Service: URL: Public IP:8161/admin/queues.jsp (Default login account: admin/admin) On the ActiveMQ page shown below, select Queues (indicated by the red rectangle) to gain access to Queues page. 87

89 This is the list of Listeners in the Skyport Listener and the list of ActiveMQ Queues: Skyport Listener ActiveMQ Queues Remarks CamelHostListener CamelNetworkListener CamelResourcePoolListener CamelTemplateListener CamelVmListener HostChangeNotify NetworkChangeNotify ResourcePoolChangeNotify TemplateChangeNotify VmChangeNotify VmMetricsNotify Basic information of the platform. Basic information of network interface card. Basic information of resource pool. Basic information of template. Basic information of virtual machine. Basic information of virtual machine real time monitoring.. Note: Skyport Listener attribute will be displayed as is ListenerName_ConfigId, e.g., CamelHostListener_7deccec8. 88

90 The types of attributes in the Skyport Listener list are described as follows. Attribute Value REFRESHED ADDED MODIFIED REMOVED Remarks An action type of Skyport for initialization at first time start or restart. A action type to add a new virtual machine. A action type to modify specification of existing virtual machine. A action type to remove a virtual machine. Note: The Attribute Value is for the CloudFusion to operate remotely on Virtual Machine, e.g., add, modify, and remove virtual machine, which are type identifiers for communication to the Skyport. In the Skyport Listener list, Action attribute are described below: Action Attribute Remarks Register Trigger Receive Send Ignore 1. Register a cloud. 2. Skyport Core module transfers existing data to the Skyport icloud module. 3. Skyport icloud module receives existing data to transfer existing up to date data to ActiveMQ Service If data update is not required, Skyport icloud will not transfer them to ActiveMQ Service. Note: Action Attribute is used to verify the process during synchronization between CloudFusion and Skyport, to check if Skyport has successfully transfers data to ActiveMQ service or not. 89

91 In the Skyport Listener list, other attributes are described below: Attribute Date Location Message Note: Remarks The last update time. P.S., only the latest record is displayed. Class Name, the content of the operation. Result. P.S., number in parentheses presents the total count of corresponding record. CamelVmListener REFRESHED requires special attention, It provides not only basic information of virtual machine but also real time monitoring information. Because data exchange for real time monitoring information is more complicated, you can observe frequent time change(indicated in the red rectangle below) for Date Attribute, and a time gap in the latest record of the virtual machine information update(indicated in the blue rectangle below). 90

92 When checking the ActiveMQ web page, if you come across that multiple records persistently stay in the Number Of Pending Messages Attribute of the Queues list (illustrated in the following figure) and if they are not possibly be updated to the CloudFusion platform, please restart Apache Tomcat Service, until the attribute of this record is reduced to 0. To restart the service, please refer to Chapter 12 Service Restart. 91

93 In case the data synchronization problem remain unsolved, please collect the logs required (as shown below) and contact Infinities technical support staff. Apache ActiveMQ Service Logs: Log repository path: /CloudFusion/activemq/data. Log file name: activemq.log Apache Tomcat Service Logs: Log repository path: /CloudFusion/tomcat/logs. 92

94 Log file name: cloudfusion.camel.log Infinities Skyport Service Logs: Log repository path: /CloudFusion/skyport/logs. Log file name: activemq.log, camel.log, server.log 20.7 Accessing VMware ResourcePool through Skyport Skyport ResourcePool will not be able to be configured if the Skyport ResourcePool is not able to retrieve any information. A cluster can be added in VMware in Skyport to access the information of VMware ResourcePool. 93

95 94