The IBM
Spectrum Protect backup-archive client provides a web user
interface component, which can be started and managed independently of web browser software. After
you install and configure the web user interface on your workstation, you can use the web user
interface for file-restore operations. You can restore files on behalf of a user without accessing
the web user interface virtual machine. The web user interface supports only client-to-server
communications that use the Transport Layer Security (TLS) or Secure Sockets Layers (SSL)
protocols.
Before you begin
To determine which web browsers are supported, see the software requirements topic for your
operating system.
To run the web user interface from Mozilla Firefox browsers, the option for
Enable JavaScript must be enabled. This option is enabled by default.
Procedure
-
In the installation directory, locate the client options file, dsm.opt or
dsm.sys. For more information, see Client options file overview.
-
Add the HTTPPORT option to the client options file. For example, specify the
following value:
httpport 1581
- If you are changing the HTTPPORT value in the client options file,
ensure that the port number for your service is also updated. You can check the port number by using
the following command:
dsmcutil query CAD /name:your service name
You
can update the port number by using the following command:
dsmcutil update CAD /name:your service name /httpport:new HTTPPORT
- Run the
dsmc
command to verify your configuration.
- Run the
dsmc query session
command to validate that the TLS or SSL
protocol is used. Review the output to find the security information, which is similar to the
following example, SSL Information.........: TLSv1.2
TLS_RSA_WITH_AES_128_CBC_SHA
- Start the client acceptor by taking the appropriate actions for your operating
system:
- Enter the following IBM
Spectrum Protect server
commands to register an administrator to access the client data, and perform the file-restore
operations on behalf of the node:
reg admin admin ID password
grant auth admin ID cl=node auth=access node=your node
where
admin ID is the administrator's ID,
password is the
administrator's password, and
node is the node where file-restore operations are
performed.
-
If you registered a new node, and do not have backup data stored on the IBM
Spectrum Protect server for that node, perform a backup. This backup
provides you with test data that can be used for file-restore operations with the web user
interface. To back up the data, take one of the following actions:
- From the command prompt, run the
dsmc
command.
- In the IBM
Spectrum Protect backup-archive client GUI.
-
To start the File Restore user interface, in a supported web browser, enter the following
URL:
https://hostname:9081/bagui/
where
hostname specifies the address of the virtual machine that hosts the File Restore
user interface.
-
In the login window, enter the administrator ID and password (as specified in step 7), and
click Sign In.