Installation for Unix (Solaris/Linux):

Download the moshellxxx.zip file from Moshell Home to your home directory (e.g. /home/youruser) or to the temp
directory (/tmp).
Very important: do not store the zip file inside the moshell folder otherwise the installation will be corrupted.
Then go to the folder containing the zip file (cd /paht/to/folder) and run the following commands:
>> unzip -o moshellxxx.zip
>> bash moshell_install
The first prompt asks for the type of installation:
0) Full Version
1) Restricted+
2) Restricted
3) Limited
Click here for information about the restricted versions.
When prompted to enter the directory where you want to install moshell, it is recommended to specify your HOME
directory ( ~ ). If a previous moshell installation already exists, it is recommended to install in the same directory as the
old one. This way, all your custom files (jar/xml files, site files, etc.) get copied across to the new revision and the old
revision gets moved to a different location so you can still access it if needed.
When prompted to enter the path to java, make sure to use Oracle Java. Other Java distributions such as OpenSDK are not
supported by moshell.

Note: In the case of AMOS installation use option "-a", ie "bash moshell_install -a" (must be run as root on OSS
masterserver).
Note: for linux 64-bit, the 32-bit libc library is required, the package name is libc6-i386 or glibc.i686 or ia32-libs
(Other packages which may be needed for certain commands are python and expect.)

Running moshell for the first time:

If you have set the PATH variable correctly in your ~/.bashrc file, you should be able to run moshell from any directory.
E.g:
>> moshell ipaddress
If this is the first time moshell is installed in this location, then it will download a number of jar files from the node. No
progress indicator will be shown so just be patient as it will take a few minutes.
Progress can be seen by doing "ls -l" in the commonjars and jarxml directories.

If the Moshell execution fails on linux with the following error: "moshell/commonjars/lib/lin64/filefuncs.so: cannot restore
segment prot after reloc: Permission denied", then try to run the following commands, while logged in as root:
chcon -t texrel_shlib_t ./commonjars/lib/lin64/libz.so.1
chcon -t texrel_shlib_t ./commonjars/lib/lin64/filefuncs.so
If Moshell is unable to connect to the node on port 22, try executing the program moshell/commonjars/ssh manually. If it
fails with the following error: “moshell/commonjars/ssh: error while loading shared libraries: cannot restore segment prot
after reloc: Permission denied”, try running the following command, while logged in as root:
chcon -t texrel_shlib_t commonjars/ssh

For more information about user settings etc, check the user guide

Installation for Cygwin (Windows 7 or higher):

Go directly to step 10 if you have already installed and configured cygwin previously.
1- Download the file www.cygwin.com/setup-x86.exe and store it under "C:\users\youruser\cygwin_setup\" , then execute
it from that folder with the context menu "Run as administrator".
2- Choose "Install from internet", then click Next.
3- Root Directory "C:/cygwin" (It is not recommended to choose a different directory, especially if it contains spaces).
4- Choose a Download Site. For instance cygwin.mirror.constant.com is known to work well but probably others work fine
too.
5- In the "Select Packages" menu "View", choose "Category", then add the following packages:
- under "Archive", select "zip" and "unzip"
- under "Database", select "postgresql"
- under "Graphics", select "gnuplot"
- under "Libs", select "libglib2.0_0" and "libssp0"
- under "Net", select "curl", "inetutils", "openssh", "openssl"
- under "Perl", select "perl", "perl-XML-Simple", and "perl-IO-Tty"
- under "Python", select "python2" and "python3"
- under "Tcl", select "expect"
- under "Shells", select "rxvt"
6- Click Next. Install will start. Wait for installation to complete.
7- Download the file http://newtran01.au.ao.ericsson.se/moshell/cygwin_install.txt to C:/Cygwin .
8- Click on Start --> Run. In the "Run" window, type: cmd , then press "enter".
A DOS window opens. At the DOS prompt, execute the following commands:
c:
cd cygwin
bin\perl.exe cygwin_install.txt
This will create the following files: c:/cygwin/etc/profile, c:/cygwin/cygwin.bat, c:/cygwin/home/youruserid/.bashrc,
c:/cygwin/home/youruserid/.minttyrc, c:/cygwin/home/youruserid/.inputrc. If those files already exist, they are
automatically moved to the folder c:/cygwin/tmp/installbackup.
9- Open a cygwin terminal window by double-clicking on the cygwin icon in the start menu or on the file
c:/cygwin/cygwin.bat. The window should be black with white text and the prompt should like this: [~]$
If not, then go through all the steps again and make sure you haven't missed out anything.
10- Moshell installation:
- Download the moshellxxx.zip file from Moshell Home to c:/cygwin/home/youruser
- Open the cygwin shell and run the following commands:
>> unzip -o moshellxxx.zip
>> bash moshell_install
The first prompt asks for the type of installation:
0) Full Version
1) Restricted+
2) Restricted
3) Limited
Click here for information about the restricted versions.
When prompted to enter the directory where you want to install moshell, it is recommended to specify your HOME
directory ( ~ ). If you have executed moshell_install from your home directory then you can press the enter key and the
current directory is selected.
If a previous moshell installation already exists, it is recommended to install in the same directory as the old one. This
way, all your custom files (jar/xml files, site files, etc.) get copied across to the new revision and the old revision gets
moved to a different location so you can still access it if needed. When prompted to enter the path to java just type "java"
.
11- Running moshell for the first time:
If you have set the PATH variable correctly in your ~/.bashrc file, you should be able to run moshell from any directory.
E.g:
>> moshell ipaddress

For more information about user settings etc, check the user guide

For more info about cygwin installation/uninstallation issues, check http://cygwin.com/faq.html

Installation for WSL (Windows 10 or higher):

From Windows 10 it is possible to run Ubuntu or Debian directly on Windows, using the Windows Subsystem for Linux
(WSL).

1- Make sure you have Windows 10 64-bit build 16215 or higher.

To check the build, open "Run" (WindowsKey + R) and type "winver". If lower than 16215, upgrade your windows 10
version to latest.
2- Open PowerShell as administrator and execute the following command:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Then restart your computer when prompted.
3- Open the Microsoft Store and in the searchfield, enter "wsl" or "linux". Select a distribution (preferably Ubuntu, or
Debian), then from the distribution's page, select "Get".
4- Launch a new instance of the distribution that was installed. The first time, you will be prompted to define a username
and password.
Use for instance the Ericsson username and enter a password of your choice.
5- From the linux shell, execute the following commands:
sudo apt update && sudo apt upgrade (If any questions apear, you can just press "Enter")
sudo apt-get install unzip zip postgresql vim gnuplot libglib2.0-0 inetutils* openssh-server openssl python2.7 libxml-
simple-perl libio-pty-perl expect default-jre binutils
sudo dpkg-reconfigure tzdata (then select your timezone, eg "Europe" and "Stockholm")
6- Download moshellxx.zip from http://newtran01.au.ao.ericsson.se/moshell/ and store somewhere such as your
downloads folder C:/users/xxxx/downloads
Then copy the moshellxx.zip installation package to your WSL file system by doing the following command in the linux
shell:
cp /mnt/c/users/xxxx/downloads/moshellxx.zip ~/
Then run the moshell installation from the linux shell, eg:
unzip -o moshellxx.zip
bash moshell_install
0
~/
7- Update the linux PATH environment variable to be able to run moshell from anywhere:
echo 'export PATH="${PATH}:$HOME/moshell" ' >> ~/.bashrc
INFO: Unlike CYGWIN, WSL does not support handling files of the WSL file system from the Windows file explorer.
However it is possible to access files of the Windows file system from the WSL shell by putting "/mnt" in front of the path.
For instance , in order to copy a dcgm.zip from c:/users/myusername/downloads to the WSL home folder, do the following
command from a WSL shell:
mv /mnt/c/users/myusername/downloads/xxxx_dcgm.zip ~/