154 lines
5.3 KiB
Plaintext
154 lines
5.3 KiB
Plaintext
Copyright © 2016-2017 Wind River Systems, Inc.
|
|
|
|
SPDX-License-Identifier: Apache-2.0
|
|
-----------------------------------------------------------------------
|
|
|
|
|
|
Titanium Cloud Remote CLI Clients
|
|
----------------------------------
|
|
|
|
To enable access to the Titanium Cloud CLI remotely, clients and
|
|
installer script have been packaged for install on a remote Linux distribution,
|
|
MAC OS X, Windows 7 and Windows 10.
|
|
This tarball includes several clients which can be used to issue CLI commands
|
|
to an existing Titanium Cloud. Openstack provides clients for Python 2.7.
|
|
Please ensure Python 2.7 is installed on your system and is the default
|
|
Python version before running the provided remote client install script.
|
|
|
|
|
|
Installing the Remote CLI Clients (system install) on a Linux machine
|
|
---------------------------------------------------------------------
|
|
|
|
To install the clients to the system packages on a Linux machine follow these
|
|
steps:
|
|
|
|
1. Untar the provided tarball:
|
|
tar xfv wrs-remote-clients-xxxVERSIONxxx.tgz
|
|
cd wrs-remote-clients-xxxVERSIONxxx
|
|
|
|
2. Execute the provided installer script:
|
|
sudo ./install_clients.sh
|
|
|
|
NOTE: please open a new terminal after installing for the installed bash
|
|
completion to take effect
|
|
|
|
|
|
Installing the Remote CLI Clients (system install) on Windows 7 machine
|
|
-----------------------------------------------------------------------
|
|
|
|
To install the clients to the system packages on a Windows 7 machine follow
|
|
these steps:
|
|
|
|
1. Install Cygwin as described in https://cygwin.com/install.html
|
|
|
|
2. Open a Cygwin Terminal
|
|
|
|
3. Save a copy of the setup*.exe under /usr/local/bin
|
|
|
|
4. Untar the provided tarball:
|
|
tar xfv wrs-remote-clients-xxxVERSIONxxx.tgz
|
|
cd wrs-remote-clients-xxxVERSIONxxx
|
|
|
|
5. Execute the provided installer script:
|
|
./install_clients.sh
|
|
|
|
NOTE: please open a new terminal after installing for the installed bash
|
|
completion to take effect
|
|
|
|
|
|
Installing the Remote CLI Clients (system install) on Windows 10 machine
|
|
------------------------------------------------------------------------
|
|
|
|
To install the clients to the system packages on a Windows 10 machine follow
|
|
these steps:
|
|
|
|
1. Enable Windows Subsystem for Linux as documented by Microsoft and install
|
|
the Ubuntu Linux distribution from Microsoft Store
|
|
|
|
2. Open Ubuntu Application
|
|
|
|
3. Untar the provided tarball:
|
|
tar xfv wrs-remote-clients-xxxVERSIONxxx.tgz
|
|
cd wrs-remote-clients-xxxVERSIONxxx
|
|
|
|
4. Execute the provided installer script:
|
|
sudo ./install_clients.sh
|
|
|
|
NOTE: please open a new terminal after installing for the installed bash
|
|
completion to take effect
|
|
|
|
|
|
Installing the Remote CLI Clients (system install) on MAC OS machine
|
|
--------------------------------------------------------------------
|
|
|
|
To install the clients to the system packages on a MAC OS machine follow
|
|
these steps:
|
|
|
|
1. Open a Terminal
|
|
|
|
2. Untar the provided tarball:
|
|
tar xfv wrs-remote-clients-xxxVERSIONxxx.tgz
|
|
cd wrs-remote-clients-xxxVERSIONxxx
|
|
|
|
3. Execute the provided installer script:
|
|
sudo ./install_clients.sh
|
|
|
|
NOTE: please open a new terminal after installing for the installed bash
|
|
completion to take effect
|
|
|
|
|
|
Installing the Remote CLI Clients (virtualenv)
|
|
----------------------------------------------
|
|
|
|
To install the clients within an isolated virtualenv follow these steps:
|
|
|
|
1. Create a virtualenv (if it does not already exist)
|
|
virtualenv MYENV
|
|
|
|
2. Activate the virtualenv
|
|
source MYENV/bin/activate
|
|
|
|
3. Untar the provided tarball:
|
|
tar xfv wrs-remote-clients-xxxVERSIONxxx.tgz
|
|
cd wrs-remote-clients-xxxVERSIONxxx
|
|
|
|
4. Execute the provided installer script:
|
|
./install_clients.sh
|
|
|
|
5. Remember to deactivate the virtualenv when you are finished using the
|
|
remote clients.
|
|
deactivate
|
|
|
|
6. Run /etc/bash_completion to update bash completion, if your system
|
|
supports it. You may need to do this when opening a new console as well.
|
|
|
|
Using the Remote CLI Clients
|
|
-----------------------------
|
|
|
|
1. Download the openrc file from Horizon.
|
|
Log in to horizon, go to:
|
|
Project -> API Access -> Download OpenStack RC File
|
|
|
|
2. On your console, source the file you have just downloaded. You will be
|
|
asked for your openstack password. You will also be asked for an optional
|
|
CA certificate. Enter the path to your CA certificate used for Titanium
|
|
Cloud if you have HTTPS configured. Press Enter if you are not using HTTPS
|
|
|
|
3 Run CLI commands in the same way you would run them on the Titanium
|
|
Cloud Controller
|
|
|
|
NOTE: The open-source OpenStack CLI Clients can NOT be installed at the same
|
|
time as the Titanium Cloud CLI Clients, however the Titanium Cloud CLI
|
|
Clients can be used to manage an open-source OpenStack cloud by sourcing
|
|
the appropriate openrc file for that cloud.
|
|
|
|
NOTE: The remote cli installer uses pip to install dependencies. The default pip
|
|
package that comes with Ubuntu 16.04 has issues. Please upgrade pip to
|
|
the 'latest' version before running the remote client installer if you
|
|
are installing remote clients on a Ubuntu 16.04 system.
|
|
pip install --upgrade pip
|
|
Failure to do so can result in installation issues. The Ubuntu pip
|
|
package issue is currently being tracked here
|
|
https://bugs.launchpad.net/ubuntu/+source/salt/+bug/1586381
|
|
|