Main Content

prodserver.addon.isInstalled

Determine if MATLAB Production Server add-on is installed from server instance

    Description

    tf = prodserver.addon.isInstalled(name,host,port) returns logical 1 (true) if a MATLAB® Production Server™ add-on name is installed from a server instance whose address is specified by host and port, and returns logical 0 (false) otherwise.

    The server instance does not need to be active when you run this function.

    This function requires MATLAB Client for MATLAB Production Server.

    example

    tf = prodserver.addon.isInstalled(name,host,port,'TransportLayerSecurity',setsecurity) additionally specifies a URI scheme (HTTP or HTTPS) for the server address.

    example

    tf = prodserver.addon.isInstalled(name,endpoint) specifies a network address for the server instance.

    [tf,tls] = prodserver.addon.isInstalled(___) additionally returns the value of the TransportLayerSecurity property using any of the input arguments in the previous syntaxes.

    example

    Examples

    collapse all

    After you install the fractal add-on from a server running at IP address 10.2.2.5 and port 57140, check if the add-on is installed from the server.

    tf = prodserver.addon.isInstalled('fractal','10.2.2.5','57140')
    tf =
    
      logical
    
       1
    

    The output indicates that the fractal add-on is installed from the server specified by IP address 10.2.2.5 and port number 57140.

    After you install the fractal add-on from a server using HTTPS and running at IP address 10.2.2.5 and port 57140, check if the add-on is installed from the server.

    tf = prodserver.addon.isInstalled('fractal','10.2.2.5','57142','TransportLayerSecurity',true)
    tf =
    
      logical
    
       1
    

    The output indicates that the fractal add-on is installed from the server specified by IP address 10.2.2.5 and port number 57142.

    After you install the fractal add-on from a server running at IP address 10.2.2.5 and port 57140, check if the add-on is installed from the server. Additionally, check if the server uses HTTPS.

    [tf,tls] = prodserver.addon.isInstalled('fractal','http://10.2.2.5:57140')
    tf =
    
      logical
    
       1
    
    
    tls =
    
      logical
    
       0

    The output indicates that the fractal add-on is installed from the specified server and the scheme is HTTP.

    Input Arguments

    collapse all

    Name of the MATLAB Production Server add-on, specified as a character vector or string scalar.

    Example: 'fractal'

    Data Types: char | string

    Host name of the server hosting a deployable archive from which you can install add-ons, specified as a character vector or string scalar.

    Example: '144.213.5.7'

    Data Types: char | string

    Port number of the server hosting a deployable archive from which you can install add-ons, specified as a positive scalar.

    Example: 9920

    Data Types: uint8 | uint16

    Network address of the server hosting a deployable archive from which you can install add-ons, specified as a character vector or string scalar. The network address has the format scheme://host_name_of_server:port_number.

    Example: 'https://144.213.5.7:9920'

    Data Types: char | string

    Flag that sets the URI scheme that the add-on uses when communicating with a server, specified as a logical scalar. If you do not set setsecurity or if you set setsecurity to false, the scheme is HTTP. If you set setsecurity to true, the scheme is HTTPS.

    Example: 'TransportLayerSecurity',true

    Data Types: logical

    Output Arguments

    collapse all

    Value that indicates whether the function is installed, returned as a logical scalar.

    Value of the TransportLayerSecurity property, returned as a logical scalar. If the value of TransportLayerSecurity is logical 1 (true), the client-server communication uses HTTPS; otherwise, it uses HTTP.

    Version History

    Introduced in R2019b