These instructions refer to Quickstart Image (QSI) for brevity but can also be followed if you are not using the QSI. We will be installing the SDK with acme airlines samples onto a machine with Tomcat, change the hosts file so that acmeairlines.com
, with Connections.
The steps to this are:
1. Get an Admin User ( you can skip this step if you already have one)
2. Install the SDK on a tomcat instance on your Connections machine
3. Enable the Acme Airlines Gadget on Connections
Get an Admin User
In order to a forward ActivityStream requests to an arbitrary stream, we will need a trusted or admin user. Here we will assign admin privileges to the user "Frank Adams".
Start the Connections Deployment Manager if it has not been started yet. Connect to the Connections machine via SSH, sudo /etc/init.d/ConServer_DM_was.init start
Navigate to https://HOSTNAME:9044/ibm/console/login.do?action=secure
Enter userId: wsadmin
Enter password: lcsecret
Expand Applications > Application Types
Click on Websphere Enterprise Applications
Select one of the applications (from the table)
Click on Homepage
Click on "Security role to user/group mapping"
Select one of the roles (Admin)
Click "Map Users..."
Enter search string - fadams
Click the right arrow
Repeat for each application and each role in the table.
Click System Administration on the left
Click on Nodes
The servers are now synchronized with your updates to the roles.
Click Servers > Server Types > Websphere Application Servers
Once you see the green arrow again the Connections server is fully restarted.
Navigate to https://HOSTNAME:444/homepage
Login as fadams with your password
There should now be a link to "Administration".
Install the SDK Tomcat on the QSI.
1. Copy the SDK onto your QSI and extract it, e.g. to the /opt folder, to end up with /opt/sbtsdk
2. Go to sbtsdk/tomcat and extract apache-tomcat-7.0.30-sbt.zip, so you have apache-tomcat-7.0.30
3. Change all .sh scripts in apache-tomcat-7.0.30/bin to be executable (right click > properties > permissions tab)
4. Copy the JavaMail (mail.jar) jar to apache-tomcat-7.0.30/lib. This is on the QSI but you may have to do a search and download it otherwise.
5. In apache-tomcat-7.0.30/conf, sbt.properties should have values for connections.app.as.user, and connections.app.as.password. This is for using the connections mail service and they default to admin and passw0rd. Users of the latest quickstart should use the user fadams and the password which corresponds to fadams password - eg passw0rd. This user needs administrator privileges in order to forward events to another user's stream.
6. Disable the firewall or add exceptions for ports 8080 and 8443. e.g. To disable: sudo /etc/init.d/iptables stop
7. In the hosts file on the QSI, add a mapping from acmeairlines.com to the ip of the machine with Connections installed.
(QSI IP) acmeairlines.com,
e.g. 9.333.33.333 acmeairlines.com
Do the same for the machine you will be accessing acmeairlines.com on.
8. Open a terminal and configure the JRE_HOME environment variable. It should point at the root directory of a jre , e.g. export JRE_HOME=/opt/IBMConnections/WebSphere/AppServer/java/jre. In the same terminal, cd to the bin directory of tomcat, e.g. /opt/sbtsdk/apache-tomcat-7.0.30/bin and run startup.sh to start tomcat.
You should now be able to visit http://acmeairlines.com:8080/acme.social.sample.webapp
, and booking a flight in the former will send an email using the admin account you have specified above in sbt.properties
. Use this same admin account next to register the acme airlines embedded experience gadget on Connections. This must be done or Connections won't run it.
Enable Acme Airlines Gadget
Optional Test: Visit the Connections Developer Bootstrap page and render the widget
You now have Acme Airlines set up. You can use the acme.social.sample.web
application to book flights and have them approved. For more details, see: Acme Airlines Application