Welcome! These instructions describe the prerequisites you should complete before attending the lab session. Please follow these steps to ensure that you are fully prepared to participate on the day of the lab.
IMPORTANT NOTICE: This lab relies on Bluemix and services such as Blockchain and Node JS. It may not work exactly as documented when Bluemix and/or the underlying services are updated. Please contact us if you experience problems with the lab. The lab documents were last updated on September 9th of 2016, and the Bluemix service functionality was last validated on December 5th of 2016.
1. Ensure that you have an account on IBM Bluemix. (If you already have an account, you can proceed to step 2 in this section).
1.1 Register for a Bluemix account, fill out the required details and click 'Create Account'.
You will receive a message to check your email.
1.2 Please check your email and look for a registration confirmation email from Bluemix.
1.3 Click on 'Confirm your account' and receive a 'Success' message.
1.4 Click 'Login' and login with your Bluemix credentials.
1.5 Create an Organization and enter any organization name.
1.6 Create a Space and enter a space name. You can also choose the default space name of 'dev'.
1.7 After you receive a success message, please click 'I'm Ready'
Click on 'Switch to Classic'.
You may be asked to login again. After login, you will land on the Bluemix Dashboard.
2. Ensure that you have the necessary space available in your Bluemix account to complete the lab. During the lab, you will be required to deploy 1 application and 2 services. Go to your Bluemix Dashboard to check if you have the required space:- The 'Services & APIs' tile shows the number of services you have available. You will require space to deploy two services during the lab. If you do not have sufficient space for two services, then delete some existing services (visible in your dashboard) before proceeding to the next step.
- The 'Cloud Foundry Apps' tile shows the memory you have available for apps. You will require at least 512 MB of free space to deploy an app during the lab. If you do not have 256MB of free space, then delete some existing apps (visible in your dashboard) before proceeding to the next step.
1. Click on the 'Deploy' button shown below (The button is located on this very webpage right below this bullet item - do NOT look for it within your bluemix account!).
2. Log in with your Bluemix account.
3. If you are asked to choose an alias, then follow these instructions. Otherwise, proceed to step 4 in this section.
3.1 Enter a unique alias name and click create.
3.2 Verify your alias name and click continue.
4. Leave the default app name that Bluemix chooses as is. You may modify the default Organization and Space if you would like the app deployed to a specific area of your Bluemix account. Otherwise, accept the default values and click 'DEPLOY'.
- The status of the deployment is shown. This can take approximately 3-5 minutes to complete.
- The deployment process performs the following actions:
- Creates a Node JS application
- Creates a blockchain service
5. After the deployment has completed, click on the 'Deployed to Bluemix sucessfully' link.
You will land on the Overview page of your application.
6. Click on the blockchain service tile.
You will land on the Overview page of the blockchain service, which should appear similar to the one shown below.
7. The application and services have been successfully deployed, and you are now ready to begin the lab!
Download the lab handout to begin the lab.
If you receive the error message shown below that the network is over capacity, then the service was not created. Please delete the blockchain service and the lab application, and repeat the deployment steps listed above until a blockchain service can be successfully created.
Deleting the service.
Deleting the application.
This sample code is licensed under Apache 2.0. Full license text is available in LICENSE.
Find more open source projects on the IBM Github Page.