Creating the Instance

 
Log into the IBM Cloud control panel at https://www-147.ibm.com/cloud/enterprise.

- Select control panel tab and then instances sub tab.
- Select "Add Instance" button [see CreateInstance01.jpg].
- You will see list of the available images (public or shared).
- Select the data center from the drop down box.
- Select the desired image, click "Next".



- Enter the "Request name" field on the first screen which is the name of your instance that you will see in the control panel's instances tab.



- You will need  to create a key if you don't have one yet [see CreateInstance03.jpg]. You can create the key just one time to connect with all your instances.

- After you created that key, you will need to save it [see CreateInstance04.jpg].

- Back on the step 2 dialog again, you need to fill out the following fields:
1. Data directory name (must start with "/" on Linux platforms)
2. Server id password
3. Password for administrator (default id "admin" you cannot change on the screen)
4. Organization name
5. Password for certifier

- On the subsequent screens you will be able to review [see CreateInstance07.jpg] the instance information on the summary screen, read the license agreement [see CreateInstance08.jpg] and submit your request for this instance creation.
    
- You will be able to return to your control panel after your request is submitted. In the instances tab you will see your instance going through the following steps (takes roughly 10 minutes):
- Requesting
- Provisoning [see CreateInstance11.jpg]
- Active [see CreateInstance12.jpg]

You can connect with your instance after it is in Active state.

Note: There might be some delay (not more than 5 minutes ) before you will be able to connect with your instance. If you try too soon you might get "Network Connection Error" message box.

Connecting via SSH with your Instance

 
You can connect with your instance using an SSH client, e.g. Putty (download putty.exe and puttygen.exe).

You will have to setup Putty to use key authorization, using your key that you created during instance creation. Connection to your instance using key is described in the user's guide (chapter: "Connecting to your Linux instance with Putty"). There is also a video describing the setup.

- Launch puttygen.exe [see ConfigurePutty01.jpg].
- Enter passphrase [see ConfigurePutty02.jpg].
- Save private key [see ConfigurePutty03.jpg].

- Launch putty.exe
- Enter the IP address (category: session) [see ConfigurePutty04.jpg].
- Enter "idcuser" (category: connection data) [see ConfigurePutty05.jpg].
- Check "Allow attempted changes of user name" and link private key (category: connection - SSH - Auth).



- Click "Open" and in the command prompt enter your passphrase [see ConfigurePutty07.jpg].

Connecting via VNC with your Instance

You can connect to your instance via VNC. This is useful e.g. if you want to download the certification id. The setup is described in the user's guide (chapter: "Preparing VNC server on Red Hat Enterprise Linux 5").

- Launch Putty (see above).

- Execute "sudo bash".



- Execute "/sbin/iptables -A INPUT -p tcp --dport 5900:5920 -j ACCEPT".

- Execute "/sbin/service iptables save".

- Execute "vncserver" and define the password.

- Execute "vncserver -kill :1".

- Execute "vi ~/.vnc/xstartup".

- Uncomment the following two lines:
unset SESSION_MANAGER
exec /etc/X11/xinit/xinitrc

- Type ":wq" and press enter.

- Download a VNC client, e.g. RealVNC, launch it and enter IP address and port "1" and password [see SetupVNC02.jpg].

- Use "your.instance.ip.address:1" to connect [see SetupVNC03.jpg].

Download Admin ID and Certification ID

After the instance is done provisioning you can download the admin id through webadmin.nsf. Open http://server_ip/webadmin.nsf and login using  'admin' as the username and the password specified during instance creation.

- Navigate to "People & Groups" tab then into "People" [see DownloadIDs01.jpg].

- Click on the notes user then download the UserId file [see DownloadIDs05.jpg].

Use the UserId file with either a Lotus Notes, Domino Designer, or Domino Admin client [see AccessServer01.jpg].

The certification id can be downloaded using the following steps.

- Login to VNC (see above) and open the admin's mailbox  http://server_ip/mail/admin.nsf?openDatabase [see DownloadIDs02.jpg].

- Open the notebook via icon and create a new document. Attach the cert.id as attachment. The cert id file is in the "file system/dominodata"directory [see DownloadIDs03.jpg].

- Open the same notebook application locally in a web browser and open the document. The cert id file can be detached from there [see DownloadIDs04.jpg].

Cross-certify your own User ID

- Open Domino Adminstrator, click on "Cross certify ..." under the "Configuration" tab. Choose server and define certification id. Then you can choose user ids you want to cross certify [see AccessServer02.jpg].

- Assign your own user adminstrator rights [see AccessServer03.jpg].

Notes:

1. You cannot cross-certify non-cloud user who has  the same domain name as Domino Cloud server.
2. You need to use a correct name (exact spelling) for user you are cross-certifying.

Setup Mail

To enable ingoing or or outgoing external mail in your new instance you need to open  corresponding SMTP ports:

To be able to send outgoing SMTP request from IPaddress:

/sbin/iptables -A OUTPUT -p tcp -s IPaddress --sport 1024:65535 -d 0/0 --dport 25 -m state --state NEW,ESTABLISHED -j ACCEPT

/sbin/iptables -A INPUT -p tcp -s 0/0 --sport 25 -d IPaddress --dport 1024:65535 -m state --state ESTABLISHED -j ACCEPT

To be able to get incoming SMTP request to IPaddress:

/sbin/iptables -A INPUT -p tcp -s 0/0 --sport 1024:65535 -d IP addres --dport 25 -m state --state NEW,ESTABLISHED -j ACCEPT

/sbin/iptables -A OUTPUT -p tcp -s IP address --sport 25 -d 0/0 --dport 1024:65535 -m state --state ESTABLISHED -j ACCEPT