Interstage Application Server V1 powered by Windows Azure Getting Started Guide Windows B1FW-5952-01ENZ0(01) January 2012
Preface Purpose of This Document This document explains the main features of Interstage Application Server V1 powered by Windows Azure. It also explains configurations and operations using a simple sample application to help you understand how to start working with Java EE 6 applications in Windows Azure environments. Assumed Knowledge This document assumes that readers already have a basic knowledge in the following: - Java - GlassFish v3.1 - Internet - Microsoft Windows Azure Organization of This Document This document is organized as follows: Chapter 1 Overview of Interstage Application Server V1 powered by Windows Azure This chapter explains the product's features and main advantages. Chapter 2 Tutorial This chapter explains the workflow staring at the build of the operating environment on Windows Azure up to working with the developed Java EE 6 applications. Appendix A Checking the Storage Access Key This chapter explains how to check the created storage access key. Registered trademarks - Microsoft, Windows Azure, Windows and Windows Server are trademarks or registered trademarks of Microsoft Corporation in the United States and other countries. - Java and all references to Java are registered trademarks of Oracle Corporation and its subsidiaries and affiliated companies in the United States and other countries. Company names and product names in this document may be trademarks or registered trademarks of their respective companies. - Other proper names, such as product names, are trademarks or registered trademarks of their respective companies. Terminology In this document, 'Eclipse' is used to refer to both the Interstage Studio and Eclipse development environments. The Interstage Studio directory configuration may be different from the Eclipse directory configuration. Cautions about URLs mentioned in the manuals The URL links in the manuals are accurate as of June 2011. These may change. About Management Portal The Management Portal operations are accurate as of June 2011. These may change. - i -
Legal Notices and Disclaimers This document contains technology relating to strategic products controlled by export control laws of the producing and/ or exporting countries. This document or a portion thereof should not be exported (or re-exported) without authorization from the appropriate government authorities in accordance with such laws. Copyrights Copyright 2012 FUJITSU LIMITED - ii -
Contents Chapter 1 Overview of Interstage Application Server V1 powered by Windows Azure...1 1.1 Features...1 1.2 Main Advantages...1 Chapter 2 Tutorial...2 2.1 About the Sample Application...2 2.1.1 Overview of the Sample Application...2 2.2 Flow from Environment Settings until Operation...2 2.3 Advance Preparation before Environment Settings...3 2.3.1 Creating the Affinity Group and Hosted Service...3 2.3.2 Creating the Windows Azure Storage Account...5 2.3.3 Creating the Certificate...5 2.3.4 Registering the Certificate in Management Portal...5 2.3.5 Creating the PKCS#12 Format Certificate...6 2.4 Environment Settings...6 2.4.1 Installing the Eclipse Plug-in...7 2.4.2 Building the Development Environment...8 2.4.3 Configuring the Windows Azure Connection...8 2.4.4 Create a Sample Application...12 2.4.5 Deploying the Application...12 2.5 Application Operation...13 2.5.1 Starting the Application Operation...13 2.5.2 Executing the Application...13 Appendix A Checking the Storage Access Key...15 - iii -
Chapter 1 Overview of Interstage Application Server V1 powered by Windows Azure This product is comprised of a series of services that enable Windows Azure to use an application platform based on the open source software GlassFish v3.1. 1.1 Features This product has the following features: - An application platform based on GlassFish v3.1 runs on Windows Azure Platform. An Application platform based on GlassFish v3.1 that runs on Windows Azure Platform can be accepted as platform services. This product works with the latest Java runtime environment. - Ability to easily build the runtime environment. You can accept services whenever you want, and as much as you want, without the need for any complex tasks such as system build, middleware installation, and specifying configuration parameters. - Support in case of sudden load increase/decreases. By increasing/decreasing Worker role instances, support can be provided in case of sudden loads. 1.2 Main Advantages The main advantages of this product are as follows: - Application platforms based on GlassFish v3.1 can be used as services on Windows Azure. - It is possible to deploy Web applications that conform to Java EE 6 WebProfile. - Applications can be deployed from Eclipse. Figure 1.1 Deployment of applications from Eclipse - Scale-out/scale-in is possible by increasing/decreasing instances on Windows Azure. - 1 -
Chapter 2 Tutorial This chapter explains the flow from deployment of the sample Java application to Windows Azure until operation. In the explanation below, the sample application (HelloWorld) is created, deployed, and used to confirm the execution of the application. Before executing these steps, obtain the Windows Live ID and subscription, and install Eclipse. (for details,refer to "2.4.1 Installing the Eclipse Plug-in"). 2.1 About the Sample Application 2.1.1 Overview of the Sample Application The sample application is a simple application that displays 'HelloWorld' in the Web browser. Using the Eclipse plug-in, it is possible to easily deploy the tutorial sample application for immediate use. 2.2 Flow from Environment Settings until Operation The following procedure explains the flow from application environment settings until operation. - 2 -
2.3 Advance Preparation before Environment Settings In order to use this product, the following advance preparation will be required. Creating the Affinity Group and Hosted Service Creating the Windows Azure Storage Account Creating the Certificate Registering the Certificate in Management Portal Creating the PKCS#12 Format Certificate 2.3.1 Creating the Affinity Group and Hosted Service 1. Log into Management Portal (https://windows.azure.com/) using the Windows Live ID. 2. Click New Hosted Service - the Create a new Hosted Service window will be displayed. - 3 -
3. Enter the values below: Field Value Description Choose a subscription APS Azure Make sure that a subscription has been selected Example: The subscription name 'APS Azure' is registered Enter a name for your service Enter a URL prefix for your service Choose a region or affinity group Deployment options iapsampleservice iapsample Interstage APS- East Asia Do not deploy Name of the hosted service. URL that will activate the user application. Specify a name that is unique on the Microsoft Windows Azure platform for the service URL. Data Center that will create the hosted service. To create the new affinity group, follow the steps below: 1. Select Create or choose an affinity group > Create a new affinity group - the Create a New Affinity Group window will be displayed. 2. In the Create a New Affinity Group window: - Set Affinity Group Name to Interstage APS- East Asia. - Set Location to East Asia. - Click OK. Ensure that the affinity group name is unique in the specified location. - 4 -
4. Click OK. 2.3.2 Creating the Windows Azure Storage Account To create a Windows Azure Storage Account, follow the steps below: 1. Display the Management Portal window. 2. Click New Storage Account - the Create a New Storage Account window will be displayed. 3. Enter the values below: Field Value Description Choose a subscription APS Azure Make sure that a subscription has been selected Enter a URL iapsamplestorage Storage account name. Example: The subscription name 'APS Azure' is registered Specify a name that is unique on the Microsoft Windows Azure platform for the service URL. Choose a region or affinity group 4. Click OK. Location: East Asia Select Create or choose an affinity group, then select the name created in "2.3.1 Creating the Affinity Group and Hosted Service" 2.3.3 Creating the Certificate To deploy directly from Eclipse to the Windows Azure environment, it will be necessary to verify that the authentication using the certificate was correct and that there were no problems. Pre-create an X.509 certificate with a key size of at least 2,048 bytes, including the public key, and define it from Management Portal. To create the certificate, either generate a self-signed certificate using Internet Information Services (IIS) 7, or use makecert, contained in Windows SDK (http://msdn.microsoft.com/en-us/windowsserver/bb980924), to create the certificate as follows. For details, refer to the Microsoft Corporation information. In the following example, a certificate with the name "testcert.cer" is created on the D drive. [Windows SDK execution module dir]\makecert -r -pe -a sha1 -n "CN=Windows Azure Authentication Certificate" -ss My -len 2048 sp "Microsoft Enhanced RSA and AES Cryptographic Provider" -sy 24 d:\testcert.cer" Note - For the certificate creation command, specify options which match the environment used by the customer. - Certificates created in Microsoft Windows XP cannot be used in this product. 2.3.4 Registering the Certificate in Management Portal Register the certificate (.pfx) created in 2.3.3 Creating the Certificate that contains the private key for the certificate (.cer) registered in Management Portal. - 5 -
1. In the Management Portal window, click Hosted Service, Storage Accounts. 2. Click Management Certificates. 3. Click Add Certificate - the Add New Management Certificate window will be displayed. 4. Set Choose a Subscription to APS Azure. 5. Click Browse, then select the certificate created in "2.3.3 Creating the Certificate" (testcert.cer). 2.3.5 Creating the PKCS#12 Format Certificate Create the PKCS#12 format certificate containing the private key that corresponds to the public key registered in Management Portal in "2.3.4 Registering the Certificate in Management Portal". 1. Create the certificate (.pfx), which contains the private key for the certificate (.cer) registered in Management Portal, using the certificate store of the environment in which the certificate is created (makecert). 2. In the environment in which the makecert command was executed in "2.3.3 Creating the Certificate", open the Certificate Manager snap-in for the management console by typing "certmgr.msc" in the Start menu box. 3. Expand Personal, then click Certificates. 4. Right-click "Windows Azure Authentication Certificate", then click All Tasks > Export - the Certificate Export Wizard will be displayed. 5. In the Certificate Export Wizard, select Yes, export the private key. 6. In Export File Format, select Personal Information Exchange - PKCS #12 (.PFX) - if the Enable strong protection or Export all extended properties check boxes are displayed, then select them. 7. Specify the password iaps000, and save the exported file as InterstageAPS.pfx. 2.4 Environment Settings In order to use this product, the following advance preparation will be required. Installing the Eclipse Plug-in Building the Development Environment Configuring the Windows Azure Connection Create a Sample Application Deploying the Application - 6 -
Note When the environment settings are complete, the Worker role and application platform will be installed on Windows Azure and automatically started once the installation is complete, therefore billing will occur. 2.4.1 Installing the Eclipse Plug-in This section describes how to download the Eclipse plug-in and install it in Eclipse. Operating Environment Eclipse is used as the development environment. Conditions for operation The table below lists the environments that support the Eclipse plug-in: Environment Supported value Remarks Eclipse Version 3.6.2 or later Java EE will be required for application platforms that conform to Java EE 6 WebProfile. JDK Java SE 6 u22 or later Operating System Microsoft Windows XP Microsoft Windows Server 2003 Microsoft Windows Server 2008 Windows Vista Windows 7 Memory At least 2GB At least 4GB is recommended. Disk Network At least 5MB (plug-in only) Internet connections will be possible Note If the Eclipse you are using has a plug-in other than the GlassFish plug-in added to it, then the behavior of the Eclipse plug-in of this product cannot be guaranteed. To download the Eclipse plug-in and install it in Eclipse, follow the steps below: 1. Start Eclipse. 2. Select Help > Install New Software - the Install window will be displayed. 3. Click Add - the Add Repository window will be displayed. 4. Click Archive, specify the archive (INTS_APS_TOOL<version>.zip)which is on the media, then click OK. 5. In the software list, select Interstage Tools, then click Next the Install Details window will be displayed. 6. Make sure that the software list contains the entry "Interstage Application Server powered by Windows Azure plug-in", then click Next - the Review Licenses window will be displayed. 7. Select I accept the terms of the license agreements, then click Finish. - 7 -
Note Click OK to continue when the security warning below is displayed: Warning: You are installing software that contains unsigned content. The authenticity or validity of this software cannot be established. Do you want to continue with the installation? 8. Restart Eclipse 9. Copy the license key (INTS_APS_<version>.lic ) that was downloaded separately to the following directory: [Eclipse installed dir]\plugins\com.fujitsu.interstage.azure.plugin.key_1.0.0 2.4.2 Building the Development Environment In order to execute application development and the debug tasks locally, install GlassFish v3.1 in the environment in which Eclipse has been installed. Installing GlassFish In order to execute application development and the debug tasks locally, install GlassFish v3.1 in the environment in which Eclipse has been installed. 1. Download the GlassFish v3.1 installer (or zip) file from the GlassFish website (http://glassfish.java.net/public/ downloadsindex.html). 2. Install (or deploy) the downloaded installer (or zip) file. Installing the GlassFish plug-in 1. Start Eclipse. 2. Click Help > Install New Software - the Install window will be displayed. 3. Set Work with to https://ajax.dev.java.net/eclipse, then click Add. 4. Set Name to GlassFish v2 Java EE 5 and v3 Java EE 6 Eclipse Plugin. 5. Select Glassfish Java EE 5 and Java EE 6 support, then click Next. Note If an error occurs, return to the previous window, clear Show only the latest versions of available software, then select a version other than the latest one. 2.4.3 Configuring the Windows Azure Connection Configure the connection to the application platform on Windows Azure from Eclipse. 1. From the Eclipse menu, select Window > Preferences > Interstage Application Server. - 8 -
2. Select Subscription, then enter the values below: Field Value Description Target service Microsoft Windows Azure Platform Select Microsoft Windows Azure Platform. Subscription ID XXXXXXXX-XXXX-XXXX- XXXX-XXXXXXXXXXXX String that will be notified when the subscription is purchased. Certification File InterstageAPS.pfx Name of the PKCS#12 format certificate created in "2.3.5 Creating the PKCS#12 Format Certificate". Certification Password iaps000 Password of the PKCS#12 certificate created in "2.3.5 Creating the PKCS#12 Format Certificate". Key Alias azurekeyalias (fixed) 3. Click Test Connection to check whether connection to the Windows Azure environment is possible. If the test fails, an error message will be displayed - specify correct values and test again. 4. Click OK. 5. From the Eclipse menu, select Window > Preferences > Interstage Application Server. - 9 -
6. Select Hosted Service and click New. - 10 -
7. Enter the values below: Field Value Description Hosted Service iapsampleservice Name of the hosted service created in "2.3.1 Creating the Affinity Group and Hosted Service". Deployment InterstageAPS (fixed) Deployment name. Type Staging (fixed) Environment to which user applications will be deployed. Instance Size Small Size of the instance to be created. Instance Num 2 Number of Windows Azure Worker role instances that will run the created application platform. Storage Account iapsamplestorage Storage account specified in "2.3.2 Creating the Windows Azure Storage Account Storage Access Key XXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXX XXXXXXXXXXXX Access key that will be required for inbound access to storage. For details, refer to "Appendix A Checking the Storage Access Key". 8. Click Test Connection to check whether connection to the Hosted Service specified in DNS Prefix and to the Windows Azure storage environment is possible. - 11 -
9. Click OK - the Worker role and application platform will be installed in the specified Hosted Service and automatically started once the installation is complete. Note - It will not be possible to connect from another client in a state in which the Worker role and application platform have been deployed. In Management Portal, first delete the InterstageAPS deployment then connect from the other client. - Depending on the Windows Azure load and the network convergence status, it may take a considerable while to install the Worker role and application platform in the specified Hosted Service. 2.4.4 Create a Sample Application To create the sample application, follow the steps below: 1. Start Eclipse 2. Select File > New > Project - the New Project window will be displayed. 3. In the New Project window: 1. Select Web > Dynamic Web Project and click Next - the New Dynamic Web Project window will be displayed. 2. In the New Dynamic Web Project window: 1. In Project name, enter "HelloWorld" 2. In Target runtime, click New runtime - the New Server Runtime Environment window will be displayed (for details, refer to section "Registering a GlassFish server to Eclipse" in "Eclipse 3.6 and GlassFish 3.1 integration" (http:// glassfishplugins.java.net/eclipse36/index.html)). 3. In the New Server Runtime Environment window: In Select the server type, select GlassFish > GlassFish 3.1 or GlassFish > GlassFish v3 Java EE 6, then click Next. Set JRE to "Default JRE", set Application Server Directory to the Glassfish folder under the directory in which GlassFish has been installed, then click Finish. 4. In Target runtime, select GlassFish 3.1 or GlassFish v3 Java EE 6. 5. In Dynamic web module version, select "3.0", 6. Click Finish. 3. Right-click the HelloWorld project, then select Export > WAR file - the Export window will be displayed. 4. In the Export window: 1. In Web project, enter "HelloWorld", set Destination to "D:\HelloWorld.war", then click Finish. In this example, HelloWorld.war will be created under the D drive. 2.4.5 Deploying the Application Use Eclipse to deploy the user application. 1. From the Project pop-up menu, select Interstage Application Server > Deploy- the Deploy window will be displayed. - 12 -
2. Enter the values below: Field Value Description Specify an existing war file True Determines that the specified war file will be deployed to the application platform. File HelloWorld.war The war file to be deployed to the application platform. Deploy the war file created by the project 3. Click OK. False Determines whether to build the project for which the war file will be deployed to the application platform. 4. Check the deployed application in the staging environment. 2.5 Application Operation 2.5.1 Starting the Application Operation Switch the user application that was deployed to the staging environment over to the operating environment. 1. Login to Management Portal. 2. Click Hosted Services, Storage Accounts. 3. Click Hosted Services. 4. Select the target application. 5. Make sure that Environment is Staging, then click Swap VIP - the Swap VIPs window will be displayed. 6. Click OK. 2.5.2 Executing the Application Enter the URL below in the Web browser and check the behavior of the application: http://(name specified in the service URL).cloudapp.net/HelloWorld/ - 13 -
For (name specified in the service URL), specify the value set in Enter a name for your service of Created a new Hosted Service in "2.3.1 Creating the Affinity Group and Hosted Service". In the following example, Enter a name for your service was set to iapsampleapp, so the address would be: http://iapsampleapp.cloudapp.net/helloworld/ When the above URL is entered in the Web browser, "Hello World" will be displayed on the window. - 14 -
Appendix A Checking the Storage Access Key To check the storage access key, follow the steps below: 1. Login to Windows Azure Management Portal. 2. Click Hosted Services, Storage Accounts. 3. Click Storage Accounts. 4. Click the desired storage account. 5. Click the View button next to Primary access key in the Properties pane. The View Storage Access Keys dialog box will be displayed. 6. Click the Copy to Clipboard button next to Primary Access Key. 7. Paste the content of the clipboard to check the storage access key. - 15 -