Rackware RMM Getting Started for Oracle Marketplace 2.0

January 2020 

  1. Deploy RMM instance and attach block volume for data storage

    a. Deploy Rackware RMM from Oracle Marketplace

    b. Create 120gb block storage disk for RMM data storage

Screen Shot 2020-01-09 at 9.16.46 PM.png
Screen Shot 2020-01-09 at 9.16.58 PM.png

c. Attach block storage disk to RMM instance as paravirtual

i. Navigate to your compute instance

ii. Scroll down to Resources > Attached Block Volumes

iii. Click on Attached Block Volumes

iv. Click on the Attach Block Volume blue box

Screen Shot 2020-01-09 at 9.19.53 PM.png

v. Choose Paravirtualized and select an available path

Screen Shot 2020-01-09 at 9.21.00 PM.png

2. Configure RMM instance

a. Login through ssh to your RMM Instance

i. Connect with user opc and ssh key supplied when you deployed the instance.#

b. Verify path of your attached block storage data disk

ii. # sudo fdisk -l

Screen Shot 2020-01-09 at 9.24.18 PM.png

c. Run the RMM configuration script and enter configuration options
i. # sudo rwadm init
1. odify iptables rules for RMM operations (Y/N)  [Y]: Y
2. Download ISO for linux vcenter autoprovision (Y/N)  [N]: N
3. Do you want to continue with enabling the hub-role for the RMM (Y/N)  [N]: N
4. Do you want to add extra disk to RMM storage pool? (Y/N)  [N]: Y
5. [A]dd disk or [F]inished  [A]: A
6. Enter device name/path to be configured as RMM Storage pool. [ONE AT A TIME]: /dev/sdb
7. [A]dd disk or [F]inished  [A]: F
8. [A]dd, [R]emove interfaces for rmm to listen on, or [F]inished  [F]: A
9. Enter interface name, or 'all'  [all]: all
10. [A]dd, [R]emove interfaces for rmm to listen on, or [F]inished  [F]: F
11. This can be skipped in case of PS License type  [N]: N
12. [A]dd, [R]emove NAT IP, or [F]inished  [F]: F
13. Initialization Done.

d. Set your admin password for GUI access
i. # sudo passwd admin

3. Configure you OCI Security list for access to RMM appliance

a. Open TCP ports 22, 443 ingress to the RMM
b. From instance view click on the link to the subnet

Screen Shot 2020-01-09 at 9.37.27 PM.png

c. Click the link to the security list for your subnet

Screen Shot 2020-01-09 at 9.38.26 PM.png

d. Add a stateful Ingress rule from the IP or network where you will access the RMM
i. Click on Edit all rules

Screen Shot 2020-01-09 at 9.44.01 PM.png

ii. Add the ingress rules to your RMM from the host you will access it from

Screen Shot 2020-01-09 at 9.44.53 PM.png

4. Login to the RackWare RMM GUI
a. Open a Chrome or firefox browser 
i. https://<rmm_ip>
ii. Username: admin
iii. Password: <this password you created from step 2d>

Screen Shot 2020-01-09 at 9.48.31 PM.png

5. Prepare your Linux source hosts
a. TCP port 22 should be open in any firewalls between source and RMM
b. Login to your Rackware RMM through SSH
c. Create user "rackware" on Source linux hosts
i. # sudo useradd -m -s /bin/bash rackware
ii. # sudo passwd rackware
d. Login to RMM and copy sudoers file information to source 
i. rmm> #sudo cat /opt/rackware/docs/sudo-config.txt
e. Edit sudoer file on source host
i. source> #sudo visudo
ii. copy sudo-config.txt from RMM to bottom of sudoers file on source hosts
f. Copy RMM SSH key to source host
i. # sudo cat /root/.ssh/id_rsa.pub >> (target and user here)(authorized_keys_file)
ii. example from rmm
iii. # sudo cat /root/.ssh/id_rsa.pub >>rackware@<my_source_ip>
g. Test connectivity between your RMM and your linux source host
i. #s udo ssh rackware@<my_source_ip>
ii. you should connect without any password prompt.

6. Prepare your windows source hosts
a. TCP port 22 should be open in any firewalls between source and RMM
i. Open TCP 22 on the windows host. Enter netsh command in elevated powershell command (run as administrator).
1. netsh.exe advfirewall firewall add rule name=rw-tcp22-in dir=in  action=allow protocol=TCP localport=22
2.

Screen Shot 2020-01-09 at 9.56.48 PM.png

b. Download the Rackware SSH Client installer package to the source host.
i. https://<RMM_IP>/windows/RWSSHDService_x64.msi
ii.

Screen Shot 2020-01-09 at 10.05.20 PM.png

c. Run the installer package with administrator level privileges
i.

Screen Shot 2020-01-09 at 10.06.16 PM.png

ii. Accept the license agreement and click next
1.

Screen Shot 2020-01-09 at 10.07.13 PM.png

iii. Accept default installation folder and click next
1.

Screen Shot 2020-01-09 at 10.08.45 PM.png


iv. Remove the username and password entries
v. Copy and paste contents of your RMM’s public ssh key
1. RMM > # sudo cat ~/.ssh/id_rsa.pub
2. Copy the ssh key info 
3. Leave Username and Password fields blank. Remove any info if present
4. Then click next

Screen Shot 2020-01-09 at 10.10.39 PM.png

5. Click next again
a.

Screen Shot 2020-01-09 at 10.11.46 PM.png

b. Accept UAC
c.

Screen Shot 2020-01-09 at 10.13.04 PM.png

d. Click close
e.

Screen Shot 2020-01-09 at 10.13.51 PM.png

d. Test connectivity between Rackware RMM and your windows source
i. From RMM
ii. # ssh SYSTEM@<windows_ip>
[root@rackware-rmm ~]# ssh [email protected]
The authenticity of host 'x.x.x.x (x.x.x.x)' can't be established.
RSA key fingerprint is 01:aa:02:bb:03:cc:04:dd:05:00:00:00:00:00:00:00.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'x.x.x.x' (RSA) to the list of known hosts.

[system@rw-win-source ~]
rackware$

7. Create your Wave file for Migration using passthrough (no source data stored on rmm)
a. Login to the RMM GUI using Firefox or Chrome browser
b. User: admin
c. Password: (password you set earlier)

Screen Shot 2020-01-09 at 10.18.26 PM.png

d. Download the Wave template

Screen Shot 2020-01-09 at 10.19.08 PM.png

e. Save the .csv to your local workstation for editing
f.

Screen Shot 2020-01-09 at 10.19.43 PM.png

g. Edit the Wave file in Excel or an editor that can support tab delimited text file.
i. Remove all columns except the following:
1. Origin Name
2. Origin IP
3. Target Name
4. Origin Username
5. Target Username
6. OS
7. Image Name
8. Shape
9. ssh only
10. operation

ii. Add in the data for the columns
1. Origin Name: Name of your source host – freeform no spaces
2. Origin IP: Can be ip address or FQDN that can be resolved on RMM
3. Target Name: Name you want your target host in OCI
4. Origin Username:
a. Windows = system
b. Linx = your rackware user name you created earlier
5. Target Username:
a. Windows = system
b. Linux = (leave blank)
6. Clonename:  Name of your image to be stored in the rmm datastore
a. Leave blank unless you intend to keep a copy of your source host data on the rmm for Disaster Recovery purposes
7. OS:
a. windows
b. linux
8. Image Name: Only necessary for windows migrations
a. If windows name = exact name of your windows template
b. Example: rw-2012R2-template
c. Leave blank for linux
9. Shape: Specify an OCI shape
a. ple: VM.Standard2.1
10. ssh only
a. for windows = TRUE
b. for linux leave blank
11. operation:  host sync

Screen Shot 2020-01-09 at 10.29.46 PM.png

8. Upload Wave file to RMM
a. Login to the RMM GUI using Firefox or Chrome browser
i. User: admin
ii. Password: (password you set earlier after licensing RMM)
b. Click on the upload file icon and browse the local file system for your edited wave template.
c.

Screen Shot 2020-01-09 at 10.40.13 PM.png

d.

Screen Shot 2020-01-09 at 10.40.59 PM.png

e. The wave list will load and the detailed list of individual servers to be migrated will appear.
f.

Screen Shot 2020-01-09 at 10.42.07 PM.png

9. Gather your Oracle OCI account information.
a. Api url for your region, Examples:
i. https://iaas.us-ashburn-1.oraclecloud.com
ii. https://iaas.us-phoenix-1.oraclecloud.com
b. User ID
i. From your OCI console. Select Identity > Users
ii.

Screen Shot 2020-01-09 at 10.44.38 PM.png

iii. Copy the OCID for your user and paste it to a text file for now
c. Private Key File Path
i. Generate an API signing keys
1. Login to your RMM and elevate yourself to root level as described in license instructions earlier
2. #mkdir ~/.oci
3. # cd ~/.oci
4. # openssl genrsa -out ~/.oci/oci_api_key.pem 2048
5. # chmod go-rwx ~/.oci/oci_api_key.pem
6. # openssl rsa -pubout -in ~/.oci/oci_api_key.pem -out ~/.oci/oci_api_key_public.pem
7. Show the key values and copy to clipboard
8. cat ~/.oci/oci_api_key_public.pem
9. reference: https://docs.cloud.oracle.com/iaas/Content/API/Concepts/apisigningkey.htm
10. get path to your key and copy it to notepad 
a. # cd ~/.oci
b. # pwd
/root/.oci
c. Your private key path is: /root/.oci/oci_api_key.pem
d. Generate your OCI fingerprint
i. From your OCI console click on your user account as show above
ii. Select the link “Add Public Key”
iii.

Screen Shot 2020-01-09 at 10.52.51 PM.png

iv. Copy the contents of the pubic key that was generated in the previous steps into the Add Public key window
v.

Screen Shot 2020-01-09 at 10.53.46 PM.png

vi. Copy your fingerprint to notepad for input later
vii.


Screen Shot 2020-01-09 at 10.54.39 PM.png

e. Tenant ID
i. Gather the tenancy id and save for input later
ii.

Screen Shot 2020-01-09 at 10.56.07 PM.png

iii. Passphrase: if you created an rsa key with passphrase (not mandatory)
iv. Compartment Name – if other than the root compartment
v.

Screen Shot 2020-01-09 at 10.57.26 PM.png

vi.

Screen Shot 2020-01-09 at 10.58.26 PM.png

10. Add your OCI account information to the RMM Cloud Configuration
a. Login to your Rackware RMM Console
b. Expand the “Configuration” Tab on the left, select “Cloud” and click on the Add button
c.

Screen Shot 2020-01-09 at 11.38.15 PM.png

d. Change Cloud Provider to OCI
i.

Screen Shot 2020-01-09 at 11.39.12 PM.png

ii. Input the information into all the additional fields from the previous section
iii. Name can be any name you wish to give this configuration
iv.

Screen Shot 2020-01-09 at 11.40.52 PM.png

v. Click Add
vi.

Screen Shot 2020-01-09 at 11.41.44 PM.png

11. Attach your OCI account configuration to your Wave
a. Expand the Replication Option, click on waves and click on the blue link to your wave
b.

Screen Shot 2020-01-09 at 11.43.02 PM.png

c. Click on the blue “Not configured” link
d.

Screen Shot 2020-01-09 at 11.43.43 PM.png

e. Select your environment – the cloud user you set up in the previous step.
f. Enter the additional parameters
i. Datacenter
ii. AV Domain example (Availability Domain):
1. Nref:US-ASHBURN-AD-1
iii. Subnet Name
iv. VCN Name
g.

Screen Shot 2020-01-09 at 11.46.12 PM.png

h. Click Apply Changes
i.

Screen Shot 2020-01-09 at 11.47.05 PM.png

12. Start your Migrations
a. Set the parallel count to the number of migrations to run concurrently.
b. Press the play button
c.

Screen Shot 2020-01-09 at 11.48.25 PM.png

d. Status will change to running and the hosts will start their migration from source datacenter into the specified OCI environment.
e.

Screen Shot 2020-01-09 at 11.49.21 PM.png

f. Login to your OCI console to watch the new hosts being deployed.


RackWare Inc • Proprietary and Confidential • January 2020

>